List bookable services

GEThttps://api.nexgapp.com/v1/servicesLive

Returns the active services: airport and intercity transfers, couriers and venue bookings. Each has a stable code. A new kind of service is a new row here, not a new endpoint.

The list is public because a developer needs to know what can be booked before they have a key. Booking itself (POST /v1/orders) is coming soon.

Authentication: None needed. A key with public_read gets its own rate limit.
Rate limit cost: 1 token
Caching: Shared caches, 300 seconds
Available since: 21 October 2026

curl "https://api.nexgapp.com/v1/services" \
  -H "X-Api-Key: $NEXG_API_KEY"

Response · 200 OK

{
  "ok": true,
  "data": {
    "items": [
      {
        "code": "airport_transfer",
        "label": "Airport transfer",
        "kind": "ride",
        "unit_label": "passenger",
        "active": true
      },
      {
        "code": "courier",
        "label": "Courier",
        "kind": "courier",
        "unit_label": "parcel",
        "active": true
      },
      {
        "code": "intercity_transfer",
        "label": "Intercity transfer",
        "kind": "ride",
        "unit_label": "passenger",
        "active": true
      },
      {
        "code": "venue_booking",
        "label": "Venue booking",
        "kind": "booking",
        "unit_label": "booking",
        "active": true
      }
    ],
    "next_cursor": null
  },
  "meta": {
    "api_version": "v1",
    "limit": 100
  }
}

Headers

X-Api-Keyheader · stringOptional
Your API key. Or send it as Authorization: Bearer <key>, but never both in one request.

Response

Service data.items[]

codestring
The stable code you will send when booking, for example airport_transfer.
labelstring
What a person reads.
kindstring
ride, booking, courier or experience. It decides what a booking needs.
unit_labelstring
What one unit is called, for example passenger or parcel.
activeboolean
Always true: inactive services are not listed.

Errors

Every error has the same shape; see Errors. Branch on error.code and the HTTP status, never on the message.

400invalid_request
Both X-Api-Key and Authorization were sent, or Authorization is not a Bearer key.
401not_found
The key is unknown, revoked or expired, or its merchant cannot use the API right now. All of these get the same answer on purpose.
403not_found
A key was sent but it does not have public_read.
429rate_limited
Your token bucket is empty. Wait the number of seconds in the Retry-After header.
503internal_error
NexG could not check the key or the rate limit. Retry with backoff.
500internal_error
NexG could not read the services.