# listMarketingLinks

Source: <https://telegafirst.com/docs/api-op-listmarketinglinks>
Locale: ru
releaseGitSha: ea133cd4ad87fe549ef000b139be145be9bd1717
sourceContentDigest: 9efedc0a30f35de44b72d047a5d5486c7353958794795a9292bdb0704f216ae9
Version: 2

# listMarketingLinks

`GET /api/v1/tools/marketing/links`

listMarketingLinks

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

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 | \["marketing:read"] |

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

| Поле | Значение |
| - | - |
| Параметры | \[] |

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

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

## Ответы

| Поле | Значение |
| - | - |
| 200.content.application/json.schema | [MarketingLinkListResponse](https://telegafirst.com/docs/schema-889184bd604244a130d51433326a6c45495243bd69eb3e4773461498388d9f45) |
| 200.description | "Actual control-plane projection; QR signatures expire after 900 seconds" |
| 200.headers.X-Bot-Username.description | "Public active bot handle, when configured" |
| 200.headers.X-Bot-Username.schema | [200.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-Client-Slug.description | "Authenticated active tenant slug" |
| 200.headers.X-Client-Slug.schema | [200.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" |
| 200.headers.X-RateLimit-Limit.schema | [200.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 200.headers.X-RateLimit-Remaining.schema | [200.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" |
| 200.headers.X-RateLimit-Reset.schema | [200.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |

## Ошибки

| Поле | Значение |
| - | - |
| 401.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 401.description | "INVALID\_API\_KEY: absent, invalid, revoked or conflicting key headers; session JWT refused" |
| 401.headers.X-Bot-Username.description | "Public active bot handle, when configured" |
| 401.headers.X-Bot-Username.schema | [401.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 401.headers.X-Client-Slug.description | "Authenticated active tenant slug" |
| 401.headers.X-Client-Slug.schema | [401.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 401.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" |
| 401.headers.X-RateLimit-Limit.schema | [401.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 401.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 401.headers.X-RateLimit-Remaining.schema | [401.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 401.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" |
| 401.headers.X-RateLimit-Reset.schema | [401.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 403.description | "INSUFFICIENT\_SCOPE or resource/plan refusal" |
| 403.headers.X-Bot-Username.description | "Public active bot handle, when configured" |
| 403.headers.X-Bot-Username.schema | [403.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.headers.X-Client-Slug.description | "Authenticated active tenant slug" |
| 403.headers.X-Client-Slug.schema | [403.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" |
| 403.headers.X-RateLimit-Limit.schema | [403.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 403.headers.X-RateLimit-Remaining.schema | [403.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 403.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" |
| 403.headers.X-RateLimit-Reset.schema | [403.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 413.description | "PAYLOAD\_TOO\_LARGE or ITEM\_COUNT\_EXCEEDED" |
| 413.headers.X-Bot-Username.description | "Public active bot handle, when configured" |
| 413.headers.X-Bot-Username.schema | [413.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.headers.X-Client-Slug.description | "Authenticated active tenant slug" |
| 413.headers.X-Client-Slug.schema | [413.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" |
| 413.headers.X-RateLimit-Limit.schema | [413.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 413.headers.X-RateLimit-Remaining.schema | [413.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 413.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" |
| 413.headers.X-RateLimit-Reset.schema | [413.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 429.description | "RATE\_LIMIT\_EXCEEDED or RATE\_LIMIT\_UNAVAILABLE" |
| 429.headers.Retry-After.description | "Retry delay in seconds, when supplied by limiter" |
| 429.headers.Retry-After.schema | [429.headers.Retry-After.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-Bot-Username.description | "Public active bot handle, when configured" |
| 429.headers.X-Bot-Username.schema | [429.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-Client-Slug.description | "Authenticated active tenant slug" |
| 429.headers.X-Client-Slug.schema | [429.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" |
| 429.headers.X-RateLimit-Limit.schema | [429.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 429.headers.X-RateLimit-Remaining.schema | [429.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" |
| 429.headers.X-RateLimit-Reset.schema | [429.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 500.description | "INTERNAL\_ERROR without private implementation detail" |
| 500.headers.X-Bot-Username.description | "Public active bot handle, when configured" |
| 500.headers.X-Bot-Username.schema | [500.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.headers.X-Client-Slug.description | "Authenticated active tenant slug" |
| 500.headers.X-Client-Slug.schema | [500.headers.X-Client-Slug.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.headers.X-RateLimit-Limit.description | "Effective requests-per-minute budget" |
| 500.headers.X-RateLimit-Limit.schema | [500.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.headers.X-RateLimit-Remaining.description | "Remaining budget or unknown" |
| 500.headers.X-RateLimit-Remaining.schema | [500.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 500.headers.X-RateLimit-Reset.description | "Reset as Unix seconds" |
| 500.headers.X-RateLimit-Reset.schema | [500.headers.X-RateLimit-Reset.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |

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

| Поле | Значение |
| - | - |
| description | "Authenticate with X-Api-Key or Authorization: Bearer tgf\_\* (API-key transport; owner session JWT is refused). Every declared scope is required. Sequences resolve under the authenticated tenant; public QR links use an opaque UniversalLink code." |
| operationId | "listMarketingLinks" |
| tags | \["marketing"] |
| x-idempotency | null |
| x-pagination | null |