> ## Documentation Index > Fetch the complete documentation index at: https://openphone-dev.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List calls > Fetch a paginated list of calls in the workspace, newest first. Every filter is optional, and group calls are included. ## OpenAPI ````yaml https://openphone-public-api-dev.s3.us-west-2.amazonaws.com/public/openphone-public-api-2026-03-30-dev.json get /calls openapi: 3.1.0 info: title: Quo Public API version: 1.0.0 description: API for connecting with Quo. contact: name: Quo Support email: support@quo.com url: https://support.quo.com/ termsOfService: https://www.quo.com/terms servers: - description: Development server url: https://dev-public-api.openphone.dev security: - apiKey: [] tags: - description: Operations related to calls name: Calls - description: >- Operations related to call summaries, including AI-generated summaries and Sona voice assistant summaries name: Call Summaries - description: >- Operations related to call transcripts, including AI-generated transcripts and Sona voice assistant transcripts name: Call Transcripts - description: Operations related to contacts name: Contacts - description: Operations related to contact shares name: Contact Shares - description: Operations related to contact notes name: Contact Notes - description: Operations related to contact properties name: Contact Properties - description: Operations related to conversations name: Conversations - description: Operations related to workspace invitations name: Invites - description: Operations related to text messages name: Messages - description: Operations related to the organization name: Organization - description: Operations related to phone numbers name: Phone Numbers - description: Operations related to users name: Users - description: Operations related to webhooks name: Webhooks - description: >- Operations related to webhook events, including delivery history and test events name: Webhook Events paths: /calls: get: tags: - Calls summary: List calls description: >- Fetch a paginated list of calls in the workspace, newest first. Every filter is optional, and group calls are included. operationId: listCalls parameters: - in: query name: phoneNumberId required: false schema: description: Only return calls on this Quo number. examples: - PN123abc pattern: ^PN(.*)$ type: string example: PN123abc - in: query name: userId required: false schema: description: >- Only return calls belonging to this Quo user. Requires an admin or owner when authenticating with a token. examples: - US123abc pattern: ^US(.*)$ type: string example: US123abc - in: query name: participant required: false schema: description: >- Only return calls that involve this E.164 phone number, on either end. examples: - '+15555555555' pattern: ^\+[1-9]\d{1,14}$ type: string example: '+15555555555' - in: query name: direction required: false schema: type: string enum: - incoming - outgoing description: The direction of the call relative to the Quo number. examples: - incoming example: incoming - in: query name: status required: false schema: description: >- Only return calls with this status, such as `status=missed`. To match any of several statuses, use `status[in]=missed,no-answer`. examples: - missed anyOf: - type: string enum: - queued - initiated - ringing - in-progress - completed - busy - failed - no-answer - canceled - missed - answered - forwarded - abandoned description: The current status of the call. examples: - completed - additionalProperties: false type: object required: - in properties: in: description: Match calls with any of these statuses. examples: - - missed - no-answer type: array items: type: string enum: - queued - initiated - ringing - in-progress - completed - busy - failed - no-answer - canceled - missed - answered - forwarded - abandoned description: The current status of the call. examples: - completed example: missed - in: query name: createdAt required: false schema: additionalProperties: false description: >- Bound the results by creation time, in ISO 8601 format: `createdAt[gt]=2022-01-01T00:00:00Z&createdAt[lt]=2022-02-01T00:00:00Z`. examples: - gt: '2022-01-01T00:00:00Z' type: object properties: gt: description: Only return calls created after this timestamp. examples: - '2022-01-01T00:00:00Z' format: date-time type: string lt: description: Only return calls created before this timestamp. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: gt: '2022-01-01T00:00:00Z' - in: query name: limit required: false schema: description: Max number of items to return per page. default: 10 maximum: 50 minimum: 1 type: integer - in: query name: after required: false schema: examples: - eyJsYXN0SWQiOiJVU211a09NaXBhIn0 type: string example: eyJsYXN0SWQiOiJVU211a09NaXBhIn0 - in: header name: Quo-Api-Version required: true schema: type: string enum: - '2026-03-30' description: 'API version header. Supported values: 2026-03-30' responses: '200': description: OK content: application/json: schema: type: object required: - data - nextCursor properties: data: type: array items: additionalProperties: false type: object required: - id - phoneNumberId - userId - direction - status - participants - answeredAt - answeredBy - initiatedBy - completedAt - createdAt - updatedAt - callRoute - duration - forwardedFrom - forwardedTo - aiHandled properties: id: description: The unique identifier of the call. examples: - AC123abc pattern: ^AC(.*)$ type: string example: AC123abc phoneNumberId: description: >- The unique identifier of the Quo number associated with the call. examples: - PN123abc pattern: ^PN(.*)$ type: string example: PN123abc userId: description: >- The unique identifier of the Quo user account associated with the call. examples: - US123abc pattern: ^US(.*)$ type: string example: US123abc direction: type: string enum: - incoming - outgoing description: >- The direction of the call relative to the Quo number. examples: - incoming example: incoming status: type: string enum: - queued - initiated - ringing - in-progress - completed - busy - failed - no-answer - canceled - missed - answered - forwarded - abandoned description: The current status of the call. examples: - completed example: completed participants: description: >- Every party on the call, including the Quo number. Group calls return all known parties, so this is not limited to two entries. A phone number can appear more than once when several Quo users joined the call on it, distinguished by `userId`. examples: - - phoneNumber: '+15555555555' userId: US123abc - phoneNumber: '+15555555555' userId: US456def - phoneNumber: '+15555555556' userId: null example: - phoneNumber: '+15555555555' userId: US123abc - phoneNumber: '+15555555555' userId: US456def - phoneNumber: '+15555555556' userId: null type: array items: additionalProperties: false type: object required: - phoneNumber - userId properties: phoneNumber: description: >- The E.164 phone number of the participant, including the country code. examples: - '+15555555555' pattern: ^\+[1-9]\d{1,14}$ type: string example: '+15555555555' userId: anyOf: - description: >- The Quo user behind this number. Null for numbers outside the workspace. examples: - US123abc pattern: ^US(.*)$ type: string example: US123abc - type: 'null' answeredAt: anyOf: - description: >- The timestamp when the call was answered, in ISO 8601 format. Null if the call was never answered. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' - type: 'null' answeredBy: anyOf: - description: >- The Quo user or system actor that answered the incoming call. Null for outgoing calls or unanswered incoming calls. examples: - USlHhXmRMz example: USlHhXmRMz anyOf: - pattern: ^US(.*)$ type: string - pattern: ^SYU(.*)$ type: string - type: 'null' initiatedBy: anyOf: - description: >- The Quo user or system actor that initiated the outgoing call. Null for incoming calls. examples: - USlHhXmRMz example: USlHhXmRMz anyOf: - pattern: ^US(.*)$ type: string - pattern: ^SYU(.*)$ type: string - type: 'null' completedAt: anyOf: - description: >- The timestamp when the call ended, in ISO 8601 format. Null if the call is ongoing or was not completed. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' - type: 'null' createdAt: description: >- The timestamp when the call record was created, in ISO 8601 format. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' updatedAt: anyOf: - description: >- The timestamp when the call record was last updated, in ISO 8601 format. Null if never updated. examples: - '2022-01-01T00:00:00Z' format: date-time type: string example: '2022-01-01T00:00:00Z' - type: 'null' callRoute: anyOf: - description: >- How the call reached the user's inbox: either by direct dial to their number or routed through a phone menu. Null for outbound calls. examples: - phone-number - phone-menu type: string example: phone-number - type: 'null' duration: description: The total duration of the call in seconds. examples: - 60 type: integer example: 60 forwardedFrom: anyOf: - description: >- Where the call was forwarded from: an E.164 phone number, a Quo user or phone number ID, a marker for a withheld caller (`anonymous`, `blocked`, `restricted`), or a short service number. Null if the call was not forwarded. examples: - US123abc example: US123abc anyOf: - description: >- A phone number in E.164 format, including the country code. examples: - '+15555555555' pattern: ^\+[1-9]\d{1,14}$ type: string example: '+15555555555' - pattern: ^PN(.*)$ type: string - pattern: ^US(.*)$ type: string - pattern: >- ^([aA](nonymous|NONYMOUS))|([bB](locked|LOCKED))|([rR](estricted|ESTRICTED))$ type: string - description: >- A short service or emergency number, such as `911` or `611`. examples: - '911' pattern: ^\d{3,6}$ type: string example: '911' - type: 'null' forwardedTo: anyOf: - description: >- Where the call was forwarded to: an E.164 phone number, a Quo user or phone number ID, a marker for a withheld caller (`anonymous`, `blocked`, `restricted`), or a short service number. Null if the call was not forwarded. examples: - US123abc example: US123abc anyOf: - description: >- A phone number in E.164 format, including the country code. examples: - '+15555555555' pattern: ^\+[1-9]\d{1,14}$ type: string example: '+15555555555' - pattern: ^PN(.*)$ type: string - pattern: ^US(.*)$ type: string - pattern: >- ^([aA](nonymous|NONYMOUS))|([bB](locked|LOCKED))|([rR](estricted|ESTRICTED))$ type: string - description: >- A short service or emergency number, such as `911` or `611`. examples: - '911' pattern: ^\d{3,6}$ type: string example: '911' - type: 'null' aiHandled: anyOf: - description: >- Type of AI that answered the call. Set to 'ai-agent' for AI responses, or null for human responses. examples: - ai-agent type: string example: ai-agent - type: 'null' nextCursor: description: >- Cursor for the next page, or null when there are no more pages. examples: - eyJsYXN0SWQiOiJVU211a09NaXBhIn0 example: eyJsYXN0SWQiOiJVU211a09NaXBhIn0 anyOf: - type: string - type: 'null' '400': description: Bad Request content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Bad Request type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: The input was invalid docs: https://quo.com/docs title: Bad Request errors: - path: /callId message: Expected string to match '^AC(.*)$' value: abc123 schema: type: TemplateLiteral pattern: ^AC(.*)$ '401': description: Unauthorized content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Unauthorized type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: Unauthorized docs: https://quo.com/docs title: Unauthorized trace: '6897907457496870895' '403': description: Forbidden content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Forbidden type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: User is forbidden to perform this action docs: https://quo.com/docs title: Forbidden trace: '6897907457496870895' '404': description: Not Found content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Not Found type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: Call not found docs: https://quo.com/docs title: Not Found trace: '6897907457496870895' '500': description: Unknown Error content: application/json: schema: type: object required: - message - docs - title properties: message: type: string docs: const: https://quo.com/docs type: string title: const: Unknown type: string trace: type: string errors: type: array items: type: object required: - path - message - schema properties: path: type: string message: type: string value: {} schema: type: object required: - type properties: type: type: string example: message: We have encountered an unknown error docs: https://quo.com/docs title: Unknown trace: '6897907457496870895' security: - apiKey: [] components: securitySchemes: apiKey: in: header name: Authorization type: apiKey ````