SimpleVoIP Call Recordings API

openapi: 3.2.0
info:
  title: Simplevoip Call Recordings API
  version: 1.6.0
  license:
    name: Proprietary
  description: 'Operations tagged Call Recordings across 2 of this provider''s published API definitions: simplevoip.json, simplevoip-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://public.simplevoip.us
tags:
- name: Call Recordings
  description: Retrieval of recorded call audio.
paths:
  /recording/{account_id}/{recording_id}:
    get:
      tags:
      - Call Recordings
      operationId: fetchCallRecording
      summary: Fetch Call Recording
      description: Streams the audio of a single recorded call. Recording IDs are delivered by the CDR notification webhook for calls that were recorded. Both the account and the recording must sit within your own account tree — a parent account may fetch recordings from any site beneath it.
      security:
      - bearerAuth: []
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
        description: Unique account ID of the site the call was recorded on. This is the site's own account ID, not your parent account ID.
      - name: recording_id
        in: path
        required: true
        schema:
          type: string
        description: Unique ID of the recording to fetch.
      responses:
        '200':
          description: The recording audio.
          content:
            audio/mpeg:
              schema:
                type: string
                format: binary
        '400':
          description: Missing `account_id` or `recording_id`. No JSON body is returned — only the HTTP status.
        '401':
          description: Missing/invalid bearer token, or the token isn't associated with a recognized user. No JSON body is returned — only the HTTP status.
        '404':
          description: No such recording, or `account_id` is outside your own account tree. One status covers both, so that a recording's existence is never revealed to an account that cannot access it. No JSON body is returned — only the HTTP status.
    servers:
    - url: https://public.simplevoip.us
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Send an `Authorization: Bearer <token>` header. As a fallback for accounts without a bearer token configured, requests from an IP address on the account''s SimpleVoIP-managed allowlist are also accepted — bearer token is the recommended method for new integrations.'
x-refined-from:
- simplevoip.json
- simplevoip-openapi.json