> ## Documentation Index > Fetch the complete documentation index at: https://docs.revdesk.com/llms.txt > Use this file to discover all available pages before exploring further. # List calls > Returns recent calls for the authenticated organization, newest first. Every call reports has_recording, but the actual recording_url is only populated when the key also holds the recordings:read scope; without it the field is null. ## OpenAPI ````yaml /openapi.json get /v1/calls openapi: 3.1.0 info: title: RevDesk v1 API version: 1.0.0 description: >- Connect RevDesk calls, SMS, phone numbers, caller IDs, caller trust, agents, contacts, tasks, webhooks, and usage to the rest of your revenue workflow with organization-scoped permissions. contact: name: RevDesk email: support@revdesk.com servers: - url: https://api.revdesk.com security: - bearerAuth: [] tags: - name: Phone Numbers - name: Caller IDs - name: Enterprise Registration - name: Branded Calling - name: Calls - name: SMS - name: WebRTC - name: Reputation - name: Usage - name: Account - name: Agents - name: Appointments - name: Contacts - name: Documents - name: Notifications - name: Number Health - name: Number Registration - name: Optimize - name: Sandbox - name: Sub-entities - name: Tasks - name: Webhooks externalDocs: description: RevDesk API versioning and deprecation policy url: https://docs.revdesk.com/api-reference/versioning-and-deprecation paths: /v1/calls: get: tags: - Calls summary: List calls description: >- Returns recent calls for the authenticated organization, newest first. Every call reports has_recording, but the actual recording_url is only populated when the key also holds the recordings:read scope; without it the field is null. operationId: v1_calls_get parameters: - name: limit in: query required: false schema: type: number minimum: 1 maximum: 100 - name: cursor in: query required: false schema: type: string minLength: 1 - name: status in: query required: false schema: type: string - name: source in: query required: false schema: type: string enum: - spam_label_test responses: '200': description: Success headers: RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string status: type: string direction: type: string from_number: type: string to_number: type: string started_at: type: - string - 'null' ended_at: type: - string - 'null' duration_seconds: type: - number - 'null' phone_number_id: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' has_recording: type: boolean recording_url: type: - string - 'null' has_transcript: type: boolean source: type: - string - 'null' client_name: type: - string - 'null' client_label: type: - string - 'null' credential_type: type: - string - 'null' test_result: anyOf: - type: object properties: outcome: type: string enum: - BUSINESS_NAME - LOCATION - NUMBER_ONLY - SPAM - NO_CALL observed_label: type: string recorded_at: type: string callback_verified: type: boolean required: - outcome - observed_label - recorded_at - callback_verified additionalProperties: false - type: 'null' created_at: type: string user_id: type: - string - 'null' failure_code: type: - string - 'null' failure_category: type: - string - 'null' disconnection_reason: type: - string - 'null' network: anyOf: - type: object properties: capturedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ caller: type: object properties: kind: type: string enum: - browser - phone - agent - unknown ip: anyOf: - anyOf: - type: string format: ipv4 pattern: >- ^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$ - type: string format: ipv6 pattern: >- ^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:))$ - type: 'null' ipSource: type: string enum: - request - client_reported - unavailable - expired userId: type: - string - 'null' required: - kind - ip - ipSource - userId additionalProperties: false callee: type: object properties: kind: type: string enum: - browser - phone - agent - unknown ip: anyOf: - anyOf: - type: string format: ipv4 pattern: >- ^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$ - type: string format: ipv6 pattern: >- ^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:))$ - type: 'null' ipSource: type: string enum: - request - client_reported - unavailable - expired userId: type: - string - 'null' required: - kind - ip - ipSource - userId additionalProperties: false requester: anyOf: - type: object properties: ip: anyOf: - anyOf: - type: string format: ipv4 pattern: >- ^(?:(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])\.){3}(?:25[0-5]|2[0-4][0-9]|1[0-9][0-9]|[1-9][0-9]|[0-9])$ - type: string format: ipv6 pattern: >- ^(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:))$ - type: 'null' kind: type: string enum: - app - api userId: type: - string - 'null' required: - ip - kind - userId additionalProperties: false - type: 'null' required: - capturedAt - caller - callee - requester additionalProperties: false - type: 'null' required: - id - status - direction - from_number - to_number - started_at - ended_at - duration_seconds - phone_number_id - has_recording - recording_url - has_transcript - source - client_name - client_label - credential_type - test_result - created_at - user_id - failure_code - failure_category - disconnection_reason - network additionalProperties: false meta: type: object properties: cursor: type: string total_results: type: number page_size: type: number additionalProperties: false required: - data - meta additionalProperties: false '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Unauthorized headers: WWW-Authenticate: $ref: '#/components/headers/WWWAuthenticate' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: Forbidden headers: WWW-Authenticate: $ref: '#/components/headers/WWWAuthenticate' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '409': description: Conflict (incl. idempotency conflicts) content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': description: Rate limited headers: RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: headers: RateLimit: description: >- Current quota remaining and seconds until reset, using the IETF RateLimit structured-field syntax. schema: type: string example: '"default";r=599;t=60' RateLimitPolicy: description: Named quota policy and one-minute window. schema: type: string example: '"default";q=600;w=60' XRateLimitLimit: description: Maximum requests allowed in the current one-minute window. schema: type: integer XRateLimitRemaining: description: Requests remaining in the current window. schema: type: integer XRateLimitReset: description: Unix timestamp in milliseconds when the current window resets. schema: type: integer WWWAuthenticate: description: >- Bearer challenge with RFC 9728 protected-resource metadata and, on scope failures, the required scope. schema: type: string RetryAfter: description: Seconds to wait before retrying a rate-limited request. schema: type: integer minimum: 0 schemas: ErrorEnvelope: type: object properties: error: type: object required: - code - message properties: code: type: string message: type: string resolution_hint: type: string fields: type: object additionalProperties: type: string doc_url: type: string format: uri securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: RevDesk API key description: >- Organization-scoped RevDesk API key. Each operation declares its required permissions in x-required-scopes. x-scopes-supported: - account:read - agents:read - agents:write - bookings:read - brand:read - brand:write - caller_trust:read - caller_trust:write - calls:read - calls:write - contacts:read - contacts:write - jobs:read - jobs:write - notifications:write - phone_numbers:read - phone_numbers:write - optimize:read - optimize:write - sms:read - sms:write - sub_entities:read - sub_entities:write - tokens:mint - transcripts:read - usage:read - voice:read - voice:webrtc - voice:write - webhooks:read - webhooks:write ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.