> ## Documentation Index > Fetch the complete documentation index at: https://docs.brosbots.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Conversation > One call: contexts, cost, SMS, and signed links to download the recording and transcript (`recording_download_url`, `transcript_download_url`, valid until `download_urls_expire_at`). ## OpenAPI ````yaml /api-reference/openapi.en.json get /api/v1/agents/{agent_id}/conversations/{conversation_id} openapi: 3.1.0 info: title: Brosbots API description: > The public Brosbots REST API. Build and manage voice agents, run outbound campaigns, read calls and usage, and manage phone numbers, tools, knowledge bases and integrations. ## Authentication Every request must include your organization's API key in the `X-API-Key` header: ``` X-API-Key: bb_live_... ``` You create and revoke keys in the dashboard: click your account in the bottom-left corner of the sidebar, then **Brosbots API**. ## Base URL ``` https://app.brosbots.com/api/v1 ``` ## Conventions - Request and response bodies are JSON (`Content-Type: application/json`). - Timestamps are ISO 8601 with a timezone. - Lists are paginated with `page` / `limit` parameters; responses include `total_count` / `total_pages`. - Errors use standard HTTP status codes with a JSON body: `{"detail": "a human-readable reason"}`. - `{agent_id}` accepts the agent's public ID (`agent_...`) or its number. ## Limits There is no fixed per-key request-rate limit today. `429` comes from the calling endpoints (`POST /agents/{agent_id}/calls` and `POST /triggers/{trigger_id}/calls`) when every outbound channel is busy; its `Retry-After` header says how many seconds to wait. Handle `429` generally: wait as long as `Retry-After` says, or back off exponentially when it is absent. A request-rate limit may be introduced. version: 1.0.0 servers: [] security: - ApiKeyAuth: [] paths: /api/v1/agents/{agent_id}/conversations/{conversation_id}: get: tags: - Agents & Calls summary: Get Conversation description: >- One call: contexts, cost, SMS, and signed links to download the recording and transcript (`recording_download_url`, `transcript_download_url`, valid until `download_urls_expire_at`). operationId: get_agents_agent_id_conversations_conversation_id parameters: - name: agent_id in: path required: true schema: anyOf: - type: string pattern: ^agent_[A-Za-z0-9]{20}$ - type: integer examples: - agent_7fK2mQ9xLp3RtV8wYb1N - 42 description: >- The agent's ID: the public `agent_` + 20 characters identifier shown in the dashboard (recommended), or the legacy number. Both address the same agent. - name: conversation_id in: path required: true schema: type: integer - name: authorization in: header required: false schema: anyOf: - type: string - type: 'null' - name: X-API-Key in: header required: false schema: anyOf: - type: string - type: 'null' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/ConversationDetailResponse' '404': description: Not found '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: ConversationDetailResponse: properties: id: type: integer workflow_id: type: integer name: type: string mode: type: string created_at: type: string format: date-time is_completed: type: boolean transcript_url: anyOf: - type: string - type: 'null' description: >- Storage key of the file (e.g. `recordings/580.wav`), not a URL. Kept for existing integrations; download through `transcript_download_url` instead. recording_url: anyOf: - type: string - type: 'null' description: >- Storage key of the file (e.g. `recordings/580.wav`), not a URL. Kept for existing integrations; download through `recording_download_url` instead. cost_info: anyOf: - additionalProperties: true type: object - type: 'null' provider_call_id: anyOf: - type: string - type: 'null' definition_id: anyOf: - type: integer - type: 'null' initial_context: anyOf: - additionalProperties: true type: object - type: 'null' gathered_context: anyOf: - additionalProperties: true type: object - type: 'null' call_type: $ref: '#/components/schemas/CallType' logs: anyOf: - additionalProperties: true type: object - type: 'null' sms_messages: items: $ref: '#/components/schemas/SmsMessageSchema' type: array default: [] duration_seconds: anyOf: - type: integer - type: 'null' description: >- Call length in whole seconds; null until the call has ended. The same value call.completed sends as duration_seconds. transcript_download_url: anyOf: - type: string - type: 'null' description: >- Signed HTTPS link to the transcript text file, valid until download_urls_expire_at. No API key needed to open it. recording_download_url: anyOf: - type: string - type: 'null' description: >- Signed HTTPS link to the WAV recording, valid until download_urls_expire_at. No API key needed to open it. download_urls_expire_at: anyOf: - type: string format: date-time - type: 'null' description: >- When the download links stop working (1 hour after the request). Fetch the conversation again for fresh ones. type: object required: - id - workflow_id - name - mode - created_at - is_completed - transcript_url - recording_url - cost_info - definition_id - call_type title: ConversationDetailResponse description: One conversation, with links to download its files. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array type: object title: HTTPValidationError CallType: type: string enum: - inbound - outbound title: CallType SmsMessageSchema: properties: id: type: integer direction: type: string from_number: type: string to_number: type: string text: type: string status: type: string error_detail: anyOf: - type: string - type: 'null' created_at: anyOf: - type: string format: date-time - type: 'null' type: object required: - id - direction - from_number - to_number - text - status title: SmsMessageSchema ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array msg: type: string type: type: string type: object required: - loc - msg - type title: ValidationError securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: >- Your organization's API key (account in the bottom-left of the dashboard → Brosbots API). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.