Inbound Requests

List inbound email requests

The mail agent's conversations: one row per email the workspace's inbox accepted, newest first, paginated.

The lifecycle is received -> parsing -> parsed -> drafted -> awaiting_approval, then one of the terminal states approved, cancelled, expired, rejected, or failed. parsing may instead go to needs_info when the parser could not determine something, which loops back to parsing when the sender replies; that loop is capped, and clarificationRoundTrips says how many rounds have been used.

?state=awaiting_approval is the set an agent can act on. ?state=needs_info is the set waiting on a human to answer the clarification email.

Every row is redacted: no message bodies, no storage keys, no reply token, no provider message ids, and no row ids. What is published is the workflow, not the mail.

Costs both envelopes:read and account:read, because a row names the parsed signers and the public ids of the document and envelope it produced.

get/inbound-requests

Request

  • Base URL: https://inkseal.net/api/v1
  • URL: https://inkseal.net/api/v1/inbound-requests
  • Auth: HTTP bearer

Query parameters

pageinteger

1-based page number.

limitinteger

Items per page.

state'all' | 'received' | 'parsing' | 'parsed' | 'drafted' | 'awaiting_approval' | 'approved' | 'cancelled' | 'expired' | 'needs_info' | 'rejected' | 'failed'

Restrict the page to one state of the inbound lifecycle. Defaults to all.

Response

One page of inbound requests.

Example response

{
  "data": [
    {
      "id": "Ib5qT8nW3vK7xR2mB9sYd",
      "state": "awaiting_approval",
      "error": null,
      "intent": {
        "signers": [
          {
            "name": "Dana Reyes",
            "email": "dana@acme.test",
            "order": 1
          }
        ],
        "signingOrder": "sequential",
        "subject": "Master Services Agreement",
        "message": null,
        "expiresInDays": 30,
        "attachmentIndex": 0,
        "notes": null
      },
      "missingInformation": [],
      "attachments": [
        {
          "filename": "msa.pdf",
          "contentType": "application/pdf",
          "size": 184213,
          "status": "stored",
          "refusedReason": null
        }
      ],
      "document": {
        "id": "Ku7bV2xQpL9mNr4sT1yZa"
      },
      "envelope": {
        "id": "Jd3kR8sVqW2nX5cY7bLmP"
      },
      "clarificationRoundTrips": 0,
      "createdAt": "2026-08-21T08:55:00.000Z",
      "updatedAt": "2026-08-21T08:56:12.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.