Get QR Code Tag

GET /api/qrcode-tags/uuid/{uuid}

Retrieve a single QR code tag by its UUID. Returns the full tag object including service alert recipients and linked booklets.

Path Parameters

Parameter	Type	Required	Description
`uuid`	string	Yes	UUID of the QR code tag

Response Fields

Field	Type	Description
`uuid`	string	Tag UUID
`qr_code_uuid`	string	Parent QR code address UUID
`tag_display_name`	string	Display name for the client
`tag_name`	string	Internal name of the client
`tag_number`	string	Unique number assigned to the client
`type`	string	Tag type: `SITE` or `CLIENT`
`status`	string	Status: `ACTIVE` or `INACTIVE`
`deleted`	boolean	Soft-delete flag
`is_favourite`	boolean	Whether this client is a favourite
`created_on`	string	Creation timestamp
`updated_on`	string	Last update timestamp
`deleted_on`	string	Deletion timestamp (if deleted)

See Errors & Rate Limits for the common error contract used across the API.

Error Codes

Status	Meaning
401	Unauthorized
404	Not Found — tag does not exist
500	Internal Server Error

Example Request

curl

curl -H "Authorization: Bearer your_api_key:your_api_secret" \
  http://staging.didyougo.com.au/api/qrcode-tags/uuid/XYZ789UVW123RST456MNOP

Try It

Try it

Authorization Required

Requests are sent without cookies — you must provide a valid Bearer <api_key>:<api_secret> header.

API Response

Click the Send API Request button above and see the response here!

Example Response

json

{
  "uuid": "XYZ789UVW123RST456MNOP",
  "qr_code_uuid": "ABC123DEF456GHI789JKLM",
  "tag_display_name": "Main Entrance",
  "tag_name": "entrance-01",
  "tag_number": "TAG-001",
  "type": "SITE",
  "status": "ACTIVE",
  "deleted": false,
  "is_favourite": false,
  "created_on": "2025-01-15T10:30:00Z",
  "updated_on": "2025-01-15T10:30:00Z",
  "deleted_on": null
}