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

# Get a call

> Returns one call. Segments are a separate resource: `GET /api/v1/realcall/streams/{id}/segments`.



## OpenAPI

````yaml /openapi/realcall.json get /api/v1/realcall/streams/{id}
openapi: 3.2.0
info:
  title: Reality Defender RealCall API
  version: 1.0.0
  description: >-
    The RealCall REST API provides programmatic access to real-time call
    analysis: streams, segments, test uploads, organization settings, API keys
    and webhooks.


    ## Getting started

    1. Create an API key in the Reality Defender web app under [API
    keys](https://app.realitydefender.ai/api-keys), or with `POST
    /api/v1/realcall/api-keys`. The plaintext key is shown only once, when it is
    created, so store it securely.

    2. Send the key in the `X-Api-Key` header on every request:


    ```bash

    curl -H "X-Api-Key: <your-key>" https://<host>/api/v1/realcall/settings

    ```


    ## Authentication

    Every request needs either an API key in the `X-Api-Key` header or a user
    access token in the `Authorization: Bearer <token>` header. An API key
    belongs to your organization and can call every RealCall operation;
    user-role restrictions apply only to bearer tokens. If a request sends both,
    the API key is used.


    ## Base path

    All endpoints are prefixed with `/api/v1/realcall/`.


    ## Conventions

    - `GET` — Retrieve one or more resources

    - `POST` — Create a new resource

    - `PUT` — Update an existing resource at a known identifier

    - `DELETE` — Permanently remove a resource


    ## Pagination

    List endpoints paginate by page: they accept `page` (zero-based, default 0)
    and `pageSize` (default 30, max 100), and return an `items` array alongside
    a `pagination` object with `currentPage`, `itemsPerPage` and `total`.


    ## Errors

    All error responses follow a consistent shape with `code`, `message`, and an
    optional `details` array.


    A `403` response has two meanings. With `code: org_not_enabled`, your
    organization does not have RealCall enabled; changing your user role does
    not fix it, so contact Reality Defender. A `403` without that code means
    your user role does not allow this operation. If both apply,
    `org_not_enabled` is returned. Neither is returned for requests made with an
    API key.
servers:
  - url: https://app.api.os.realitydefender.xyz
security:
  - BearerAuth: []
  - ApiKeyAuth: []
tags:
  - name: RealCall
    description: >-
      Real-time call analysis: streams, segments, test uploads, org settings,
      API keys and webhooks.
paths:
  /api/v1/realcall/streams/{id}:
    get:
      tags:
        - RealCall
      summary: Get a call
      description: >-
        Returns one call. Segments are a separate resource: `GET
        /api/v1/realcall/streams/{id}/segments`.
      operationId: getRealCallStream
      parameters:
        - name: id
          in: path
          required: true
          description: Identifier of the resource.
          schema:
            $ref: '#/components/schemas/Ksuid'
      responses:
        '200':
          description: The call.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallDetail'
          headers:
            Cache-Control:
              description: >-
                Always `no-store`: this response carries data that must not be
                cached.
              schema:
                type: string
                example: no-store
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
        default:
          $ref: '#/components/responses/DefaultError'
      security:
        - BearerAuth:
            - REAL_CALL_READ_ACCESS
        - ApiKeyAuth: []
components:
  schemas:
    Ksuid:
      type: string
      description: Globally unique ID built to be chronologically sortable by timestamp
      example: 2nYn7qqkM5678Ks99ykvmZAr7pz
    CallDetail:
      type: object
      description: >-
        A single call: every call-list field plus detail-only fields. Segments
        are returned by `GET /api/v1/realcall/streams/{id}/segments`.
      required:
        - streamId
        - createdAt
        - sipCallId
        - conclusion
        - reason
        - direction
        - callType
        - fileName
        - timeToConclusionMs
        - languages
        - probability
        - audioUrl
        - contentFilteringRuns
      properties:
        streamId:
          $ref: '#/components/schemas/Ksuid'
          description: Identifier of the stream.
        createdAt:
          type: string
          format: date-time
          description: When the call started.
          example: '2026-07-01T12:00:00Z'
        sipCallId:
          type: string
          description: SIP call identifier reported by the telephony integration.
          example: a1b2c3d4-5678
        conclusion:
          $ref: '#/components/schemas/Conclusion'
        reason:
          $ref: '#/components/schemas/InconclusiveReason'
        direction:
          $ref: '#/components/schemas/CallDirection'
        callType:
          $ref: '#/components/schemas/CallType'
        fileName:
          type: string
          nullable: true
          description: Original filename for uploaded audio; `null` for live calls.
          example: sample-call.wav
        timeToConclusionMs:
          type: integer
          nullable: true
          description: Milliseconds from call start to conclusion; `null` while processing.
          example: 8400
        languages:
          type: array
          description: Languages detected in the call.
          items:
            type: string
            example: en
        probability:
          type: number
          format: double
          nullable: true
          description: Model probability behind the conclusion; `null` while processing.
          example: 0.92
        audioUrl:
          type: string
          nullable: true
          description: Presigned playback URL for the full call audio.
          example: https://example.com/audio.wav
        contentFilteringRuns:
          type: array
          description: >-
            Content-filtering runs behind the call's result, oldest first. Lists
            only runs that reached a decision and recorded their segments. Empty
            when there are none, including for a call still in progress or
            without content filtering.
          items:
            $ref: '#/components/schemas/ContentFilteringRun'
    Conclusion:
      type: string
      description: Overall result of a call. `PROCESSING` means no result is available yet.
      enum:
        - AUTHENTIC
        - SUSPICIOUS
        - MANIPULATED
        - INCONCLUSIVE
        - NOT_EVALUATED
        - IGNORED
        - PROCESSING
      example: AUTHENTIC
    InconclusiveReason:
      type: string
      description: >-
        Structured reason for an inconclusive outcome. Treat this as a closed
        list; a call with no structured reason returns `null`.
      enum:
        - INSUFFICIENT_SPEECH
        - SILENCE
        - LOW_QUALITY_AUDIO
        - DIALTONE_OR_MUSIC
        - CROSS_TALK
        - UNSUPPORTED_LANGUAGE
        - RECOGNIZED_SYSTEM_VOICE
        - MIXED
        - INSUFFICIENT_EVIDENCE
        - OTHER
      example: INSUFFICIENT_SPEECH
      nullable: true
    CallDirection:
      type: string
      description: >-
        Direction of the call relative to the organization. `UNKNOWN` when the
        integration did not report one.
      enum:
        - INBOUND
        - OUTBOUND
        - UNKNOWN
      example: INBOUND
    CallType:
      type: string
      description: Type of call. `UPLOADED_AUDIO` is a call created from an uploaded file.
      enum:
        - UPLOADED_AUDIO
        - REAL_CALL
        - TEST_CALL
        - UNKNOWN
      example: UPLOADED_AUDIO
    ContentFilteringRun:
      type: object
      description: One content-filtering run of a call.
      required:
        - order
        - outcome
        - category
        - disposition
        - segmentIds
      properties:
        order:
          type: integer
          minimum: 1
          description: 1-based position among the listed runs, oldest first.
          example: 1
        outcome:
          $ref: '#/components/schemas/ContentFilteringOutcome'
        category:
          type: string
          nullable: true
          description: >-
            Category of the prerecorded machine response; `null` unless
            `outcome` is `PRERECORDED_MACHINE_RESPONSE`.
          example: voicemail_greeting
        disposition:
          $ref: '#/components/schemas/ContentFilteringDisposition'
        segmentIds:
          type: array
          description: >-
            Segments the run covered, matching `segmentId` in `GET
            /streams/{id}/segments`.
          items:
            $ref: '#/components/schemas/Ksuid'
    Error:
      type: object
      description: Standard error response returned for all 4xx and 5xx status codes.
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Machine-readable error code.
          example: VALIDATION_ERROR
        message:
          type: string
          description: Human-readable description of the error.
          example: The request body contains invalid fields.
        details:
          type: array
          nullable: true
          description: Optional list of field-level validation errors.
          items:
            type: object
            properties:
              field:
                type: string
                description: The field path that caused the error.
                example: email
              issue:
                type: string
                description: A description of the issue with this field.
                example: Must be a valid email address.
    ErrorWithDetails:
      allOf:
        - $ref: '#/components/schemas/Error'
        - properties:
            details:
              type: array
              nullable: true
              description: Optional list of field-level validation errors.
              items:
                type: object
                properties:
                  field:
                    type: string
                    description: The field path that caused the error.
                    example: email
                  issue:
                    type: string
                    description: A description of the issue with this field.
                    example: Must be a valid email address.
    ContentFilteringOutcome:
      type: string
      description: >-
        What a content-filtering run decided: whether the audio is a prerecorded
        machine response, such as a voicemail greeting.
      enum:
        - PRERECORDED_MACHINE_RESPONSE
        - NON_PRERECORDED_MACHINE_RESPONSE
      example: PRERECORDED_MACHINE_RESPONSE
    ContentFilteringDisposition:
      type: string
      description: >-
        `SKIPPED` when the call kept listening after the run; `FINAL` for the
        run that gave the call's final answer.
      enum:
        - SKIPPED
        - FINAL
      example: FINAL
  responses:
    Unauthorized:
      description: Unauthorized. No valid credential was provided.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Error'
              - properties:
                  code:
                    example: UNAUTHORIZED
                  message:
                    example: Invalid or missing token
    Forbidden:
      description: >-
        Forbidden. The authenticated user does not have permission to perform
        this action.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Error'
              - properties:
                  code:
                    example: FORBIDDEN
    NotFound:
      description: Not Found. No resource exists with the given identifier.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Error'
              - properties:
                  code:
                    example: NOT_FOUND
    InternalServerError:
      description: Internal Server Error. An unexpected error occurred on the server.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Error'
              - properties:
                  code:
                    example: INTERNAL_SERVER_ERROR
    DefaultError:
      description: An error response in the standard shape.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorWithDetails'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        JWT Bearer token. Obtain a token via your identity provider and pass it
        in the `Authorization: Bearer <token>` header.
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        Organization API key, sent in the `X-Api-Key` header. Create one in the
        web app under API keys. API-key requests are not subject to user-role
        restrictions.

````