---
title: "List partner bookings"
method: GET
path: "/bookings"
---

# List partner bookings

`GET /bookings`

## Request

- Base URL: `https://api.tellandgo.com/api/v1/agent`
- URL: `https://api.tellandgo.com/api/v1/agent/bookings`
- Auth: API key in header `X-API-Key`

Returns paginated list of bookings created by this partner.

## Query parameters

- `status` 'pending_payment' | 'confirmed' | 'cancelled' | 'completed'
- `limit` integer
- `offset` integer

## Response `200`

Booking list

- BookingListResponse
  - `success` boolean
  - `bookings` Booking[] (unresolved $ref)
  - `pagination` Pagination
    - `total` integer: Count pageable AFTER all filters.
    - `limit` integer
    - `offset` integer
    - `has_more` boolean
    - `matched_before_filters` integer: Pre-filter match count, present when filters removed results.

## Other responses

- `401`: Authentication required or invalid

---

[API](https://skmtc.dev/tellandgo/apis/tell-go-travel-agent-api.md) · [All operations](https://skmtc.dev/tellandgo/apis/tell-go-travel-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tellandgo/apis/tell-go-travel-agent-api/revisions/3d84f816eb4f?raw)