> ## Documentation Index > Fetch the complete documentation index at: https://docs.myrouter.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get generation metadata > Get customer-safe request/generation metadata without prompt or completion body content. ## OpenAPI ````yaml /openapi/v0-api/public.openapi.yaml get /api/v1/generation openapi: 3.1.0 info: title: MyRouter V0 Public API version: 0.1.0 description: >- Customer-facing MyRouter V0 API. Core paths follow OpenRouter where possible; billing is a MyRouter extension using Stripe-style resource naming. license: name: Proprietary identifier: LicenseRef-Proprietary x-platform-contract-commit: 56b047ef2c076be151e090aa4e2f5e974180ea14 x-phase-sources: - phase1/2026-05-28-source-inventory.md - phase8/2026-05-28-public-v0-api-review-matrix.md servers: - url: https://api.myrouter.example description: Placeholder until public environment is finalized. security: - bearerApiKey: [] paths: /api/v1/generation: get: tags: - Usage summary: Get generation metadata description: >- Get customer-safe request/generation metadata without prompt or completion body content. operationId: getGeneration parameters: - $ref: '#/components/parameters/RequestIdHeader' - name: id in: query required: true schema: type: string description: Generation/request id. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. responses: '200': description: Get generation metadata response. headers: x-request-id: $ref: '#/components/headers/RequestId' content: application/json: schema: $ref: '#/components/schemas/GenerationResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: parameters: RequestIdHeader: name: x-request-id in: header required: false schema: type: string description: Optional caller request id. x-source: Platform error contracts and product API convention x-owner: shared x-status: product-to-build x-platform-dependency: Platform runtime errors and product API errors x-rationale: Every API needs a stable supportable error envelope with request id. headers: RequestId: schema: type: string description: Effective request id. x-source: Platform error contracts and product API convention x-owner: shared x-status: product-to-build x-platform-dependency: Platform runtime errors and product API errors x-rationale: Every API needs a stable supportable error envelope with request id. schemas: GenerationResponse: type: object additionalProperties: false required: - data properties: data: type: object additionalProperties: false required: - id - created_at - endpoint - status properties: id: type: string description: Generation/request id. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. created_at: type: string description: Request timestamp. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. format: date-time endpoint: type: string description: Endpoint used. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. model: type: string description: Model used. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. api_key_hash: type: string description: Public key hash. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. status: type: string description: Final request status. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. latency_ms: type: integer description: Latency in milliseconds. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. minimum: 0 usage: $ref: '#/components/schemas/TokenUsage' description: Usage facts. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. charged_amount: type: string description: Customer charge. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. currency: type: string description: Charge currency. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. error: type: object description: Customer-safe error metadata. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. additionalProperties: true x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. request_id: type: string description: Request id. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. x-source: OpenRouter /generation plus June 4 Request Log Detail API x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform Request Log Detail API x-rationale: >- Generation metadata replaces public request-log naming and does not expose prompt or completion body content. TokenUsage: type: object additionalProperties: false required: [] properties: input_tokens: type: integer description: Input token count when available. x-source: >- OpenAI/Anthropic usage report pattern plus June 4 platform usage aggregation x-owner: shared x-status: june-4-dependent x-platform-dependency: >- Platform usage aggregation by API key/account with 5-minute granularity x-rationale: >- Usage reports expose physical meters only, not customer charge amounts. minimum: 0 output_tokens: type: integer description: Output token count when available. x-source: >- OpenAI/Anthropic usage report pattern plus June 4 platform usage aggregation x-owner: shared x-status: june-4-dependent x-platform-dependency: >- Platform usage aggregation by API key/account with 5-minute granularity x-rationale: >- Usage reports expose physical meters only, not customer charge amounts. minimum: 0 total_tokens: type: integer description: Total token count when available. x-source: >- OpenAI/Anthropic usage report pattern plus June 4 platform usage aggregation x-owner: shared x-status: june-4-dependent x-platform-dependency: >- Platform usage aggregation by API key/account with 5-minute granularity x-rationale: >- Usage reports expose physical meters only, not customer charge amounts. minimum: 0 cache_read_tokens: type: integer description: Cache-read token count when available. x-source: >- OpenAI/Anthropic usage report pattern plus June 4 platform usage aggregation x-owner: shared x-status: june-4-dependent x-platform-dependency: >- Platform usage aggregation by API key/account with 5-minute granularity x-rationale: >- Usage reports expose physical meters only, not customer charge amounts. minimum: 0 cache_write_tokens: type: integer description: Cache-write token count when available. x-source: >- OpenAI/Anthropic usage report pattern plus June 4 platform usage aggregation x-owner: shared x-status: june-4-dependent x-platform-dependency: >- Platform usage aggregation by API key/account with 5-minute granularity x-rationale: >- Usage reports expose physical meters only, not customer charge amounts. minimum: 0 reasoning_tokens: type: integer description: Reasoning token count when available. x-source: >- OpenAI/Anthropic usage report pattern plus June 4 platform usage aggregation x-owner: shared x-status: june-4-dependent x-platform-dependency: >- Platform usage aggregation by API key/account with 5-minute granularity x-rationale: >- Usage reports expose physical meters only, not customer charge amounts. minimum: 0 x-source: >- OpenAI/Anthropic usage report pattern plus June 4 platform usage aggregation x-owner: shared x-status: june-4-dependent x-platform-dependency: Platform usage aggregation by API key/account with 5-minute granularity x-rationale: Usage reports expose physical meters only, not customer charge amounts. ErrorEnvelope: type: object additionalProperties: false required: - error - request_id properties: error: type: object additionalProperties: false required: - code - message properties: code: type: string description: Stable machine-readable error code. x-source: Platform error contracts and product API convention x-owner: shared x-status: product-to-build x-platform-dependency: Platform runtime errors and product API errors x-rationale: >- Every API needs a stable supportable error envelope with request id. message: type: string description: Human-readable error message. x-source: Platform error contracts and product API convention x-owner: shared x-status: product-to-build x-platform-dependency: Platform runtime errors and product API errors x-rationale: >- Every API needs a stable supportable error envelope with request id. type: type: string description: Error category. x-source: Platform error contracts and product API convention x-owner: shared x-status: product-to-build x-platform-dependency: Platform runtime errors and product API errors x-rationale: >- Every API needs a stable supportable error envelope with request id. x-source: Platform error contracts and product API convention x-owner: shared x-status: product-to-build x-platform-dependency: Platform runtime errors and product API errors x-rationale: Every API needs a stable supportable error envelope with request id. request_id: type: string description: Effective request id for support. x-source: Platform error contracts and product API convention x-owner: shared x-status: product-to-build x-platform-dependency: Platform runtime errors and product API errors x-rationale: Every API needs a stable supportable error envelope with request id. x-source: Platform error contracts and product API convention x-owner: shared x-status: product-to-build x-platform-dependency: Platform runtime errors and product API errors x-rationale: Every API needs a stable supportable error envelope with request id. responses: BadRequest: description: Invalid request. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' Unauthorized: description: Missing or invalid authentication. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' Forbidden: description: Authenticated principal is not allowed. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' NotFound: description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' RateLimited: description: Rate limit exceeded. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' InternalError: description: Internal error. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' securitySchemes: bearerApiKey: type: http scheme: bearer bearerFormat: MyRouter API key ````