> ## Documentation Index > Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Conversation Turns > Returns conversation turns for one WhatsApp user. Timestamp boundaries are inclusive Unix epoch milliseconds. Continue pagination while `paging.next` is present, including when the current `data` array is empty. ## OpenAPI ````yaml /openapi/endpoints/meta-business-agent-public.openapi.json get /metaBusinessAgents/{entityId}/conversationTurns openapi: 3.0.0 info: title: YCloud Meta Business Agent Public API version: v2 description: >- Create, configure, test, and operate a Meta Business Agent for a WhatsApp Business phone number through YCloud. servers: - url: https://api.ycloud.com/v2 description: YCloud API base URL security: - api_key: [] tags: - name: Meta Business Agents description: >- Meta Business Agent onboarding, knowledge, skills, connectors, tools, operations, and evaluations. paths: /metaBusinessAgents/{entityId}/conversationTurns: get: tags: - Meta Business Agents summary: Get Conversation Turns description: >- Returns conversation turns for one WhatsApp user. Timestamp boundaries are inclusive Unix epoch milliseconds. Continue pagination while `paging.next` is present, including when the current `data` array is empty. operationId: meta-business-agent-get-conversation-turns parameters: - name: entityId in: path required: true schema: type: string description: WhatsApp Business Phone Number ID that owns the Meta Business Agent. - name: user_phone_number in: query required: true description: >- WhatsApp user phone number including the country code, with digits only and no leading `+`, spaces, or separators. schema: type: string pattern: ^[1-9][0-9]{1,14}$ example: '14155550123' - name: start_timestamp_ms in: query required: false description: Inclusive start time as Unix epoch milliseconds. schema: type: integer format: int64 minimum: 0 - name: end_timestamp_ms in: query required: false description: >- Inclusive end time as Unix epoch milliseconds. Must be greater than or equal to `start_timestamp_ms` when both are supplied. schema: type: integer format: int64 minimum: 0 - name: before in: query required: false description: Opaque backward-pagination cursor. Do not combine with `after`. schema: type: string minLength: 1 - name: after in: query required: false description: Opaque forward-pagination cursor. Do not combine with `before`. schema: type: string minLength: 1 - name: limit in: query required: false description: Maximum number of conversation turns to return. schema: type: integer format: int32 minimum: 1 responses: '200': description: Operation completed successfully. content: application/json: schema: $ref: '#/components/schemas/ConversationTurnPageDTO' '400': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/MetaBusinessAgentErrorResponse' '401': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/MetaBusinessAgentErrorResponse' '403': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/MetaBusinessAgentErrorResponse' '404': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/MetaBusinessAgentErrorResponse' '409': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/MetaBusinessAgentErrorResponse' '429': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/MetaBusinessAgentErrorResponse' '500': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/MetaBusinessAgentErrorResponse' '502': description: Request failed. content: application/json: schema: $ref: '#/components/schemas/MetaBusinessAgentErrorResponse' components: schemas: ConversationTurnPageDTO: type: object additionalProperties: false required: - data properties: data: type: array items: $ref: '#/components/schemas/ConversationTurnDTO' paging: $ref: '#/components/schemas/ConversationTurnPagingDTO' MetaBusinessAgentErrorResponse: type: object additionalProperties: true properties: status: type: integer code: type: string message: type: string target: type: string docUrl: type: string requestId: type: string metaBusinessAgentApiError: $ref: '#/components/schemas/MetaBusinessAgentApiError' ConversationTurnDTO: type: object additionalProperties: false required: - turn_id - conversation_id - steps properties: turn_id: type: string minLength: 1 description: Opaque identifier for the turn. conversation_id: type: string minLength: 1 description: >- App-scoped opaque identifier for the conversation containing this turn. message_id: type: string description: >- WhatsApp Cloud API message ID associated with this turn, when available. e2e_latency_ms: type: integer format: int64 minimum: 0 description: End-to-end turn latency in milliseconds. timestamp: type: integer format: int64 minimum: 0 description: Turn timestamp as Unix epoch milliseconds. steps: type: array items: $ref: '#/components/schemas/ConversationTurnStepDTO' ConversationTurnPagingDTO: type: object additionalProperties: false required: - cursors properties: cursors: $ref: '#/components/schemas/ConversationTurnCursorsDTO' previous: type: string next: type: string description: >- Present when another page is available, even if the current `data` array is empty. MetaBusinessAgentApiError: type: object additionalProperties: false properties: title: type: string description: Meta error title, when available. detail: type: string description: Actionable Meta error detail, when available. type: type: string description: Meta error category or URI, when available. status: type: integer description: Upstream HTTP status. requestId: type: string description: Upstream request identifier. ConversationTurnStepDTO: type: object additionalProperties: false required: - type properties: type: type: string enum: - LLM_CALL - TOOL_CALL latency_ms: type: integer format: int64 minimum: 0 status: type: string enum: - SUCCESS - ERROR - TIMEOUT llm_output_preview: type: string tool_name: type: string tool_input: type: string tool_output: type: string ConversationTurnCursorsDTO: type: object additionalProperties: false properties: before: type: string after: type: string securitySchemes: api_key: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.