> ## Documentation Index > Fetch the complete documentation index at: https://docs.puppeteerai.com/llms.txt > Use this file to discover all available pages before exploring further. # List Calls > List calls for the authenticated organization, newest first, using cursor-based pagination. ## OpenAPI ````yaml /api-reference/openapi.json get /calls openapi: 3.1.0 info: title: Puppeteer Core API description: >- Core API for the Puppeteer AI platform. Manages domain models, conversations, voice calls, simulations, and integrations. [Documentation](https://docs.puppeteerai.com) version: 1.0.0 servers: - url: https://api.puppeteerai.com description: Production security: [] tags: - name: Auth description: JWT token generation and organization creation. - name: Messages description: >- Send and receive messages, retrieve conversation history, search, and create messages in threads. - name: Threads description: Create and manage threads, aliases, scheduled events, and bulk operations. - name: Voice description: Voice call handling, scheduling, batch calls, and WebSocket LLM. paths: /calls: get: tags: - Calls summary: List Calls description: >- List calls for the authenticated organization, newest first, using cursor-based pagination. operationId: list_calls_calls_get parameters: - name: status in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: Filter by call status. Repeat to allow multiple values. title: Status description: Filter by call status. Repeat to allow multiple values. - name: call_type in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: Filter by call type. Repeat to allow multiple values. title: Call Type description: Filter by call type. Repeat to allow multiple values. - name: direction in: query required: false schema: anyOf: - items: type: string type: array - type: 'null' description: Filter by call direction. Repeat to allow multiple values. title: Direction description: Filter by call direction. Repeat to allow multiple values. - name: from_date in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Only include calls created at or after this ISO 8601 date/datetime. title: From Date description: Only include calls created at or after this ISO 8601 date/datetime. - name: to_date in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Only include calls created at or before this ISO 8601 date/datetime. title: To Date description: Only include calls created at or before this ISO 8601 date/datetime. - name: thread_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Only include calls belonging to this thread. title: Thread Id description: Only include calls belonging to this thread. - name: project_name in: query required: false schema: anyOf: - type: string - type: 'null' description: Only include calls belonging to this project. title: Project Name description: Only include calls belonging to this project. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Base64-encoded pagination cursor from a previous response. title: Cursor description: Base64-encoded pagination cursor from a previous response. - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Maximum number of calls to return. default: 20 title: Limit description: Maximum number of calls to return. - name: Authorization in: header required: true schema: type: string title: Authorization responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CallsListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: CallsListResponse: properties: calls: items: $ref: '#/components/schemas/CallSummary' type: array title: Calls description: The page of calls, newest first. pagination: $ref: '#/components/schemas/routers__calls__CursorPagination' type: object required: - calls - pagination title: CallsListResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CallSummary: properties: id: type: string title: Id description: Unique identifier of the call. thread_id: type: string title: Thread Id description: Identifier of the thread this call belongs to. conversation_id: anyOf: - type: integer - type: 'null' title: Conversation Id description: >- Identifier of the conversation, or null for scheduled calls that never started. call_type: type: string title: Call Type description: Type of the call, e.g. "phone_call" or "web_call". status: type: string title: Status description: Current status, e.g. "scheduled", "ongoing", "ended", "error". direction: anyOf: - type: string - type: 'null' title: Direction description: Call direction, "inbound" or "outbound". from_number: anyOf: - type: string - type: 'null' title: From Number description: Originating phone number (phone calls only). to_number: anyOf: - type: string - type: 'null' title: To Number description: Destination phone number (phone calls only). scheduled_for: anyOf: - type: string - type: 'null' title: Scheduled For description: ISO 8601 timestamp the call is scheduled for, or null. start_timestamp: anyOf: - type: integer - type: 'null' title: Start Timestamp description: >- Unix timestamp (seconds) when the call started, or null if it has not started. end_timestamp: anyOf: - type: integer - type: 'null' title: End Timestamp description: >- Unix timestamp (seconds) when the call ended, or null if it has not ended. duration_ms: anyOf: - type: integer - type: 'null' title: Duration Ms description: Call duration in milliseconds, or null. disconnection_reason: anyOf: - type: string - type: 'null' title: Disconnection Reason description: Reason the call ended, if known. created_at: type: string title: Created At description: ISO 8601 timestamp when the call record was created. type: object required: - id - thread_id - call_type - status - created_at title: CallSummary routers__calls__CursorPagination: properties: cursor: anyOf: - type: string - type: 'null' title: Cursor description: >- Base64-encoded cursor for the next page of results. Null when there are no more results. type: object required: - cursor title: CursorPagination ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ````