> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aixy-gateway.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Routing Performance

> Aggregate retained usage evidence by route and recorded configuration version. Request outcomes are deduplicated across attempts; attributed cost sums all recorded attempts and exposes incomplete coverage. Personal/project view follows analytics permissions.



## OpenAPI

````yaml /openapi.json get /api/routing-models/{routing_model_id}/performance
openapi: 3.1.0
info:
  title: Aixy Gateway API
  version: 0.1.0
  description: >-
    Route requests to configured AI providers through OpenAI- and
    Anthropic-compatible APIs. Aixy applies project access, model policies,
    guardrails, routing, budgets, and usage attribution before forwarding
    inference traffic.
servers:
  - url: https://api.aixy-gateway.com
    description: Aixy production gateway
security: []
tags:
  - name: operations
    description: Check process liveness and traffic readiness.
  - name: authentication
    description: Authenticate trusted server-side clients.
  - name: organizations
    description: Manage the organization and its lifecycle.
  - name: projects
    description: Create projects and manage project membership.
  - name: users
    description: Manage organization users, roles, and invitations.
  - name: teams
    description: Manage teams and team membership.
  - name: api-keys
    description: Manage project-scoped gateway API keys.
  - name: provider-credentials
    description: Manage organization and project provider credentials.
  - name: provider-catalog
    description: Discover providers supported by the gateway.
  - name: provider-models
    description: Discover and control models exposed by configured providers.
  - name: routing
    description: Configure stable model aliases, routing strategies, and fallbacks.
  - name: guardrails
    description: Configure prompt and sensitive-data protection policies.
  - name: identity connections
    description: Configure tenant-scoped enterprise identity federation.
  - name: playground
    description: Exercise configured models through the gateway.
  - name: cost-control
    description: Inspect spend and enforce budgets across tenant scopes.
  - name: metrics
    description: Inspect usage, token, latency, and error metrics.
  - name: activity
    description: Diagnose individual model requests and manage opt-in content capture.
  - name: monitors
    description: Configure operational monitors and notification channels.
  - name: audit
    description: Query, verify, and export the organization audit log.
  - name: telemetry exports
    description: Export telemetry to organization-owned destinations.
  - name: billing
    description: Inspect and manage the organization subscription.
  - name: models
    description: List models available to a project-scoped gateway API key.
  - name: inference
    description: Run model inference through the Aixy data plane.
  - name: pricing
    description: Manage versioned pricing attribution rules.
  - name: system
    description: Discover gateway capabilities and providers.
  - name: MCP beta
    description: Mcp beta operations exposed by the gateway.
  - name: cost-optimization
    description: Cost optimization operations exposed by the gateway.
  - name: custom domains
    description: Custom domains operations exposed by the gateway.
  - name: data processing
    description: Data processing operations exposed by the gateway.
  - name: feature flags
    description: Feature flags operations exposed by the gateway.
  - name: privacy
    description: Privacy operations exposed by the gateway.
  - name: roles
    description: Roles operations exposed by the gateway.
paths:
  /api/routing-models/{routing_model_id}/performance:
    get:
      tags:
        - routing
      summary: Get Routing Performance
      description: >-
        Aggregate retained usage evidence by route and recorded configuration
        version. Request outcomes are deduplicated across attempts; attributed
        cost sums all recorded attempts and exposes incomplete coverage.
        Personal/project view follows analytics permissions.
      operationId: get_routing_performance
      parameters:
        - name: routing_model_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Routing Model Id
        - name: window
          in: query
          required: false
          schema:
            enum:
              - 1h
              - 24h
              - 5d
              - 7d
              - 30d
              - 90d
            type: string
            default: 24h
            title: Window
        - name: view
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                enum:
                  - personal
                  - project
              - type: 'null'
            title: View
        - name: version
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 1
                maxLength: 128
              - type: 'null'
            title: Version
        - name: project_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Project Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoutingPerformanceReportResponse'
        '400':
          description: The request is invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
        '401':
          description: Authentication is required or invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
        '402':
          description: The request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
        '403':
          description: The authenticated account cannot perform this operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
        '404':
          description: The requested resource does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
        '413':
          description: The request body exceeds the endpoint limit.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
        '422':
          description: The request is semantically invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
        '503':
          description: The control-plane capability is unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
        4XX:
          description: The request was rejected by validation or authorization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayErrorResponse'
      security:
        - BrowserSession: []
