Your First API Call

Prerequisites: You have a Bearer token from the Authentication step.

Step 1: List your locations (REST)

List the locations your credentials have access to. This gives you the locationUuid values you’ll use in almost every subsequent request.

curl https://gotab.io/api/loc \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response:

[
  {
    "locationUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "locationId": 42,
    "name": "Demo Rooftop Bar",
    "timezone": "America/New_York",
    "urlName": "demo-rooftop-bar"
  }
]

Save the locationUuid — you’ll use it in every location-scoped request.

Step 2: List your locations (GraphQL)

The same data is available via GraphQL. This is useful when you need nested location data in a single request.

Endpoint: POST https://gotab.io/api/graph

query {
  locationsList {
    name
    locationUuid
    locationId
    timezone
    urlName
  }
}

Send it as a JSON body:

curl -X POST https://gotab.io/api/graph \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "query { locationsList { name locationUuid locationId timezone urlName } }"}'

Caution

Don’t expose locationsList in a public-facing UI. It returns every location your credentials can access. For user-scoped lists, filter by userId using the Authorization Code flow.

Try this query (and others) interactively in the GraphQL Explorer →

Step 3: Fetch a menu for a location

Use the locationUuid from Step 1 to fetch available menus for that location:

curl "https://gotab.io/api/loc/a1b2c3d4-e5f6-7890-abcd-ef1234567890/menus" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Or via GraphQL:

query ($locationUuid: String!) {
  location(locationUuid: $locationUuid) {
    name
    menus {
      menuId
      name
      menuType
    }
  }
}

What’s next?

You now have the basics: credentials → token → locations → menu. From here you can explore the full API surface.

Where to go	What you’ll find
REST API Reference	Interactive docs for every endpoint — try requests in the browser
GraphQL Explorer	Schema browser and query editor
Guides	Walkthroughs for ordering, payments, accounting, loyalty, and more
Concepts	OAuth deep-dives, webhooks, pagination, and rate limits

---

Stay up to date