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

# Get a single log entry

> Retrieves a single log entry by its ID.



## OpenAPI

````yaml /openapi/openapi.json get /api/logs/{id}
openapi: 3.1.0
info:
  title: Bifrost API
  description: >
    Bifrost HTTP Transport API for AI model inference and gateway management.


    This API provides a unified interface for interacting with multiple AI
    providers

    including OpenAI, Anthropic, Bedrock, Gemini, and more through a single API,

    along with comprehensive management APIs for configuring and monitoring the
    gateway.


    ## API Structure


    ### Unified Inference API (`/v1/*`)

    The primary API using Bifrost's unified format. Model parameters use the
    format

    `provider/model` (e.g., `openai/gpt-4`, `anthropic/claude-3-opus`).


    ### Async Inference API (`/v1/async/*`)

    Submit inference requests for asynchronous execution. Returns a job ID
    immediately

    and allows polling for results. Supports all inference types except batches,
    files,

    and containers.


    ### Provider Integration APIs

    Native provider-format APIs for drop-in compatibility:

    - `/openai/*` - OpenAI-compatible API

    - `/anthropic/*` - Anthropic-compatible API

    - `/genai/*` - Google GenAI (Gemini) compatible API

    - `/bedrock/*` - AWS Bedrock compatible API

    - `/cohere/*` - Cohere compatible API


    ### Framework Integration APIs

    Multi-provider proxy endpoints for AI frameworks:

    - `/litellm/*` - LiteLLM proxy with all provider formats

    - `/langchain/*` - LangChain compatible endpoints

    - `/pydanticai/*` - PydanticAI compatible endpoints


    ### Management APIs (`/api/*`)

    APIs for managing and monitoring the Bifrost gateway:

    - `/api/config` - Configuration management

    - `/api/providers` - Provider and API key management

    - `/api/plugins` - Plugin management

    - `/api/governance/*` - Virtual keys, teams, customers, budgets, rate
    limits, routing rules, and pricing overrides

    - `/api/logs` - Log search and analytics

    - `/api/mcp/*` - MCP (Model Context Protocol) client management

    - `/api/session/*` - Authentication and session management

    - `/api/cache/*` - Cache management

    - `/health` - Health check endpoint


    ## Fallbacks

    Requests can include fallback models that will be tried if the primary model
    fails.
  version: 1.0.0
  contact:
    name: Contact Us
    url: https://getmaxim.ai/bifrost
  license:
    name: Apache 2.0
    url: https://opensource.org/licenses/Apache-2.0
