> ## Documentation Index > Fetch the complete documentation index at: https://docs.decimal.app/llms.txt > Use this file to discover all available pages before exploring further. # Get conversation > Returns the conversation with all messages. Use this to poll for completion after sending a message — check the top-level `status` field. ## OpenAPI ````yaml /openapi-v0.yaml get /v0/chat/{conversation_id} openapi: 3.1.0 info: title: Decimal Chat API version: v0 description: > ## Authentication All endpoints require a Bearer token: ``` Authorization: Bearer sk-de-... ``` API tokens are created in the Decimal dashboard under Settings → API Tokens. Each token has scopes that control access: `chat:read`, `chat:write`, `chat:escalate`. ## Quick Start ```bash # 1. Send a message curl -X POST https://api.getdecimal.ai/v0/chat \ -H "Authorization: Bearer sk-de-..." \ -H "Content-Type: application/json" \ -d '{"message": "How do I configure SSO?"}' # → 202 { "conversation_id": "abc123", "status": "processing" } # 2. Poll until complete curl https://api.getdecimal.ai/v0/chat/abc123 \ -H "Authorization: Bearer sk-de-..." # → 200 { "status": "completed", "messages": [...] } ``` ### Continue a conversation ```bash curl -X POST https://api.getdecimal.ai/v0/chat \ -H "Authorization: Bearer sk-de-..." \ -H "Content-Type: application/json" \ -d '{"message": "Can you show me the SAML setup?", "conversation_id": "abc123"}' ``` ## Rate Limiting Every response includes rate limit headers: - `X-RateLimit-Limit` — Requests allowed per minute - `X-RateLimit-Remaining` — Requests remaining in current window - `X-RateLimit-Reset` — Unix timestamp when the window resets Rate limits apply at two levels: - **Per API token:** 120 requests/min - **Per organization:** 600 requests/min across all tokens The stricter limit applies. Headers report the per-token limit. Contact support for higher limits. contact: name: Decimal Support url: https://getdecimal.ai servers: - url: https://api.getdecimal.ai description: Production - url: http://localhost:3000 description: Local development security: - BearerAuth: [] tags: - name: Chat description: >- Send messages and get AI-powered answers from your public knowledge base and code. - name: Escalation description: Escalate conversations to external ticketing integrations. - name: Utility description: Token introspection. paths: /v0/chat/{conversation_id}: parameters: - $ref: '#/components/parameters/ConversationId' get: tags: - Chat summary: Get conversation description: > Returns the conversation with all messages. Use this to poll for completion after sending a message — check the top-level `status` field. operationId: getConversation responses: '200': description: Conversation with message history. headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Conversation' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' security: - BearerAuth: - chat:read components: parameters: ConversationId: name: conversation_id in: path required: true schema: type: string description: Conversation ID (returned by `POST /v0/chat`). headers: X-RateLimit-Limit: description: Maximum requests allowed per minute. schema: type: integer X-RateLimit-Remaining: description: Requests remaining in the current window. schema: type: integer X-RateLimit-Reset: description: Unix timestamp when the rate limit window resets. schema: type: integer schemas: Conversation: type: object properties: id: type: string status: type: string enum: - completed - processing - failed description: >- Conversation status. `processing` while the AI is working, `completed` once the response is ready, or `failed` if an error occurred. messages: type: array items: $ref: '#/components/schemas/ConversationMessage' created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - status - messages - created_at - updated_at ConversationMessage: type: object properties: role: type: string enum: - user - assistant content: type: string description: The message text. sources: type: array items: $ref: '#/components/schemas/Source' description: Citations for the response. Present on assistant messages. required: - role - content Error: type: object properties: error: type: object properties: code: type: string enum: - bad_request - unauthorized - forbidden - not_found - conflict - rate_limited - internal_error description: Machine-readable error code. message: type: string description: Human-readable error message. retryable: type: boolean description: Whether the client should retry the request. required: - code - message required: - error Source: type: object properties: title: type: string description: Display title for the source. url: type: string format: uri description: Link to the source (KB article URL or code permalink). required: - title responses: Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: Valid API key but insufficient scope. content: application/json: schema: $ref: '#/components/schemas/Error' NotFound: description: Resource not found. content: application/json: schema: $ref: '#/components/schemas/Error' RateLimited: description: Rate limit exceeded. headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' Retry-After: description: Seconds until the rate limit resets. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: BearerAuth: type: http scheme: bearer description: | API token with `sk-de-` prefix. Created in the Decimal dashboard under Settings → API Tokens. ````