> ## 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 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 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 - 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: ' ````