Queue API Quickstart

What you’ll accomplish

You will make authenticated server-to-server requests to the four implemented Queue endpoints.

Base URL

https://app.layarva.com/api/public/v1/queue

Prerequisites

Create a credential under Queue Unit → External API.
Grant only the required operation and service scopes.
Store the returned secret in a server-side secret manager.

List allowed services

curl -s "https://app.layarva.com/api/public/v1/queue/services" \
  -H "Authorization: Bearer $LAYARVA_QUEUE_API_KEY" \
  -H "Accept: application/json"

Cache the returned service and Location IDs. The ticket endpoint expects those exact scoped IDs.

Issue one ticket

curl -s -X POST "https://app.layarva.com/api/public/v1/queue/tickets" \
  -H "Authorization: Bearer $LAYARVA_QUEUE_API_KEY" \
  -H "X-Request-Timestamp: $(date -u +%Y-%m-%dT%H:%M:%SZ)" \
  -H "X-Request-Nonce: $(uuidgen)" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "locationId": "loc_example",
    "serviceId": "qlcategory_example",
    "externalReference": "APPT-2026-000481"
  }'

Keep the Idempotency Key for the logical customer request. Retrying with the same key and same payload returns the same ticket; using that key for a different payload returns a conflict.

Read ticket and live state

curl -s "https://app.layarva.com/api/public/v1/queue/tickets/qticket_example" \
  -H "Authorization: Bearer $LAYARVA_QUEUE_API_KEY"

curl -s "https://app.layarva.com/api/public/v1/queue/state" \
  -H "Authorization: Bearer $LAYARVA_QUEUE_API_KEY"

Edge-managed Queue Units

The Platform refuses ticket issuance with QUEUE_UNIT_EDGE_MANAGED while an Edge holds authority. The Cloud cannot mint a ticket that the branch Edge cannot learn about during its current authority lease.

Build with Layarva

Queue API Reference

Prayer Schedule API Reference

What you’ll accomplish

Base URL

Prerequisites

List allowed services

Issue one ticket

Read ticket and live state

Edge-managed Queue Units

​What you’ll accomplish

​Base URL

​Prerequisites

​List allowed services

​Issue one ticket

​Read ticket and live state

​Edge-managed Queue Units

​Related guides

What you’ll accomplish

Base URL

Prerequisites

List allowed services

Issue one ticket

Read ticket and live state

Edge-managed Queue Units

Related guides