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

# Anruf abrufen

> Retrieves detailed information about a specific call by its ID, including call metadata, transcript, analysis, and the associated contact.



## OpenAPI

````yaml openapi.json GET /v1/get-call/{id}
openapi: 3.0.3
info:
  title: telli API
  version: 1.0.0
  description: API documentation for telli's V1 endpoints
servers:
  - url: https://api.telli.com
security:
  - apiKey: []
paths:
  /v1/get-call/{id}:
    get:
      summary: Get Call
      description: >-
        Retrieves detailed information about a specific call by its ID,
        including call metadata, transcript, analysis, and the associated
        contact.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The call ID
      responses:
        '200':
          description: Call retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  call:
                    type: object
                    properties:
                      call_id:
                        type: string
                        format: uuid
                        description: Unique identifier for the call
                      attempt:
                        type: number
                        description: Which attempt number this call is within its loop
                      from_number:
                        type: string
                        description: Caller phone number in E.164 format
                      to_number:
                        type: string
                        description: Callee phone number in E.164 format
                      direction:
                        type: string
                        description: 'Call direction: ''inbound'' or ''outbound'''
                      external_contact_id:
                        type: string
                        description: Your external identifier for the contact
                      contact_id:
                        type: string
                        format: uuid
                        description: telli contact ID
                      contact_details:
                        type: object
                        description: Custom variables associated with the contact
                        additionalProperties: true
                      agent_id:
                        type: string
                        format: uuid
                        description: ID of the agent that handled the call
                      triggered_at:
                        type: number
                        description: Unix timestamp (ms) when the call was triggered
                      triggered_at_iso:
                        type: string
                        description: ISO 8601 timestamp when the call was triggered
                      started_at:
                        type: number
                        description: Unix timestamp (ms) when the call was answered
                      started_at_iso:
                        type: string
                        description: ISO 8601 timestamp when the call was answered
                      ended_at:
                        type: number
                        description: Unix timestamp (ms) when the call ended
                      ended_at_iso:
                        type: string
                        description: ISO 8601 timestamp when the call ended
                      call_length_min:
                        type: number
                        description: Duration of the call in minutes (rounded up)
                      call_status:
                        type: string
                        description: Deprecated. Use state, status, and follow_up instead.
                        deprecated: true
                        enum:
                          - COMPLETED
                          - ANSWERED
                          - NOT_REACHED
                          - VOICEMAIL
                          - ERROR
                      transcript:
                        type: string
                        description: Plain text transcript of the call
                      transcriptObject:
                        type: array
                        description: Structured transcript as an array of messages
                        items:
                          oneOf:
                            - type: object
                              description: A spoken message from the user or agent
                              required:
                                - role
                                - content
                              properties:
                                role:
                                  type: string
                                  enum:
                                    - user
                                    - agent
                                  description: Who spoke this message
                                content:
                                  type: string
                                  description: The spoken text
                            - type: object
                              description: >-
                                A tool activity performed by the agent during
                                the call
                              required:
                                - role
                                - toolActivity
                              properties:
                                role:
                                  type: string
                                  enum:
                                    - agent
                                toolActivity:
                                  type: string
                                  description: Name of the tool that was invoked
                                toolParameters:
                                  type: object
                                  description: Parameters passed to the tool
                                  additionalProperties:
                                    type: string
                      call_analysis:
                        type: object
                        description: >-
                          AI-generated analysis of the call. Keys are analysis
                          field names configured on the agent.
                        additionalProperties:
                          type: object
                          properties:
                            value:
                              type: boolean
                              description: Whether the analysis criterion was met
                            details:
                              type: string
                              description: Additional details or explanation
                      call_outcome:
                        type: object
                        description: >-
                          Structured outcome data extracted from the call. Keys
                          are outcome field names configured on the agent.
                        additionalProperties:
                          type: object
                          properties:
                            value:
                              description: The extracted value
                            reason:
                              type: string
                              description: Explanation for the extracted value
                            fieldSchema:
                              type: object
                              description: Schema definition for this outcome field
                            error:
                              type: string
                              description: Error message if extraction failed
                      collected_data:
                        type: object
                        description: >-
                          Data collected from the contact during the call via
                          tasks (e.g. email, license plate). Keys are task
                          names.
                        additionalProperties:
                          type: object
                          properties:
                            status:
                              type: string
                              enum:
                                - in_progress
                                - confirmed
                                - declined
                                - error
                              description: Collection status for this data point
                            value:
                              type: string
                              description: The collected value
                      booked_slot_for:
                        type: string
                        description: >-
                          ISO 8601 timestamp of the booked appointment slot, if
                          any
                      recording_url:
                        type: string
                        description: >-
                          URL to the call recording (only available when both
                          parties have given consent)
                      ended_reason:
                        type: string
                        description: Why the call ended
                        enum:
                          - agent-ended-call
                          - agent-forwarded-call
                          - agent-busy
                          - agent-did-not-answer
                          - contact-busy
                          - contact-ended-call
                          - contact-did-not-answer
                          - phone-provider-closed-connection
                          - other
                      state:
                        type: string
                        description: Current call lifecycle state
                        enum:
                          - queued
                          - ringing
                          - in_progress
                          - processing
                          - ended
                      status:
                        type: string
                        nullable: true
                        description: >-
                          Normalized terminal connection status. Null while the
                          call is not terminal.
                        enum:
                          - connected
                          - not_connected
                          - voicemail
                          - failed
                      follow_up:
                        type: object
                        nullable: true
                        description: >-
                          Scheduled follow-up call information, if the agent
                          scheduled one.
                        required:
                          - type
                          - scheduled_at
                        properties:
                          type:
                            type: string
                            enum:
                              - agent_follow_up
                          scheduled_at:
                            type: string
                            format: date-time
                            description: When the follow-up call is scheduled
                  contact:
                    type: object
                    properties:
                      contact_id:
                        type: string
                        format: uuid
                      external_contact_id:
                        type: string
                        description: Your unique internal identifier for the contact
                      external_url:
                        type: string
                        description: External URL linking to the contact in your CRM
                      created_at:
                        type: string
                        description: ISO 8601 timestamp when the contact was created
                      gender:
                        type: string
                      first_name:
                        type: string
                      last_name:
                        type: string
                      phone_number:
                        type: string
                        description: Phone number in E.164 format
                      in_call_since:
                        type: string
                        description: >-
                          ISO 8601 timestamp if the contact is currently in a
                          call
                      reached_at:
                        type: string
                        description: ISO 8601 timestamp when the contact was last reached
                      contact_details:
                        type: object
                        description: Custom variables associated with the contact
                        additionalProperties: true
                      call_attempts:
                        type: number
                        description: Number of call attempts made to this contact
                      next_call_at:
                        type: string
                        description: ISO 8601 timestamp of the next scheduled call
                      email:
                        type: string
                      timezone:
                        type: string
                        description: IANA timezone identifier (e.g. Europe/Berlin)
                      salutation:
                        type: string
                        description: Formal title or greeting (e.g. 'Mr.', 'Ms.')
                      status:
                        type: string
                        description: Contact status
                        enum:
                          - new
                          - pending
                          - closed
                          - reached
        '400':
          description: Invalid request - id must be a valid UUID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Call not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      type: object
      properties:
        message:
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
      description: 'API key must be provided as: Bearer <api_key>'
      x-bearer-format: Bearer

````