servers:
  - url: '{baseUrl}'
    description: Your Bifrost instance
    variables:
      baseUrl:
        default: http://localhost:8080
        description: Base URL of your Bifrost instance (e.g. https://bifrost.mycompany.com)
security:
  - BearerAuth: []
  - BasicAuth: []
  - ApiKeyAuth: []
tags:
  - name: Models
    description: Model listing and information
  - name: Chat Completions
    description: Chat-based text generation
  - name: Text Completions
    description: Text completion generation
  - name: Responses
    description: OpenAI Responses API compatible endpoints
  - name: OCR
    description: Optical character recognition for documents and images
  - name: Rerank
    description: Document reranking by relevance to a query
  - name: Embeddings
    description: Text embedding generation
  - name: Images
    description: Image generations, editing, and variations
  - name: Videos
    description: Video generation and management
  - name: Audio
    description: Speech synthesis and transcription
  - name: Count Tokens
    description: Token counting utilities
  - name: Batch
    description: Batch processing operations
  - name: Files
    description: File management operations
  - name: Containers
    description: Container management operations
  - name: Async Jobs
    description: Asynchronous job submission and retrieval endpoints
  - name: OpenAI Integration
    description: OpenAI-compatible API endpoints (/openai/*)
  - name: Azure Integration
    description: Azure OpenAI integration endpoints
  - name: Anthropic Integration
    description: Anthropic-compatible API endpoints (/anthropic/*)
  - name: GenAI Integration
    description: Google GenAI (Gemini) compatible API endpoints (/genai/*)
  - name: Bedrock Integration
    description: AWS Bedrock compatible API endpoints (/bedrock/*)
  - name: Cohere Integration
    description: Cohere compatible API endpoints (/cohere/*)
  - name: LiteLLM Integration
    description: LiteLLM proxy endpoints with multi-provider support (/litellm/*)
  - name: LangChain Integration
    description: LangChain compatible endpoints with multi-provider support (/langchain/*)
  - name: PydanticAI Integration
    description: >-
      PydanticAI compatible endpoints with multi-provider support
      (/pydanticai/*)
  - name: Health
    description: Health check endpoints
  - name: Configuration
    description: Configuration management endpoints
  - name: Session
    description: Session and authentication endpoints
  - name: Providers
    description: Provider management endpoints
  - name: Plugins
    description: Plugin management endpoints
  - name: MCP
    description: Model Context Protocol endpoints
  - name: Governance
    description: Virtual keys, teams, and customers management
  - name: Logging
    description: Log search and management endpoints
  - name: Cache
    description: Cache management endpoints
paths:
  /api/logs/{id}:
    get:
      tags:
        - Logging
      summary: Get a single log entry
      description: Retrieves a single log entry by its ID.
      operationId: getLogById
      parameters:
        - name: id
          in: path
          required: true
          description: Log entry ID
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LogEntry'
        '404':
          description: Log not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BifrostError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BifrostError'
components:
  schemas:
    LogEntry:
      type: object
      description: Log entry
      properties:
        id:
          type: string
        parent_request_id:
          type: string
        provider:
          type: string
        model:
          type: string
        status:
          type: string
          enum:
            - processing
            - success
            - error
        object:
          type: string
        timestamp:
          type: string
          format: date-time
        number_of_retries:
          type: integer
        fallback_index:
          type: integer
        latency:
          type: number
        cost:
          type: number
        selected_key_id:
          type: string
        selected_key_name:
          type: string
        virtual_key_id:
          type: string
        virtual_key_name:
          type: string
          nullable: true
        routing_engines_used:
          type: array
          items:
            type: string
          description: >-
            Array of routing engines used for this request (routing-rule,
            governance, or loadbalancing)
          nullable: true
        routing_rule_id:
          type: string
          nullable: true
        routing_rule_name:
          type: string
          nullable: true
        stream:
          type: boolean
        raw_request:
          type: string
        raw_response:
          type: string
        created_at:
          type: string
          format: date-time
        token_usage:
          $ref: '#/components/schemas/BifrostLLMUsage'
        error_details:
          $ref: '#/components/schemas/BifrostError'
        input_history:
          type: array
          items:
            $ref: '#/components/schemas/ChatMessage'
        responses_input_history:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
                enum:
                  - message
                  - file_search_call
                  - computer_call
                  - computer_call_output
                  - web_search_call
                  - web_fetch_call
                  - function_call
                  - function_call_output
                  - code_interpreter_call
                  - local_shell_call
                  - local_shell_call_output
                  - mcp_call
                  - custom_tool_call
                  - custom_tool_call_output
                  - image_generation_call
                  - mcp_list_tools
                  - mcp_approval_request
                  - mcp_approval_responses
                  - reasoning
                  - item_reference
                  - refusal
              status:
                type: string
                enum:
                  - in_progress
                  - completed
                  - incomplete
                  - interpreting
                  - failed
              role:
                type: string
                enum:
                  - assistant
                  - user
                  - system
                  - developer
              content:
                oneOf:
                  - type: string
                  - type: array
                    items:
                      type: object
                      required:
                        - type
                      properties:
                        type:
                          type: string
                          enum:
                            - input_text
                            - input_image
                            - input_file
                            - input_audio
                            - output_text
                            - refusal
                            - reasoning_text
                        file_id:
                          type: string
                        text:
                          type: string
                        signature:
                          type: string
                        image_url:
                          type: string
                        detail:
                          type: string
                        file_data:
                          type: string
                        file_url:
                          type: string
                        filename:
                          type: string
                        file_type:
                          type: string
                        input_audio:
                          type: object
                          required:
                            - format
                            - data
                          properties:
                            format:
                              type: string
                              enum:
                                - mp3
                                - wav
                            data:
                              type: string
                        annotations:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - file_citation
                                  - url_citation
                                  - container_file_citation
                                  - file_path
                              index:
                                type: integer
                              file_id:
                                type: string
                              text:
                                type: string
                              start_index:
                                type: integer
                              end_index:
                                type: integer
                              filename:
                                type: string
                              title:
                                type: string
                              url:
                                type: string
                              container_id:
                                type: string
                        logprobs:
                          type: array
                          items:
                            type: object
                            properties:
                              bytes:
                                type: array
                                items:
                                  type: integer
                              logprob:
                                type: number
                              token:
                                type: string
                              top_logprobs:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    bytes:
                                      type: array
                                      items:
                                        type: integer
                                    logprob:
                                      type: number
                                    token:
                                      type: string
                        refusal:
                          type: string
                        cache_control:
                          $ref: '#/components/schemas/CacheControl'
              call_id:
                type: string
              name:
                type: string
              arguments:
                type: string
              output:
                type: object
              action:
                type: object
              error:
                type: string
              queries:
                type: array
                items:
                  type: string
              results:
                type: array
                items:
                  type: object
              summary:
                type: array
                items:
                  type: object
                  required:
                    - type
                    - text
                  properties:
                    type:
                      type: string
                      enum:
                        - summary_text
                    text:
                      type: string
              encrypted_content:
                type: string
        output_message:
          $ref: '#/components/schemas/ChatMessage'
        responses_output:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
                enum:
                  - message
                  - file_search_call
                  - computer_call
                  - computer_call_output
                  - web_search_call
                  - web_fetch_call
                  - function_call
                  - function_call_output
                  - code_interpreter_call
                  - local_shell_call
                  - local_shell_call_output
                  - mcp_call
                  - custom_tool_call
                  - custom_tool_call_output
                  - image_generation_call
                  - mcp_list_tools
                  - mcp_approval_request
                  - mcp_approval_responses
                  - reasoning
                  - item_reference
                  - refusal
              status:
                type: string
                enum:
                  - in_progress
                  - completed
                  - incomplete
                  - interpreting
                  - failed
              role:
                type: string
                enum:
                  - assistant
                  - user
                  - system
                  - developer
              content:
                oneOf:
                  - type: string
                  - type: array
                    items:
                      type: object
                      required:
                        - type
                      properties:
                        type:
                          type: string
                          enum:
                            - input_text
                            - input_image
                            - input_file
                            - input_audio
                            - output_text
                            - refusal
                            - reasoning_text
                        file_id:
                          type: string
                        text:
                          type: string
                        signature:
                          type: string
                        image_url:
                          type: string
                        detail:
                          type: string
                        file_data:
                          type: string
                        file_url:
                          type: string
                        filename:
                          type: string
                        file_type:
                          type: string
                        input_audio:
                          type: object
                          required:
                            - format
                            - data
                          properties:
                            format:
                              type: string
                              enum:
                                - mp3
                                - wav
                            data:
                              type: string
                        annotations:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - file_citation
                                  - url_citation
                                  - container_file_citation
                                  - file_path
                              index:
                                type: integer
                              file_id:
                                type: string
                              text:
                                type: string
                              start_index:
                                type: integer
                              end_index:
                                type: integer
                              filename:
                                type: string
                              title:
                                type: string
                              url:
                                type: string
                              container_id:
                                type: string
                        logprobs:
                          type: array
                          items:
                            type: object
                            properties:
                              bytes:
                                type: array
                                items:
                                  type: integer
                              logprob:
                                type: number
                              token:
                                type: string
                              top_logprobs:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    bytes:
                                      type: array
                                      items:
                                        type: integer
                                    logprob:
                                      type: number
                                    token:
                                      type: string
                        refusal:
                          type: string
                        cache_control:
                          $ref: '#/components/schemas/CacheControl'
              call_id:
                type: string
              name:
                type: string
              arguments:
                type: string
              output:
                type: object
              action:
                type: object
              error:
                type: string
              queries:
                type: array
                items:
                  type: string
              results:
                type: array
                items:
                  type: object
              summary:
                type: array
                items:
                  type: object
                  required:
                    - type
                    - text
                  properties:
                    type:
                      type: string
                      enum:
                        - summary_text
                    text:
                      type: string
              encrypted_content:
                type: string
        embedding_output:
          type: array
          items:
            type: array
            items:
              type: number
        params:
          type: object
          additionalProperties: true
        tools:
          type: array
          items:
            type: object
            required:
              - type
            properties:
              type:
                type: string
                enum:
                  - function
                  - custom
              function:
                type: object
                required:
                  - name
                properties:
                  name:
                    type: string
                  description:
                    type: string
                  parameters:
                    type: object
                    properties:
                      type:
                        type: string
                      description:
                        type: string
                      required:
                        type: array
                        items:
                          type: string
                      properties:
                        type: object
                        additionalProperties: true
                      enum:
                        type: array
                        items:
                          type: string
                      additionalProperties:
                        type: boolean
                  strict:
                    type: boolean
              custom:
                type: object
                properties:
                  format:
                    type: object
                    required:
                      - type
                    properties:
                      type:
                        type: string
                      grammar:
                        type: object
                        required:
                          - definition
                          - syntax
                        properties:
                          definition:
                            type: string
                          syntax:
                            type: string
                            enum:
                              - lark
                              - regex
              cache_control:
                $ref: '#/components/schemas/CacheControl'
        tool_calls:
          type: array
          items:
            type: object
            required:
              - function
            properties:
              index:
                type: integer
              type:
                type: string
              id:
                type: string
              function:
                type: object
                properties:
                  name:
                    type: string
                  arguments:
                    type: string
        speech_input:
          type: object
          additionalProperties: true
        transcription_input:
          type: object
          additionalProperties: true
        image_generation_input:
          type: object
          additionalProperties: true
        speech_output:
          type: object
          additionalProperties: true
        transcription_output:
          type: object
          additionalProperties: true
        image_generation_output:
          type: object
          additionalProperties: true
        cache_debug:
          type: object
          additionalProperties: true
        metadata:
          type: object
          additionalProperties: true
          description: >-
            Custom metadata captured from request headers (configured via
            logging_headers or x-bf-lh-* prefix)
        selected_key:
          type: object
          additionalProperties: true
        virtual_key:
          type: object
          additionalProperties: true
        passthrough_request_body:
          type: string
          description: Raw passthrough request body (for passthrough integration routes)
        passthrough_response_body:
          type: string
          description: Raw passthrough response body (for passthrough integration routes)
        routing_engine_logs:
          type: object
          additionalProperties: true
          description: Detailed logs from the routing engine decision process
        is_large_payload_request:
          type: boolean
          description: Whether the request payload exceeded the large payload threshold
        is_large_payload_response:
          type: boolean
          description: Whether the response payload exceeded the large payload threshold
        rerank_output:
          type: object
          additionalProperties: true
          description: Rerank operation output
        video_generation_input:
          type: object
          additionalProperties: true
          description: Video generation request input
        video_generation_output:
          type: object
          additionalProperties: true
          description: Video generation response output
        video_retrieve_output:
          type: object
          additionalProperties: true
          description: Video retrieve response output
        video_list_output:
          type: object
          additionalProperties: true
          description: Video list response output
        video_delete_output:
          type: object
          additionalProperties: true
          description: Video delete response output
        video_download_output:
          type: object
          additionalProperties: true
          description: Video download response output
        list_models_output:
          type: object
          additionalProperties: true
          description: List models response output
    BifrostError:
      type: object
      description: Error response from Bifrost
      properties:
        event_id:
          type: string
        type:
          type: string
        is_bifrost_error:
          type: boolean
        status_code:
          type: integer
        error:
          $ref: '#/components/schemas/ErrorField'
        extra_fields:
          $ref: '#/components/schemas/BifrostErrorExtraFields'
    BifrostLLMUsage:
      type: object
      description: Token usage information
      properties:
        prompt_tokens:
          type: integer
          description: >
            Total input tokens including any prompt-cache tokens (read + write).
            Subtract prompt_tokens_details.cached_read_tokens and
            prompt_tokens_details.cached_write_tokens to get the non-cached
            portion.
        prompt_tokens_details:
          $ref: '#/components/schemas/ChatPromptTokensDetails'
        completion_tokens:
          type: integer
          description: Number of output/completion tokens generated.
        completion_tokens_details:
          $ref: '#/components/schemas/ChatCompletionTokensDetails'
        total_tokens:
          type: integer
        cost:
          $ref: '#/components/schemas/BifrostCost'
    ChatMessage:
      type: object
      required:
        - role
      properties:
        role:
          type: string
          enum:
            - assistant
            - user
            - system
            - tool
            - developer
        name:
          type: string
        content:
          oneOf:
            - type: string
            - type: array
              items:
                type: object
                required:
                  - type
                properties:
                  type:
                    type: string
                    enum:
                      - text
                      - image_url
                      - input_audio
                      - file
                      - refusal
                  text:
                    type: string
                  refusal:
                    type: string
                  image_url:
                    type: object
                    required:
                      - url
                    properties:
                      url:
                        type: string
                      detail:
                        type: string
                        enum:
                          - low
                          - high
                          - auto
                  input_audio:
                    type: object
                    required:
                      - data
                    properties:
                      data:
                        type: string
                      format:
                        type: string
                  file:
                    type: object
                    properties:
                      file_data:
                        type: string
                      file_id:
                        type: string
                      filename:
                        type: string
                      file_type:
                        type: string
                  cache_control:
                    $ref: '#/components/schemas/CacheControl'
          description: Message content - can be a string or array of content blocks
        tool_call_id:
          type: string
          description: For tool messages
        refusal:
          type: string
        audio:
          type: object
          properties:
            id:
              type: string
            data:
              type: string
            expires_at:
              type: integer
            transcript:
              type: string
        reasoning:
          type: string
        reasoning_details:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              index:
                type: integer
              type:
                type: string
                enum:
                  - reasoning.summary
                  - reasoning.encrypted
                  - reasoning.text
              summary:
                type: string
              text:
                type: string
              signature:
                type: string
              data:
                type: string
        annotations:
          type: array
          items:
            type: object
            properties:
              type:
                type: string
              url_citation:
                type: object
                properties:
                  start_index:
                    type: integer
                  end_index:
                    type: integer
                  title:
                    type: string
                  url:
                    type: string
                  sources:
                    type: object
                  type:
                    type: string
        tool_calls:
          type: array
          items:
            type: object
            required:
              - function
            properties:
              index:
                type: integer
              type:
                type: string
              id:
                type: string
              function:
                type: object
                properties:
                  name:
                    type: string
                  arguments:
                    type: string
    CacheControl:
      type: object
      description: Cache control settings for content blocks
      properties:
        type:
          type: string
          enum:
            - ephemeral
        ttl:
          type: string
          description: Time to live (e.g., "1m", "1h")
    ErrorField:
      type: object
      properties:
        type:
          type: string
        code:
          type: string
        message:
          type: string
        param:
          type: string
        event_id:
          type: string
    BifrostErrorExtraFields:
      type: object
      properties:
        provider:
          $ref: '#/components/schemas/ModelProvider'
        model_requested:
          type: string
        request_type:
          type: string
    ChatPromptTokensDetails:
      type: object
      properties:
        text_tokens:
          type: integer
        audio_tokens:
          type: integer
        image_tokens:
          type: integer
        cached_read_tokens:
          type: integer
          description: >
            Tokens served from the prompt cache (cache hit). These tokens are
            already included in prompt_tokens and are billed at the reduced
            cache-read rate. Populated for all providers that support prompt
            caching (Anthropic, Bedrock, OpenAI, Gemini, xAI, etc.).
        cached_write_tokens:
          type: integer
          description: >
            Tokens written to the prompt cache on this request (cache creation /
            write). These tokens are already included in prompt_tokens and are
            billed at the cache-creation rate. Populated for providers that
            separately report cache write tokens (Anthropic, Bedrock).
    ChatCompletionTokensDetails:
      type: object
      properties:
        text_tokens:
          type: integer
        accepted_prediction_tokens:
          type: integer
        audio_tokens:
          type: integer
        citation_tokens:
          type: integer
        num_search_queries:
          type: integer
        reasoning_tokens:
          type: integer
        image_tokens:
          type: integer
        rejected_prediction_tokens:
          type: integer
    BifrostCost:
      type: object
      description: Cost breakdown for the request
      properties:
        input_tokens_cost:
          type: number
        output_tokens_cost:
          type: number
        reasoning_tokens_cost:
          type: number
          description: Cost for reasoning/thinking tokens (reasoning models)
        citation_tokens_cost:
          type: number
          description: Cost for citation tokens
        search_queries_cost:
          type: number
          description: Cost for web search queries
        request_cost:
          type: number
        total_cost:
          type: number
    ModelProvider:
      type: string
      description: AI model provider identifier
      enum:
        - openai
        - azure
        - anthropic
        - bedrock
        - cohere
        - vertex
        - vllm
        - mistral
        - ollama
        - groq
        - sgl
        - parasail
        - perplexity
        - replicate
        - cerebras
        - gemini
        - openrouter
        - elevenlabs
        - huggingface
        - nebius
        - xai
        - runway
        - fireworks
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >
        Bearer token authentication. Use your provider API key or Bifrost
        authentication token.

        Virtual keys (prefixed with `sk-bf-`) can also be passed here.
    BasicAuth:
      type: http
      scheme: basic
      description: |
        Basic authentication using username and password.
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: |
        API key authentication via the `x-api-key` header.
        Virtual keys (prefixed with `sk-bf-`) can also be passed here.

````