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

# Get call

> Get details of a specific call.



## OpenAPI

````yaml /api-reference/agents/agents.oas.yaml get /v1/agents/{agent_id}/calls/{call_id}
openapi: 3.0.3
info:
  title: SLNG Voice Agents API
  version: 1.0.0
  description: >
    Public API for managing Voice Agents, dispatching outbound calls, and
    creating web (non-telephony) sessions.


    Base URL: `https://api.agents.slng.ai`
  contact:
    name: SLNG Support
    email: support@slng.ai
servers:
  - url: https://api.agents.slng.ai
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Agents
    description: Voice agent CRUD.
  - name: Calls
    description: Call dispatch and status.
  - name: Sessions
    description: Web (non-telephony) sessions.
paths:
  /v1/agents/{agent_id}/calls/{call_id}:
    parameters:
      - $ref: '#/components/parameters/AgentIdPath'
      - $ref: '#/components/parameters/CallIdPath'
    get:
      tags:
        - Calls
      summary: Get call
      description: Get details of a specific call.
      operationId: getCall
      responses:
        '200':
          description: Call.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentCallDetailOut'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '422':
          $ref: '#/components/responses/ValidationError'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  parameters:
    AgentIdPath:
      name: agent_id
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/UUID'
      description: Voice agent ID.
    CallIdPath:
      name: call_id
      in: path
      required: true
      schema:
        $ref: '#/components/schemas/UUID'
      description: Call ID.
  schemas:
    AgentCallDetailOut:
      allOf:
        - $ref: '#/components/schemas/AgentCallListItemOut'
        - type: object
          additionalProperties: false
          properties:
            livekit_session_report:
              type: object
              nullable: true
              additionalProperties: true
              description: Internal runtime diagnostics; structure may change.
            call_events:
              type: array
              items:
                $ref: '#/components/schemas/CallEvent'
            tool_executions:
              type: array
              items:
                $ref: '#/components/schemas/AgentCallToolExecutionClientOut'
    UUID:
      type: string
      format: uuid
      example: 550e8400-e29b-41d4-a716-446655440000
    AgentCallListItemOut:
      type: object
      additionalProperties: false
      required:
        - id
        - agent_id
        - phone_number
        - call_direction
        - arguments
        - rendered_prompt
        - livekit_room_name
        - status
        - created_at
        - updated_at
      properties:
        id:
          $ref: '#/components/schemas/UUID'
        agent_id:
          $ref: '#/components/schemas/UUID'
        phone_number:
          type: string
        call_direction:
          type: string
        web_session_origin:
          type: string
          enum:
            - dashboard_test
            - api
          nullable: true
        arguments:
          type: object
          additionalProperties: true
        rendered_prompt:
          type: string
        livekit_room_name:
          type: string
          description: Internal runtime identifier.
        livekit_dispatch_id:
          type: string
          nullable: true
          description: Internal dispatch identifier.
        call_started_at:
          $ref: '#/components/schemas/NullableDateTime'
        call_ended_at:
          $ref: '#/components/schemas/NullableDateTime'
        call_duration_ms:
          type: integer
          nullable: true
        call_end_reason:
          type: string
          nullable: true
        finalized_at:
          $ref: '#/components/schemas/NullableDateTime'
        call_duration_source:
          type: string
          nullable: true
        status:
          type: string
        error_message:
          type: string
          nullable: true
        created_at:
          $ref: '#/components/schemas/DateTime'
        updated_at:
          $ref: '#/components/schemas/DateTime'
    CallEvent:
      type: object
      additionalProperties: false
      required:
        - v
        - created_at
        - event
        - level
      properties:
        v:
          type: integer
          minimum: 1
          default: 1
        created_at:
          type: number
          minimum: 0
        event:
          type: string
          minLength: 1
          maxLength: 200
        level:
          type: string
          enum:
            - debug
            - info
            - warning
            - error
          default: info
        component:
          type: string
          enum:
            - stt
            - llm
            - tts
          nullable: true
        from_model:
          type: string
          maxLength: 500
          nullable: true
        to_model:
          type: string
          maxLength: 500
          nullable: true
        reason:
          type: string
          enum:
            - hard_fail
            - timeout
          nullable: true
        timeout_s:
          type: number
          minimum: 0
          nullable: true
        error_type:
          type: string
          maxLength: 200
          nullable: true
        error_code:
          type: integer
          nullable: true
    AgentCallToolExecutionClientOut:
      type: object
      additionalProperties: false
      required:
        - tool_name
        - tool_kind
        - invocation_source
        - started_at
        - finished_at
        - duration_ms
        - outcome
      properties:
        tool_name:
          type: string
        tool_kind:
          $ref: '#/components/schemas/ToolExecutionKind'
        invocation_source:
          $ref: '#/components/schemas/ToolInvocationSource'
        trigger_event:
          type: string
          nullable: true
        started_at:
          $ref: '#/components/schemas/DateTime'
        finished_at:
          $ref: '#/components/schemas/DateTime'
        duration_ms:
          type: integer
        outcome:
          $ref: '#/components/schemas/ToolExecutionOutcome'
        http_status:
          type: integer
          nullable: true
        error_code:
          type: string
          nullable: true
        error_type:
          type: string
          nullable: true
    ErrorResponse:
      type: object
      additionalProperties: true
      description: >
        Error payloads can vary depending on where the error is raised (edge
        gateway vs backend).


        Common shapes include:

        - `{ "error": "message" }`

        - `{ "detail": "message" }`

        - `{ "detail": [ { "loc": [...], "msg": "...", "type": "..." } ] }`
        (validation)
      properties:
        error:
          type: string
        detail:
          oneOf:
            - type: string
            - type: array
              items:
                type: object
    NullableDateTime:
      type: string
      format: date-time
      nullable: true
      example: '2026-01-15T10:30:00Z'
    DateTime:
      type: string
      format: date-time
      example: '2026-01-15T10:30:00Z'
    ToolExecutionKind:
      type: string
      enum:
        - webhook
        - template
        - human_transfer
        - built_in
    ToolInvocationSource:
      type: string
      enum:
        - system
        - contextual
    ToolExecutionOutcome:
      type: string
      enum:
        - succeeded
        - failed
        - timed_out
        - skipped
        - cancelled
  responses:
    UnauthorizedError:
      description: Unauthorized.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            unauthorized:
              summary: Authentication failed
              value:
                detail: Authentication is required for this endpoint.
    ForbiddenError:
      description: Forbidden.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            forbidden:
              summary: Access denied
              value:
                detail: You do not have access to this resource.
    NotFoundError:
      description: Not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            not-found:
              summary: Resource not found
              value:
                detail: The requested resource was not found.
    ValidationError:
      description: Validation error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            validation-error:
              summary: Request validation failed
              value:
                detail:
                  - loc:
                      - body
                      - language
                    msg: Input should be a valid string
                    type: string_type
    InternalServerError:
      description: Internal server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            internal-server-error:
              summary: Unexpected application error
              value:
                detail: An unexpected internal error occurred.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key

````