List Service Confirmations

GET /api/service-confirmations

Retrieve a paginated list of service confirmations. Supports filtering by organization, QR code, status, and date range.

Query Parameters

Parameter	Type	Required	Description
`organization_uuid`	string	No	UUID of the organization
`qr_code_uuid`	string	No	UUID of the QR code being scanned
`qr_code_tag_uuid`	string	No	UUID of the QR code tag, if applicable
`service_uuid`	string	No	UUID of the specific service
`status`	string	No	Filter by status: `CHECK_IN`, `CHECK_OUT`, `DELIVERY`
`location`	string	No	Location where the check-in is happening
`location_verified`	boolean	No	Whether the location was verified
`user_uuid`	string	No	UUID of the user performing the check-in/out
`from_date`	string	No	Start date for filtering (YYYY-MM-DD format)
`to_date`	string	No	End date for filtering (YYYY-MM-DD format)
`page`	integer	No	Page number (default: `1`)
`per_page`	integer	No	Items per page (default: `20`)
`order`	string	No	Sort direction: `asc` or `desc`
`order_by`	string	No	Field to sort by
`pagination`	boolean	No	Enable paginated response (default: `false`)

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

Error Codes

Status	Meaning
400	Bad Request
401	Unauthorized
500	Internal Server Error

Example Request

curl

curl -H "Authorization: Bearer your_api_key:your_api_secret" \
  "http://staging.didyougo.com.au/api/service-confirmations?organization_uuid=org-uuid&status=CHECK_IN&page=1&per_page=20"

Try It

Try it

Authorization Required

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

Query Parameters

API Response

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

Example Response

json

{
  "data": [
    {
      "uuid": "XYZ789UVW123RST456MNOP",
      "organization_uuid": "org-uuid",
      "qr_code_uuid": "ABC123DEF456GHI789JKLM",
      "qr_code_tag_uuid": null,
      "service_uuid": "svc-uuid",
      "status": "CHECK_IN",
      "location": "Main Entrance",
      "location_verified": true,
      "checked_in_at": "2025-01-15T10:30:00Z",
      "note": null,
      "user_uuid": "user-uuid",
      "created_on": "2025-01-15T10:30:00Z",
      "updated_on": "2025-01-15T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 1,
    "pages": 1
  }
}