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

# Get a Call

> Returns the full record for a single call, including the AI summary, extracted data, and structured analysis. This is the same information delivered by post-call webhooks, retrievable on demand.



## OpenAPI

````yaml GET /v1/call/{id}
openapi: 3.1.0
info:
  title: OSVI AI API
  description: REST API for the OSVI AI voice and chat platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.osvi.ai
security:
  - ApiToken: []
paths:
  /v1/call/{id}:
    get:
      summary: Get a call
      description: >-
        Returns the full record for a single call, including the AI summary,
        extracted data, and structured analysis. This is the same information
        delivered by post-call webhooks, retrievable on demand.
      parameters:
        - name: id
          in: path
          required: true
          description: The call's `call_id` (UUID).
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The call record.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    $ref: '#/components/schemas/V1CallDetail'
        '401':
          description: Invalid or missing API token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '404':
          description: No call with that id exists on your account, or the id is malformed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorNotFound'
              example:
                success: false
                error: call_not_found
                details: null
components:
  schemas:
    V1CallDetail:
      allOf:
        - $ref: '#/components/schemas/V1CallSummary'
        - type: object
          properties:
            caller_name:
              type: string
              nullable: true
              example: Ravi Kumar
            retry_count:
              type: integer
              example: 0
            summary:
              type: string
              nullable: true
              description: >-
                AI-generated summary of the conversation (present when post-call
                analysis ran).
              example: The customer confirmed their appointment for Friday at 4 PM.
            data_captured:
              type: object
              additionalProperties: true
              description: >-
                Values for the fields defined on the agent's Data Extraction
                tab.
              example:
                email: ravi@example.com
                confirmed: true
            post_call_analysis:
              type: object
              additionalProperties: true
              description: >-
                Structured analysis output (sentiment, custom schema, callback
                detection, etc.).
              example:
                sentiment: positive
                callback_required: false
    ErrorUnauthorized:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
          example: Invalid API token
    ErrorNotFound:
      type: object
      properties:
        success:
          type: boolean
          example: false
        error:
          type: string
          example: agent_not_found
        details:
          type: object
          nullable: true
          example: null
    V1CallSummary:
      type: object
      properties:
        call_id:
          type: string
          format: uuid
          example: a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d
        agent_uuid:
          type: string
          example: agent_IsZ3Q6Sf_60Eh26XQMGbz-R_og
        agent_name:
          type: string
          example: Appointment Reminder
        phone_number:
          type: string
          description: >-
            The other party's number (the contact for outbound, the caller for
            inbound).
          example: '+919876543210'
        from_number:
          type: string
          nullable: true
          description: The number the call was placed from / received on.
          example: '+911140001234'
        status:
          type: string
          enum:
            - picked
            - not_picked
            - failed
            - busy
            - voicemail
            - in_progress
          example: picked
        call_type:
          type: string
          nullable: true
          enum:
            - inbound
            - outbound
            - null
          example: outbound
        duration_seconds:
          type: integer
          nullable: true
          description: Talk time in seconds, or `null` for calls that were never answered.
          example: 42
        call_ended_by:
          type: string
          nullable: true
          enum:
            - agent
            - user
            - null
          example: agent
        call_ended_reason:
          type: string
          nullable: true
          example: assistant-ended-call
        campaign_id:
          type: integer
          nullable: true
          example: 7
        campaign_upload_id:
          type: integer
          nullable: true
          example: 19
        tag:
          $ref: '#/components/schemas/V1Tag'
        created_at:
          type: string
          format: date-time
          example: '2026-06-12T09:30:00+05:30'
        call_picked_at:
          type: string
          format: date-time
          nullable: true
          example: '2026-06-12T09:30:04+05:30'
    V1Tag:
      type: object
      nullable: true
      description: >-
        The tag applied to the call by post-call analysis, or `null` if
        untagged.
      properties:
        id:
          type: integer
          example: 12
        name:
          type: string
          example: interested
        color_code:
          type: string
          example: '#22c55e'
  securitySchemes:
    ApiToken:
      type: apiKey
      in: header
      name: API-Token
      description: >-
        16-character API token associated with your OSVI account. Find it in
        your dashboard under Settings → API.

````