List reservations

GET

/v1/reservations

curl --request GET \
  --url https://api.useservice.app/v1/reservations \
  --header 'Authorization: Bearer <token>'

• Production

Authorizations

• api_key

Parameters

Query Parameters

status

string

Filter by status

source

string

guest_id

string

Filter by guest public id (gst_…)

updated_since

string

ISO-8601; switches sort to (updated_at asc, id asc)

limit

integer

starting_after

string

ending_before

string

expand

string

Expand=guest inlines the full guest object

Responses

200

Reservations listed

Media type application/json

object

object

required

string

Allowed values: list

data

required

Array<object>

object

object

required

string

Allowed values: reservation

id

required

string

status

required

string

Allowed values: pending confirmed partially_seated seated late completed cancelled no_show

source

required

string

Allowed values: manual widget phone walk_in import

booking_channel

required

string

Allowed values: back_office website_widget phone walk_in google_reserve

party_size

required

integer

actual_party_size

integer

nullable

service_date

required

string format: date

starts_at

required

string format: date-time

ends_at

string format: date-time

nullable

guest_notes

string

nullable

internal_notes

string

nullable

guest

Any of:

string

string

object

object

object

required

string

Allowed values: guest

id

required

string

first_name

string

nullable

last_name

required

string

email

string

nullable

phone

string

nullable

notes

string

nullable

blacklisted

required

boolean

blacklist_reason

string

nullable

dietary_preferences

required

Array<string>

allergies

required

Array<string>

birthday

string format: date

nullable

anniversary

string format: date

nullable

vip

required

boolean

language

string

nullable

Allowed values: fr en de es it nl pt da sv no fi

source

required

string

Allowed values: manual widget import

marketing_email_consent

required

boolean

marketing_email_consent_at

string format: date-time

nullable

marketing_sms_consent

required

boolean

marketing_sms_consent_at

string format: date-time

nullable

visit_count

required

integer

no_show_count

required

integer

cancellation_count

required

integer

first_visit_at

string format: date-time

nullable

last_visit_at

string format: date-time

nullable

created_at

required

string format: date-time

updated_at

required

string format: date-time

tables

required

Array<object>

object

object

required

string

Allowed values: table

id

required

string

name

required

string

min_capacity

required

integer

nullable

max_capacity

required

integer

nullable

section

required

object

object

required

string

Allowed values: section

id

required

string

name

required

string

area_type

required

string

Allowed values: indoor outdoor terrace bar lounge private_room patio rooftop

created_at

required

string format: date-time

updated_at

required

string format: date-time

has_more

required

boolean

Example

{
  "object": "list",
  "data": [
    {
      "object": "reservation",
      "status": "pending",
      "source": "manual",
      "booking_channel": "back_office",
      "guest": {
        "object": "guest",
        "language": "fr",
        "source": "manual"
      },
      "tables": [
        {
          "object": "table",
          "section": {
            "object": "section",
            "area_type": "indoor"
          }
        }
      ]
    }
  ]
}

Headers

Service-Version

string

Dated API version applied to this response

400

Invalid request parameter

Media type application/json

object

error

required

object

type

required

string

Allowed values: invalid_request_error authentication_error rate_limit_error api_error

code

required

string

message

required

string

param

string

nullable

doc_url

string

nullable

Example

{
  "error": {
    "type": "invalid_request_error"
  }
}

401

Missing or invalid API key

Media type application/json

object

error

required

object

type

required

string

Allowed values: invalid_request_error authentication_error rate_limit_error api_error

code

required

string

message

required

string

param

string

nullable

doc_url

string

nullable

Example

{
  "error": {
    "type": "invalid_request_error"
  }
}

429

Rate limit exceeded

Media type application/json

object

error

required

object

type

required

string

Allowed values: invalid_request_error authentication_error rate_limit_error api_error

code

required

string

message

required

string

param

string

nullable

doc_url

string

nullable

Example

{
  "error": {
    "type": "invalid_request_error"
  }
}

Headers

RateLimit-Limit

integer

Requests permitted in the window

RateLimit-Remaining

integer

Requests remaining in the window

RateLimit-Reset

integer

Seconds until the bucket refills

Retry-After

integer

Seconds to wait before retrying