> ## Documentation Index > Fetch the complete documentation index at: https://docs.auriko.ai/llms.txt > Use this file to discover all available pages before exploring further. # List provider account tiers > Lists the allowed account_tier values for a BYOK provider Returns each tier's display name and data policy. Public endpoint — no authentication required. Naturally idempotent. Account tier helps Auriko track provider rate limits, choose safer routing, and enforce your data-policy constraints. Auriko uses the tier you set rather than assuming a higher provider policy. Auriko derives the key's data policy from provider + tier. You don't submit a data policy directly. All parameters, request/response schemas, and examples are auto-generated from the [OpenAPI specification](/api-reference/overview). ## OpenAPI ````yaml GET /v1/byok/providers/{provider}/tiers openapi: 3.1.0 info: title: Auriko API version: 1.0.0 description: > Intelligent LLM routing API with OpenAI-compatible interface. ## Overview Auriko provides a unified API for accessing multiple LLM providers with intelligent routing based on cost, latency, throughput, and availability. ## OpenAI Compatibility The API is compatible with OpenAI's Chat Completions API. You can use any OpenAI SDK by changing the base URL and API key. ## Auriko Extensions Beyond OpenAI compatibility, Auriko adds: - **Multi-model routing**: Request multiple models with `gateway.models[]` array - **Routing options**: Control provider selection with `routing` object - **Provider extensions**: Pass provider-specific parameters with `extensions` object - **Routing metadata**: Get transparency into routing decisions via `routing_metadata` contact: name: Auriko Support url: https://auriko.ai license: name: Proprietary url: https://auriko.ai/terms servers: - url: https://api.auriko.ai description: Production security: - ApiKeyAuth: [] tags: - name: Chat description: Chat completion endpoints - name: Responses description: OpenAI Response API endpoints - name: Callable Models description: Model IDs available for authenticated inference requests - name: Model Catalog description: Public model and provider catalog endpoints - name: Workspaces description: Workspace management - name: Budgets description: Spend control and budget management - name: API Keys description: API key management - name: BYOK description: Bring-your-own-key provider key management - name: Billing description: Credit balance and billing - name: Account description: API key introspection - name: Messages description: Anthropic Messages API endpoints - name: Routing description: Workspace routing configuration - name: Usage description: Usage statistics and request lookup - name: Members description: Workspace member and invite management - name: Audit description: Workspace audit event log paths: /v1/byok/providers/{provider}/tiers: parameters: - name: provider in: path required: true schema: type: string description: Provider identifier (for example `openai`) get: tags: - BYOK summary: List provider account tiers description: | Returns the allowed `account_tier` values for a BYOK provider. Auriko derives each key's data policy from provider + tier — callers never submit a data policy directly. operationId: getByokProviderTiers responses: '200': description: Tier options for the provider headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' content: application/json: schema: $ref: '#/components/schemas/ByokProviderTiersResponse' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' security: [] components: headers: X-Request-ID: description: | Unique request identifier for debugging and support. Include this in support requests for fast resolution. schema: type: string example: req_abc123def456 X-Error-Type: description: | Same value as the `error.type` field in the response body, exposed as a header for programmatic routing without body parsing. schema: type: string enum: - invalid_request_error - rate_limit_error - api_error - authentication_error - not_found_error - permission_error example: invalid_request_error X-Error-Retryable: description: | Whether the client should retry this request. 'true' for api_error and rate_limit_error types; 'false' for all others. schema: type: string enum: - 'true' - 'false' example: 'false' schemas: ByokProviderTiersResponse: type: object required: - object - provider - data - count properties: object: type: string enum: - list provider: type: string data: type: array items: $ref: '#/components/schemas/ByokTierItem' count: type: integer ByokTierItem: type: object description: An account tier option for a BYOK provider. required: - tier - display_name - data_policy properties: tier: type: string description: Tier identifier accepted as `account_tier` display_name: type: string description: Human-readable tier name data_policy: type: string enum: - zdr - no_training - none description: Data policy Auriko derives for keys on this tier qualification: type: - string - 'null' description: How an account qualifies for this tier ErrorResponse: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorObject' ErrorObject: type: object description: OpenAI-compatible error format required: - message - type - param - code properties: message: type: string description: Human-readable error message type: type: string description: Error category per guide §4. enum: - invalid_request_error - authentication_error - permission_error - not_found_error - rate_limit_error - api_error param: type: - string - 'null' description: Parameter that caused the error (null if not applicable) code: type: string description: Canonical code per guide §5 and docs/reference/error_codes.json. enum: - invalid_api_key - expired_api_key - insufficient_permissions - feature_disabled - mfa_required - invalid_recovery_code - mfa_verification_failed - invalid_request - missing_required_parameter - invalid_parameter_value - payload_too_large - context_length_exceeded - content_filtered - idempotency_conflict - idempotency_replay_unavailable - field_immutable - operation_not_allowed - unknown_field - state_precondition_failed - duplicate_resource - method_not_allowed - tools_not_supported - json_mode_not_supported - structured_output_not_supported - tools_with_structured_output_not_supported - vision_not_supported - reasoning_not_supported - thinking_disable_not_supported - streaming_not_supported - non_streaming_not_supported - batch_only - tier_opt_in_required - tool_choice_required_not_supported - cost_constraint_exceeded - latency_constraint_exceeded - throughput_constraint_not_met - provider_not_in_allowlist - provider_blocked - required_params_not_supported - byok_keys_required - platform_keys_unavailable - unsupported_modalities - no_compatible_endpoint - no_responses_endpoint - response_api_only - hosted_tool_not_supported - model_not_found - resource_not_found - rate_limit_exceeded - budget_exhausted - insufficient_quota - no_provider_available - upstream_error - upstream_timeout - client_disconnected - model_unavailable - internal_error - service_unavailable doc_url: type: string description: Link to the canonical documentation page for this error code. provider: type: - string - 'null' description: >- Upstream provider that generated the error (e.g., "google_ai_studio", "openai"). Null for errors not attributable to an upstream provider (local validation, auth, internal config). suggestion: type: string description: >- Actionable fix hint for routing, capability, or model-not-found errors. Absent for other error types. responses: NotFound: description: Resource not found headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' X-Error-Type: $ref: '#/components/headers/X-Error-Type' X-Error-Retryable: $ref: '#/components/headers/X-Error-Retryable' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: message: The requested resource was not found. type: not_found_error param: null code: resource_not_found RateLimited: description: | Rate limit exceeded. Two sub-causes share this status: - `rate_limit_exceeded`: throughput-based rate limit. - `budget_exhausted`: account or project budget reached (self-service; not auto-retried by SDKs — requires adding credits or raising the limit). headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' X-Error-Type: $ref: '#/components/headers/X-Error-Type' X-Error-Retryable: $ref: '#/components/headers/X-Error-Retryable' Retry-After: description: >- Seconds until rate limit resets. Standard HTTP header for retry backoff. schema: type: integer example: 60 X-Rate-Limit-Source: description: >- Identifies whether the rate limit originated from an upstream provider or from Auriko's routing layer. schema: type: string enum: - provider - routing required: false example: provider X-RateLimit-Limit-Requests: description: Request limit per window (present on throughput-based rate limits) schema: type: integer required: false example: 60 X-RateLimit-Remaining-Requests: description: >- Remaining requests in window (present on throughput-based rate limits) schema: type: integer required: false example: 0 X-RateLimit-Reset-Requests: description: >- When limit resets (ISO 8601 format; present on throughput-based rate limits) schema: type: string format: date-time required: false example: '2026-06-15T12:01:00.000Z' X-Budget-Exceeded: description: Present on budget-exhaustion 429s. schema: type: string enum: - 'true' - 'false' required: false example: 'true' X-Budget-Exceeded-Period: description: Period of the exceeded budget (present on budget-exhaustion 429s). schema: type: string enum: - daily - weekly - monthly required: false example: monthly X-Budget-Exceeded-Scope: description: Scope of the exceeded budget (present on budget-exhaustion 429s). schema: type: string enum: - workspace - api_key - byok_provider required: false example: workspace content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: rate_limit_exceeded: summary: Throughput-based rate limit value: error: message: Rate limit exceeded. Retry after 60 seconds. type: rate_limit_error param: null code: rate_limit_exceeded budget_exhausted: summary: Account budget exhausted value: error: message: Account budget exhausted. Add credits to continue. type: rate_limit_error param: null code: budget_exhausted InternalError: description: Internal server error headers: X-Request-ID: $ref: '#/components/headers/X-Request-ID' X-Error-Type: $ref: '#/components/headers/X-Error-Type' X-Error-Retryable: $ref: '#/components/headers/X-Error-Retryable' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: message: >- An unexpected error occurred. Contact support with the request ID. type: api_error param: null code: internal_error securitySchemes: ApiKeyAuth: type: http scheme: bearer description: | API key authentication. Keys start with `ak_` prefix. Example: `Authorization: Bearer ak_live_xxxxxxxxxxxx` ````