> ## Documentation Index > Fetch the complete documentation index at: https://docs.layerfi.com/llms.txt > Use this file to discover all available pages before exploring further. # List business calls > Returns a combined timeline of booked calls and recordings without bookings. Cancelled bookings are included unless you filter by status. Each public response contains only the call ID, start time, and recording flag, not booking details or recording URLs. Authenticate with a platform access token or a business-scoped token authorized for this business. Transcript search with q is not available to public callers. ## OpenAPI ````yaml get /v1/businesses/{businessId}/calls openapi: 3.0.1 info: title: API version: latest servers: [] security: - BearerAuth: [] tags: [] externalDocs: url: / paths: /v1/businesses/{businessId}/calls: get: summary: List business calls description: >- Returns a combined timeline of booked calls and recordings without bookings. Cancelled bookings are included unless you filter by status. Each public response contains only the call ID, start time, and recording flag, not booking details or recording URLs. Authenticate with a platform access token or a business-scoped token authorized for this business. Transcript search with q is not available to public callers. operationId: calls.list parameters: - $ref: '#/components/parameters/CallListBusinessId' - name: start_date in: query description: >- Inclusive start date in America/New_York. Must not be later than end_date. schema: type: string format: date - name: end_date in: query description: Inclusive end date in America/New_York. schema: type: string format: date - name: status in: query description: >- Filter by booking status. Unbooked calls are recordings without a linked booking. Values are case-sensitive. schema: type: string enum: - upcoming - past - cancelled - unbooked - name: recording in: query description: >- Filter by recording availability. recorded: has a recording; none: has no recording; missing: a past booking without a recording, unless attendance is explicitly false; unbooked: a recording without a booking. Values are case-sensitive. schema: type: string enum: - recorded - none - missing - unbooked - $ref: '#/components/parameters/CallSummarySortBy' - $ref: '#/components/parameters/CallSummarySortOrder' - $ref: '#/components/parameters/CallListCursor' - $ref: '#/components/parameters/CallListLimit' - $ref: '#/components/parameters/CallListShowTotalCount' responses: '200': description: >- A page of public call summaries. No meeting links, recording URLs, or transcripts are returned. content: application/json: schema: type: object required: - data - meta properties: data: type: array items: $ref: '#/components/schemas/ApiCallSummary' meta: $ref: '#/components/schemas/RequestMetadata' components: parameters: CallListBusinessId: name: businessId in: path required: true description: The UUID of the business. schema: type: string format: uuid CallSummarySortBy: name: sort_by in: query schema: type: string enum: - started_at default: started_at CallSummarySortOrder: name: sort_order in: query schema: type: string enum: - ASC - DESC default: DESC CallListCursor: name: cursor in: query description: >- Opaque cursor from meta.pagination.cursor. Omit for the first page. Keep filters and sort settings unchanged between pages. schema: type: string CallListLimit: name: limit in: query description: Maximum number of results per page. schema: type: integer minimum: 1 maximum: 1000 default: 100 CallListShowTotalCount: name: show_total_count in: query description: >- Include the total number of matching results in meta.pagination.total_count. schema: type: boolean default: false schemas: ApiCallSummary: type: object description: >- The public call representation. Booking and recording details are not included. required: - id - started_at - recorded properties: type: type: string enum: - Call_Summary id: type: string format: uuid description: >- The booking ID when a booking exists; otherwise the recorded-call ID. started_at: type: string format: date-time description: >- The call start timestamp. The combined calls list uses the booking start time when a booking exists. recorded: type: boolean description: Whether a recording exists. RequestMetadata: type: object description: Request metadata. Present on paginated list responses. properties: type: type: string description: Metadata type discriminator. Value will be `request_metadata`. example: request_metadata pagination: $ref: '#/components/schemas/PaginationMetadata' PaginationMetadata: type: object description: >- Cursor-based pagination metadata returned alongside paginated list responses. properties: sort_by: type: string nullable: true description: Field the result set is sorted by. sort_order: type: string enum: - ASC - DESC description: Sort direction applied to the result set. example: ASC cursor: type: string nullable: true description: >- Opaque cursor for the next page. Pass it using the query parameter documented for the endpoint. Null when there are no further pages. has_more: type: boolean description: Whether additional pages are available after the current one. total_count: type: integer format: int64 nullable: true description: Total number of records across all pages, when available. required: - sort_by - sort_order - cursor - has_more securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.