> ## Documentation Index > Fetch the complete documentation index at: https://docs.useanima.sh/llms.txt > Use this file to discover all available pages before exploring further. # Get phonesmsthreads 1 ## OpenAPI ````yaml /openapi.json get /phone/sms/threads/{id} openapi: 3.1.1 info: title: Anima API version: 0.1.0 description: >- The Anima API provides programmatic access to unified infrastructure for AI agents: create and manage agents; send and receive email; place phone calls and send/receive SMS and voice; store and retrieve vault credentials; manage agent identity; and configure webhooks for real-time events. Authenticate using a Bearer token or an API key passed via the X-API-Key header. contact: name: Anima Labs url: https://useanima.sh email: support@useanima.sh license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://api.useanima.sh/v1 description: Production security: - BearerAuth: [] - ApiKeyAuth: [] paths: /phone/sms/threads/{id}: get: operationId: phone.getSmsThread parameters: - name: id in: path required: true schema: type: string description: >- Conversation identifier from sms_thread_list / MessageOutput.threadId - name: limit in: query required: false schema: default: 50 type: integer minimum: 1 maximum: 100 description: >- Maximum messages to return (1–100, default 50). When the conversation is longer, the MOST RECENT `limit` messages are returned (still ordered oldest-first among themselves) — reach deeper history via GET /messages?threadId=. allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: threadId: type: string description: Conversation identifier agentId: type: string description: Agent that owns this conversation participantAddress: type: string description: The counterparty's phone number (E.164) agentAddress: type: string description: The agent's own phone number used in this conversation messages: type: array items: type: object properties: id: type: string pattern: ^[cC][^\s-]{8,}$ description: Unique identifier of the message agentId: type: string pattern: ^[cC][^\s-]{8,}$ description: ID of the agent that sent or received the message inboxId: anyOf: - type: string pattern: ^[cC][^\s-]{8,}$ - type: 'null' description: >- ID of the inbox this message belongs to — the inbox it was delivered to (inbound) or sent from (outbound). Null when no inbox backs the address: SMS/MMS/voice messages, and email sent from an email identity that has no inbox (such as a custom-domain identity added to an agent). Pass it to GET /messages?inboxId= to list one inbox's mail. channel: enum: - EMAIL - SMS - MMS - VOICE - WHATSAPP - RCS type: string description: Communication channel used direction: enum: - INBOUND - OUTBOUND type: string description: Whether the message was inbound or outbound status: enum: - QUEUED - SENT - DELIVERED - FAILED - BOUNCED - BLOCKED - PENDING_APPROVAL type: string description: Current delivery status fromAddress: type: string description: Sender address (email or phone number) toAddress: type: string description: Recipient address (email or phone number) subject: anyOf: - type: string - type: 'null' description: >- Message subject line, or null for channels that do not support subjects body: type: string description: Plain-text content of the message bodyHtml: anyOf: - type: string - type: 'null' description: >- HTML content of the message, or null if not available extractedText: anyOf: - type: string - type: 'null' description: >- Plain-text body with the quoted reply chain and signature stripped — just what this sender actually wrote. Read this instead of `body` to avoid re-reading (and paying for) the whole thread on every message. Null when nothing was extracted: non-email channels, messages your agent sent, and mail received before this field existed — so `extractedText ?? body` is always correct. Best-effort and heuristic; `body` remains the verbatim source of truth. Known weak cases: forwards and bottom-posted replies have no separable 'new' part, so this returns the full body rather than nothing. extractedHtml: anyOf: - type: string - type: 'null' description: >- HTML body with quoted reply chains removed. Same semantics as `extractedText`; `bodyHtml` stays verbatim. Quoting styles that mark the chain with a sibling element rather than wrapping it (Outlook) are not stripped here — `extractedText` still is. headers: anyOf: - type: object additionalProperties: {} - type: 'null' description: Raw message headers as key-value pairs, or null metadata: anyOf: - type: object additionalProperties: {} - type: 'null' description: Arbitrary metadata attached to the message, or null threadId: anyOf: - type: string - type: 'null' description: Thread identifier for conversation grouping, or null labels: type: array items: type: string description: >- Workflow labels on this message. Always contains exactly one of the system labels `unread` or `read`; may also contain `archived`, `spam` (the inbound spam verdict — see `includeSpam` on list/search), and any labels you add yourself. Stored lowercase, deduped, and sorted. Change them with PATCH /messages/{id}/labels. inReplyTo: anyOf: - type: string - type: 'null' description: Message ID this message is replying to, or null externalId: anyOf: - type: string - type: 'null' description: >- External identifier, or null. For email: the RFC 5322 Message-ID (bare, no angle brackets) — pass it as inReplyTo to reply in-thread. For SMS: the provider-assigned message id. deletedAt: anyOf: - type: string format: date-time - type: 'null' description: >- When this message was moved to Trash, or null if it is live. Deleted messages are hidden from listings unless `deleted` is set to `include` or `only`, and can be brought back with POST /messages/{id}/restore. Nothing purges them. sentAt: anyOf: - type: string format: date-time - type: 'null' description: >- Timestamp when the message was sent, or null if not yet sent receivedAt: anyOf: - type: string format: date-time - type: 'null' description: >- Timestamp when the message was received, or null for outbound messages readAt: anyOf: - type: string format: date-time - type: 'null' description: >- Outbound WhatsApp and RCS messages only: when the recipient's device reported the message as read. Null for inbound messages and for every other channel. Unrelated to the read and unread labels, which record whether the agent has handled a message. attachments: type: array items: type: object properties: id: type: string pattern: ^[cC][^\s-]{8,}$ description: Unique identifier of the attachment filename: type: string description: Original filename of the attachment mimeType: type: string description: >- MIME type of the attachment (e.g. application/pdf) sizeBytes: type: integer minimum: 0 description: File size in bytes storageKey: type: string description: Internal storage key for retrieving the file url: anyOf: - type: string format: uri - type: 'null' description: >- Pre-signed download URL, or null if not yet generated createdAt: type: string format: date-time description: Timestamp when the attachment was created scanStatus: enum: - PENDING - CLEAN - FLAGGED - BLOCKED type: string description: >- Content-scan verdict. BLOCKED attachments cannot be downloaded — inspect before fetching bytes. detectedMimeType: anyOf: - type: string - type: 'null' description: >- MIME type inferred from magic bytes; may differ from the declared mimeType required: - id - filename - mimeType - sizeBytes - storageKey - url - createdAt - scanStatus - detectedMimeType description: File attachment associated with a message description: File attachments associated with this message createdAt: type: string format: date-time description: Timestamp when the message record was created updatedAt: type: string format: date-time description: Timestamp when the message record was last updated required: - id - agentId - inboxId - channel - direction - status - fromAddress - toAddress - subject - body - bodyHtml - extractedText - extractedHtml - headers - metadata - threadId - labels - inReplyTo - externalId - deletedAt - sentAt - receivedAt - readAt - attachments - createdAt - updatedAt description: Full message resource representation description: >- Messages in chronological (oldest-first) reading order. When the conversation is longer than `limit`, this is its most recent window. messageCount: type: integer description: Total messages in the conversation hasMore: type: boolean description: >- True when the conversation holds more messages than this response returned (older ones precede `messages`) required: - threadId - agentId - participantAddress - agentAddress - messages - messageCount - hasMore description: One SMS conversation with its message history components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer ApiKeyAuth: type: apiKey in: header name: X-API-Key description: 'API key for programmatic access. Pass as: X-API-Key: ' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.