# getUser

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

# getUser

`GET /api/v1/users/{seq_id}`

Read a tenant user and permitted relation projections

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

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 | \["pull:users"] |

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

| Поле | Значение |
| - | - |
| 0.in | "path" |
| 0.name | "seq\_id" |
| 0.required | true |
| 0.schema | [0.schema](https://telegafirst.com/docs/schema-1530eae3d9b69eb0d4bf2268a4cc47372fcec06f1cf1736785dd6f16848382fc) |
| 1.description | "orders,subscription (one level, comma-separated)" |
| 1.in | "query" |
| 1.name | "include" |
| 1.required | false |
| 1.schema | [1.schema](https://telegafirst.com/docs/schema-c7ca664de5f04fab107d068e385ad5df249b3100b15dad0717c58c99e8aa09d8) |

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

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

## Ответы

| Поле | Значение |
| - | - |
| 200.content.application/json.schema | [UserDetail](https://telegafirst.com/docs/schema-f618370803f4dff9c4f183f0e17c7fe489b3050fcd8bf1eca0555ad7fdb9b261) |
| 200.description | "User with optional tenant-scoped order/subscription projections" |
| 200.headers.X-Bot-Username.description | "Active bot public username, when API-key metadata contains it." |
| 200.headers.X-Bot-Username.schema | [200.headers.X-Bot-Username.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-Client-Slug.description | "Active tenant public slug, when API-key metadata contains it." |
| 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 rate budget; fallback 120 without a per-key or request decision." |
| 200.headers.X-RateLimit-Limit.schema | [200.headers.X-RateLimit-Limit.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-RateLimit-Remaining.description | "Nonnegative remaining count or unknown when no rate-limit decision is attached." |
| 200.headers.X-RateLimit-Remaining.schema | [200.headers.X-RateLimit-Remaining.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 200.headers.X-RateLimit-Reset.description | "Rate window reset as a Unix timestamp in seconds." |
| 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 | "Invalid positive-int4 address or include" |
| 400.x-error-codes | \["INVALID\_REQUEST"] |
| 401.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 401.description | "Missing or invalid API credential/JWT" |
| 401.x-error-codes | \["UNAUTHORIZED","INVALID\_API\_KEY","EXPIRED\_JWT","INVALID\_REFRESH\_TOKEN"] |
| 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 403.description | "Missing scope, paid plan window, unsupported publishable key or no active business" |
| 403.x-error-codes | \["INSUFFICIENT\_SCOPE","PLAN\_UPGRADE\_REQUIRED","PUBLISHABLE\_KEY\_NOT\_ALLOWED","NO\_ACTIVE\_BOT"] |
| 404.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 404.description | "User sequence was not found in the selected tenant" |
| 404.x-error-codes | \["NOT\_FOUND"] |
| 413.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 413.description | "Per-tool request size or item count cap exceeded" |
| 413.x-error-codes | \["PAYLOAD\_TOO\_LARGE","ITEM\_COUNT\_EXCEEDED"] |
| 429.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-c4113f3de00d728702a8663612e2074cbe3e8b3bb70d2b0dee6f3503fe89bd41) |
| 429.description | "Resource policy rate limit exceeded or subsystem unavailable" |
| 429.headers.Retry-After.description | "Retry delay in seconds when provided by the resource policy decision" |
| 429.headers.Retry-After.schema | [429.headers.Retry-After.schema](https://telegafirst.com/docs/schema-00404e686415370f1711c4d7acfa2905444d3cf23cef2e10c47d445ebe690f96) |
| 429.x-error-codes | \["RATE\_LIMIT\_EXCEEDED","RATE\_LIMIT\_UNAVAILABLE"] |

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

| Поле | Значение |
| - | - |
| description | "Resolves (client\_id, seq\_id), never a platform PK. ApiKeyOrJwtGuard accepts X-Api-Key, Bearer tgf\_\* or a verified surface JWT. ScopeGuard still requires pull:users: a scope-free surface JWT authenticates then fails 403. This does not assert owner OAuth/MCP parity. include accepts orders,subscription, comma-separated at one level; omitted includes are absent. No ETag conditional response or Idempotency-Key requirement." |
| operationId | "getUser" |
| summary | "Read a tenant user and permitted relation projections" |
| tags | \["users"] |