> ## Documentation Index > Fetch the complete documentation index at: https://docs.itellico.ai/llms.txt > Use this file to discover all available pages before exploring further. # List calls > Paginated list of voice calls for the specified account and its subaccounts. Returns summary rows only; fetch an individual call for transcript and recording detail. ## OpenAPI ````yaml https://api.itellico.ai/v1/openapi.json get /v1/accounts/{account_id}/calls openapi: 3.1.0 info: title: itellicoAI API v1 version: 1.0.0 description: >- Public REST API for managing accounts, agents, telephony resources, and conversations. Authentication is via API key in the `X-API-Key` header. termsOfService: https://itellico.ai/legal/terms-and-conditions/ contact: name: itellicoAI Support email: support@itellico.ai license: name: Proprietary servers: - url: https://api.itellico.ai description: Production security: - APIKeyAuth: [] tags: - name: Accounts description: >- Identify the current account context and fetch core account metadata to bootstrap API usage. - name: Subaccounts description: >- Create and manage child accounts under a parent to model tenant hierarchies and delegated access. - name: Agents description: >- Define and configure conversational agents (model, transcriber, voice, behavior) used in calls and automations. - name: Providers description: >- Discover available AI model, transcriber, and voice catalogs for the current account when configuring agents. - name: Phone Numbers description: >- Manage BYOC phone numbers bound to your account; route inbound calls to agents and enable outbound calling. - name: SIP Trunks description: >- Manage BYOC SIP trunk connectivity (origination/termination endpoints and allowed IPs) used by phone numbers. - name: Calls description: >- Create, list, inspect, and connect voice calls across phone and web channels. - name: Conversations description: List and inspect conversation activity across web and telephony channels. - name: Analytics description: Usage analytics and reporting endpoints for conversation activity. paths: /v1/accounts/{account_id}/calls: get: tags: - Calls summary: List calls description: >- Paginated list of voice calls for the specified account and its subaccounts. Returns summary rows only; fetch an individual call for transcript and recording detail. operationId: listCalls parameters: - in: path name: account_id schema: format: uuid4 title: Account Id type: string required: true - in: query name: call_id schema: anyOf: - format: uuid4 type: string - type: 'null' description: Filter by call identifier. title: Call Id required: false description: Filter by call identifier. - in: query name: agent_id schema: anyOf: - format: uuid4 type: string - type: 'null' description: Filter by agent UUID. title: Agent Id required: false description: Filter by agent UUID. - in: query name: type schema: anyOf: - $ref: '#/components/schemas/ConversationType' - type: 'null' description: Filter by call type (`phone` or `web`). required: false description: Filter by call type (`phone` or `web`). - in: query name: status schema: anyOf: - $ref: '#/components/schemas/ConversationStatus' - type: 'null' description: >- Filter by lifecycle status (in_progress, completed, failed, transferred). required: false description: >- Filter by lifecycle status (in_progress, completed, failed, transferred). - in: query name: direction schema: anyOf: - $ref: '#/components/schemas/ConversationDirection' - type: 'null' description: Filter by call direction (inbound or outbound). required: false description: Filter by call direction (inbound or outbound). - in: query name: external_id schema: anyOf: - type: string - type: 'null' description: Filter by your external correlation/idempotency key. title: External Id required: false description: Filter by your external correlation/idempotency key. - in: query name: created_after schema: anyOf: - format: date-time type: string - type: 'null' description: Return calls created on/after this timestamp. title: Created After required: false description: Return calls created on/after this timestamp. - in: query name: created_before schema: anyOf: - format: date-time type: string - type: 'null' description: Return calls created before this timestamp. title: Created Before required: false description: Return calls created before this timestamp. - in: query name: updated_after schema: anyOf: - format: date-time type: string - type: 'null' description: Return calls updated on/after this timestamp. title: Updated After required: false description: Return calls updated on/after this timestamp. - in: query name: updated_before schema: anyOf: - format: date-time type: string - type: 'null' description: Return calls updated before this timestamp. title: Updated Before required: false description: Return calls updated before this timestamp. - in: query name: limit schema: default: 100 minimum: 1 title: Limit type: integer required: false - in: query name: offset schema: default: 0 minimum: 0 title: Offset type: integer required: false responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/NinjaPaginationResponseSchema_CallSummaryV1Out_ '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorSchema' security: - APIKeyAuth: [] components: schemas: ConversationType: description: High-level conversation types exposed via the v1 API. enum: - phone - web - test - unknown title: ConversationType type: string ConversationStatus: description: High-level lifecycle statuses reported by the conversations API. enum: - in_progress - completed - failed - transferred title: ConversationStatus type: string ConversationDirection: description: Directionality of a conversation. enum: - inbound - outbound - internal title: ConversationDirection type: string NinjaPaginationResponseSchema_CallSummaryV1Out_: properties: count: title: Count type: integer items: items: $ref: '#/components/schemas/CallSummaryV1Out' title: Items type: array required: - count - items title: NinjaPaginationResponseSchema[CallSummaryV1Out] type: object ErrorSchema: description: |- Standard error response payload for all API endpoints. Follows industry best practices (similar to Stripe, RetellAI): - code: Machine-readable error identifier for programmatic handling - message: Human-readable description for display - detail: Optional additional context for debugging - errors: Optional list of field-level validation errors examples: - code: not_found detail: Agent with UUID 123e4567-e89b-12d3-a456-426614174000 does not exist message: Resource not found - code: validation_error errors: - field: body.email message: Invalid email format type: value_error - field: body.name message: Field required type: missing message: Validation failed properties: code: description: Machine-readable error code (e.g., 'not_found', 'validation_error') title: Code type: string message: description: Human-readable error message title: Message type: string detail: anyOf: - type: string - type: 'null' description: Optional detailed context for debugging title: Detail errors: anyOf: - items: $ref: '#/components/schemas/FieldErrorSchema' type: array - type: 'null' description: Field-level validation errors (for 422 responses) title: Errors required: - code - message title: ErrorSchema type: object CallSummaryV1Out: properties: id: format: uuid4 title: Id type: string type: title: Type type: string direction: anyOf: - type: string - type: 'null' title: Direction status: title: Status type: string answer_status: anyOf: - $ref: '#/components/schemas/ConversationAnswerStatus' - type: 'null' description: >- How the call was answered when known (`waiting`, `human`, `machine`, `user_rejected`, `user_unavailable`, `user_busy`, or `unknown`). agent_id: anyOf: - format: uuid4 type: string - type: 'null' title: Agent Id agent_name: anyOf: - type: string - type: 'null' title: Agent Name from_number: anyOf: - type: string - type: 'null' title: From Number to_number: anyOf: - type: string - type: 'null' title: To Number external_id: anyOf: - type: string - type: 'null' title: External Id created: format: date-time title: Created type: string modified: format: date-time title: Modified type: string started_at: anyOf: - format: date-time type: string - type: 'null' title: Started At ended_at: anyOf: - format: date-time type: string - type: 'null' title: Ended At duration_seconds: anyOf: - type: integer - type: 'null' title: Duration Seconds required: - id - type - status - created - modified title: CallSummaryV1Out type: object FieldErrorSchema: description: Schema for individual field validation errors. properties: field: description: Field path (e.g., 'body.name', 'query.page') title: Field type: string message: description: Human-readable error message title: Message type: string type: description: Error type (e.g., 'value_error', 'type_error') title: Type type: string required: - field - message - type title: FieldErrorSchema type: object ConversationAnswerStatus: description: Public answer status values for voice calls. enum: - waiting - human - machine - user_rejected - user_unavailable - user_busy - unknown title: ConversationAnswerStatus type: string securitySchemes: APIKeyAuth: type: apiKey in: header name: X-API-Key ````