# listBookings

Source: <https://telegafirst.com/docs/api-op-listbookings>
Locale: ru
releaseGitSha: 0bb11ef116e17ec64c802d5476eaff442e53d252
sourceContentDigest: 78744cd29b6fc149e935aa8bcbe947df504cdf46b33c1cf91cac21cac5564320
Version: 3

# listBookings

`GET /api/v1/booking/bookings`

listBookings

## Авторизация и права

Scopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.

| Поле | Значение |
| - | - |
| security.0.hubApiKey | \[] |
| security.1.hubBearer | \[] |
| securitySchemes.hubApiKey.in | "header" |
| securitySchemes.hubApiKey.name | "X-Api-Key" |
| securitySchemes.hubApiKey.type | "apiKey" |
| securitySchemes.hubBearer.scheme | "bearer" |
| securitySchemes.hubBearer.type | "http" |
| x-required-scopes | \["booking:read"] |

## Параметры запроса

| Поле | Значение |
| - | - |
| 0.in | "query" |
| 0.name | "from" |
| 0.required | false |
| 0.schema | [0.schema](https://telegafirst.com/docs/schema-4f410cd74c87d8ddd21f20e835e06ed7445481c3aeae3c12085e82c54ea2fb7d) |
| 1.in | "query" |
| 1.name | "to" |
| 1.required | false |
| 1.schema | [1.schema](https://telegafirst.com/docs/schema-4f410cd74c87d8ddd21f20e835e06ed7445481c3aeae3c12085e82c54ea2fb7d) |
| 2.in | "query" |
| 2.name | "resource\_seq\_num" |
| 2.required | false |
| 2.schema | [2.schema](https://telegafirst.com/docs/schema-957862ee8ac02611c4b9b0014146301834c735bffb8ff32d10c381dea64ed87c) |
| 3.description | "Comma-separated, one or more of: pending, confirmed, completed, cancelled, no\_show." |
| 3.in | "query" |
| 3.name | "statuses" |
| 3.required | false |
| 3.schema | [3.schema](https://telegafirst.com/docs/schema-98c772e00ec89d4f8fa24bc0409faebdd4a044199fd90f932177aa81ec044b39) |
| 4.in | "query" |
| 4.name | "cursor" |
| 4.required | false |
| 4.schema | [4.schema](https://telegafirst.com/docs/schema-c109444b3a908d854a0e981341145d7b5d473520529f220f88d87af9d3d7628e) |
| 5.in | "query" |
| 5.name | "limit" |
| 5.required | false |
| 5.schema | [5.schema](https://telegafirst.com/docs/schema-23162b456d1acb4165ce4f53650cc1718624202d07be52b243c4637f13a5c36b) |

## Тело запроса

| Поле | Значение |
| - | - |
| Тело запроса | null |

## Ответы

| Поле | Значение |
| - | - |
| 200.content.application/json.schema | [BookingListPage](https://telegafirst.com/docs/schema-44cc9fa8fd6e4267566e7b4508d6b2ac9ce57b644f1fea5088ebefc759f0e1bd) |
| 200.description | "Tenant bookings, oldest booking number first" |
| 200.headers.X-Bot-Username.schema | [200.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-Client-Slug.schema | [200.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-RateLimit-Limit.schema | [200.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-RateLimit-Remaining.schema | [200.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-RateLimit-Reset.schema | [200.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |

## Ошибки

| Поле | Значение |
| - | - |
| 400.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 400.description | "Actual body/param/query pipe rejects the request, or global Idempotency-Key is absent" |
| 401.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 401.description | "Missing, invalid, expired or revoked authentication" |
| 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 403.description | "Required ALL scopes, plan or resource policy refused the caller" |
| 409.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 409.description | "Control-plane conflict, stale resource/schedule version, invalid schedule cursor or global request already processing" |
| 413.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 413.description | "Per-tool payload size or item count exceeded" |
| 422.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 422.description | "Generic global idempotency receipt was reused with a different request body" |
| 429.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 429.description | "Per-tool rate limit exceeded or unavailable" |
| 429.headers.Retry-After.description | "Resource guard retry delay when supplied by the limiter" |
| 429.headers.Retry-After.schema | [429.headers.Retry-After.schema](https://telegafirst.com/docs/schema-0d3ac1e9e006c0119b57d0512759bd7e261ea0d8cb38951a5183d17cdb4391f0) |
| 500.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 500.description | "Unexpected failure reaches the canonical Problem Details filter" |

## Дополнительные условия

| Поле | Значение |
| - | - |
| operationId | "listBookings" |
| tags | \["booking"] |
| x-idempotency | "none" |
| x-pagination.binding | \["client\_id","resource\_seq\_num","statuses","from","to"] |
| x-pagination.cursorPattern | "^\[1-9]\\\d\*$" |
| x-pagination.limitDefault | 50 |
| x-pagination.limitMaximum | 100 |
| x-pagination.limitMinimum | 1 |
| x-pagination.responseCursorField | "nextCursor" |