Api Endpoint

AgentMail Threads

Fetches threaded mailbox conversation data from the AgentMail API.

Open interactive test console

Offering

Provider: x402.api.agentmail.to
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Infrastructure
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://x402.api.agentmail.to/v0/threads
MIME type: application/json
First seen: 2026-10-16T01:50:04.685Z
Last seen: 2026-10-31T14:59:46.576Z
Tags: X402, agentic-markets, Email, Agent-Infra, Social, inbox, communication

Website Documentation OpenAPI

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0 USDC
Atomic price: 0 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2: 0 USDC
Atomic price: 0 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Payment option 3: 0 USDC
Atomic price: 0 · Network: eip155:43114 · Asset: USDC · Scheme: exact
Payment option 4: 0 USDC
Atomic price: 0 · Network: eip155:137 · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "0",
    "payTo": "0x6e3184C204e596dED89E8A5693B602097F4Ab687"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "0",
    "payTo": "7r4e5dwNS68MDaxbw7N8jbzHq7RCMBp9z6smHFH4NXWw"
  },
  {
    "scheme": "exact",
    "network": "eip155:43114",
    "asset": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
    "amount": "0",
    "payTo": "0x6e3184C204e596dED89E8A5693B602097F4Ab687"
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "0",
    "payTo": "0x6e3184C204e596dED89E8A5693B602097F4Ab687"
  }
]

Observed health

Status: Healthy
Latest latency: 1301 ms
Average latency: 855 ms
HTTP status: 402
Last checked: 2026-11-02T02:47:58.725Z
Reachability: 100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "http",
  "method": "GET",
  "queryParams": {
    "type": "object",
    "properties": {
      "after": {
        "$ref": "#/components/schemas/type_:After",
        "description": "query parameter"
      },
      "limit": {
        "$ref": "#/components/schemas/type_:Limit",
        "description": "query parameter"
      },
      "before": {
        "$ref": "#/components/schemas/type_:Before",
        "description": "query parameter"
      },
      "labels": {
        "$ref": "#/components/schemas/type_:Labels",
        "description": "query parameter"
      },
      "ascending": {
        "$ref": "#/components/schemas/type_:Ascending",
        "description": "query parameter"
      },
      "page_token": {
        "$ref": "#/components/schemas/type_:PageToken",
        "description": "query parameter"
      },
      "include_spam": {
        "$ref": "#/components/schemas/type_:IncludeSpam",
        "description": "query parameter"
      },
      "include_trash": {
        "$ref": "#/components/schemas/type_:IncludeTrash",
        "description": "query parameter"
      },
      "include_blocked": {
        "$ref": "#/components/schemas/type_:IncludeBlocked",
        "description": "query parameter"
      }
    }
  }
}

Output schema

{
  "type": "object",
  "title": "ListThreadsResponse",
  "required": [
    "count",
    "threads"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "title": "Count",
      "description": "Number of items returned."
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "description": "Limit of number of items returned."
    },
    "threads": {
      "type": "array",
      "items": {
        "type": "object",
        "title": "ThreadItem",
        "required": [
          "inbox_id",
          "thread_id",
          "labels",
          "timestamp",
          "senders",
          "recipients",
          "last_message_id",
          "message_count",
          "size",
          "updated_at",
          "created_at"
        ],
        "properties": {
          "size": {
            "type": "integer",
            "title": "ThreadSize",
            "description": "Size of thread in bytes."
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "ThreadLabels",
            "description": "Labels of thread."
          },
          "preview": {
            "type": "string",
            "title": "ThreadPreview",
            "description": "Text preview of last message in thread."
          },
          "senders": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "ThreadSenders",
            "description": "Senders in thread. In format `username@domain.com` or `Display Name <username@domain.com>`."
          },
          "subject": {
            "type": "string",
            "title": "ThreadSubject",
            "description": "Subject of thread."
          },
          "inbox_id": {
            "type": "string",
            "title": "InboxId",
            "description": "The ID of the inbox."
          },
          "thread_id": {
            "type": "string",
            "title": "ThreadId",
            "description": "ID of thread."
          },
          "timestamp": {
            "type": "string",
            "title": "ThreadTimestamp",
            "format": "date-time",
            "description": "Timestamp of last sent or received message."
          },
          "created_at": {
            "type": "string",
            "title": "ThreadCreatedAt",
            "format": "date-time",
            "description": "Time at which thread was created."
          },
          "recipients": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "title": "ThreadRecipients",
            "description": "Recipients in thread. In format `username@domain.com` or `Display Name <username@domain.com>`."
          },
          "updated_at": {
            "type": "string",
            "title": "ThreadUpdatedAt",
            "format": "date-time",
            "description": "Time at which thread was last updated."
          },
          "attachments": {
            "type": "array",
            "items": {
              "type": "object",
              "title": "Attachment",
              "required": [
                "attachment_id",
                "size"
              ],
              "properties": {
                "size": {
                  "type": "integer",
                  "title": "AttachmentSize",
                  "description": "Size of attachment in bytes."
                },
                "filename": {
                  "type": "string",
                  "title": "AttachmentFilename",
                  "description": "Filename of attachment."
                },
                "content_id": {
                  "type": "string",
                  "title": "AttachmentContentId",
                  "description": "Content ID of attachment."
                },
                "content_type": {
                  "type": "string",
                  "title": "AttachmentContentType",
                  "description": "Content type of attachment."
                },
                "attachment_id": {
                  "type": "string",
                  "title": "AttachmentId",
                  "description": "ID of attachment."
                },
                "content_disposition": {
                  "enum": [
                    "inline",
                    "attachment"
                  ],
                  "type": "string",
                  "title": "AttachmentContentDisposition",
                  "description": "Content disposition of attachment."
                }
              }
            },
            "title": "ThreadAttachments",
            "description": "Attachments in thread."
          },
          "message_count": {
            "type": "integer",
            "title": "ThreadMessageCount",
            "description": "Number of messages in thread."
          },
          "sent_timestamp": {
            "type": "string",
            "title": "ThreadSentTimestamp",
            "format": "date-time",
            "description": "Timestamp of last sent message."
          },
          "last_message_id": {
            "type": "string",
            "title": "ThreadLastMessageId",
            "description": "ID of last message in thread."
          },
          "received_timestamp": {
            "type": "string",
            "title": "ThreadReceivedTimestamp",
            "format": "date-time",
            "description": "Timestamp of last received message."
          }
        }
      },
      "description": "Ordered by `timestamp` descending."
    },
    "next_page_token": {
      "type": "string",
      "title": "PageToken",
      "description": "Page token for pagination."
    }
  }
}