components:
  schemas:
    RoutingPerformanceReportResponse:
      properties:
        window:
          type: string
          title: Window
        version:
          anyOf:
            - type: string
            - type: 'null'
          title: Version
        total:
          $ref: '#/components/schemas/RoutingPerformanceResponse'
        versions:
          items:
            $ref: '#/components/schemas/RoutingVersionResponse'
          type: array
          title: Versions
        destinations:
          items:
            $ref: '#/components/schemas/RoutingDestinationResponse'
          type: array
          title: Destinations
        exclusions:
          items:
            $ref: '#/components/schemas/RoutingExclusionResponse'
          type: array
          title: Exclusions
        versions_truncated:
          type: boolean
          title: Versions Truncated
        destinations_truncated:
          type: boolean
          title: Destinations Truncated
        exclusions_truncated:
          type: boolean
          title: Exclusions Truncated
        ungrouped_events:
          type: integer
          title: Ungrouped Events
        ungrouped_attributed_cost_usd:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Ungrouped Attributed Cost Usd
      type: object
      required:
        - window
        - version
        - total
        - versions
        - destinations
        - exclusions
        - versions_truncated
        - destinations_truncated
        - exclusions_truncated
        - ungrouped_events
        - ungrouped_attributed_cost_usd
      title: RoutingPerformanceReportResponse
    GatewayErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/GatewayErrorDetail'
      type: object
      required:
        - error
      title: GatewayErrorResponse
    RoutingPerformanceResponse:
      properties:
        requests:
          type: integer
          title: Requests
        completed_requests:
          type: integer
          title: Completed Requests
        failed_requests:
          type: integer
          title: Failed Requests
        completion_unverified_requests:
          type: integer
          title: Completion Unverified Requests
        fallback_requests:
          type: integer
          title: Fallback Requests
        recovered_requests:
          type: integer
          title: Recovered Requests
        provider_attempts:
          type: integer
          title: Provider Attempts
        no_provider_requests:
          type: integer
          title: No Provider Requests
        decision_recorded_requests:
          type: integer
          title: Decision Recorded Requests
        cost_recorded_requests:
          type: integer
          title: Cost Recorded Requests
        cost_complete_requests:
          type: integer
          title: Cost Complete Requests
        cost_partial_requests:
          type: integer
          title: Cost Partial Requests
        attributed_cost_usd:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Attributed Cost Usd
        attributed_cost_per_request_usd:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Attributed Cost Per Request Usd
        p50_duration_ms:
          anyOf:
            - type: number
            - type: 'null'
          title: P50 Duration Ms
        p95_duration_ms:
          anyOf:
            - type: number
            - type: 'null'
          title: P95 Duration Ms
        p50_ttft_ms:
          anyOf:
            - type: number
            - type: 'null'
          title: P50 Ttft Ms
        p95_ttft_ms:
          anyOf:
            - type: number
            - type: 'null'
          title: P95 Ttft Ms
        latency_samples:
          type: integer
          title: Latency Samples
        ttft_samples:
          type: integer
          title: Ttft Samples
      type: object
      required:
        - requests
        - completed_requests
        - failed_requests
        - completion_unverified_requests
        - fallback_requests
        - recovered_requests
        - provider_attempts
        - no_provider_requests
        - decision_recorded_requests
        - cost_recorded_requests
        - cost_complete_requests
        - cost_partial_requests
        - attributed_cost_usd
        - attributed_cost_per_request_usd
        - p50_duration_ms
        - p95_duration_ms
        - p50_ttft_ms
        - p95_ttft_ms
        - latency_samples
        - ttft_samples
      title: RoutingPerformanceResponse
    RoutingVersionResponse:
      properties:
        version:
          type: string
          title: Version
        performance:
          $ref: '#/components/schemas/RoutingPerformanceResponse'
      type: object
      required:
        - version
        - performance
      title: RoutingVersionResponse
    RoutingDestinationResponse:
      properties:
        provider:
          type: string
          title: Provider
        model:
          type: string
          title: Model
        attempts:
          type: integer
          title: Attempts
        final_requests:
          type: integer
          title: Final Requests
        failed_attempts:
          type: integer
          title: Failed Attempts
        cost_recorded_attempts:
          type: integer
          title: Cost Recorded Attempts
        attributed_cost_usd:
          anyOf:
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Attributed Cost Usd
      type: object
      required:
        - provider
        - model
        - attempts
        - final_requests
        - failed_attempts
        - cost_recorded_attempts
        - attributed_cost_usd
      title: RoutingDestinationResponse
    RoutingExclusionResponse:
      properties:
        provider:
          type: string
          title: Provider
        model:
          type: string
          title: Model
        connection_scope:
          type: string
          title: Connection Scope
        reason:
          type: string
          title: Reason
        requests:
          type: integer
          title: Requests
      type: object
      required:
        - provider
        - model
        - connection_scope
        - reason
        - requests
      title: RoutingExclusionResponse
    GatewayErrorDetail:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
      type: object
      required:
        - code
        - message
      title: GatewayErrorDetail
  securitySchemes:
    BrowserSession:
      type: apiKey
      description: Secure same-origin browser session cookie.
      in: cookie
      name: gateway_session

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.