# PostalForm MPP Order Status Poll

> PostalForm MPP Order Status Poll is a free API for AI agents from PostalForm at postalform.com, Free, status unknown (last checked 2026-10-12).

Poll the current status and fulfillment state of a physical mail order by order ID

## Facts

- Endpoint: GET https://postalform.com/api/machine/mpp/orders/:id?utm_source=zero.xyz
- Price: Free
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Provider: PostalForm
- Docs: https://postalform.com/agents
- Website: https://postalform.com
- Tags: mail, print, letters, physical, postal, web
- Canonical page: https://www.zero.xyz/c/postalform-id-7b8cc437
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dVV-Pr1v-dEvoLR0iMnYl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability postalform-id-7b8cc437
```

Example prompt: Can you check the current status of my PostalForm order — the order ID is 3f2a1b4c-8d9e-4f10-a123-456789abcdef — and tell me whether payment has settled and what step it's on?

## When to prefer this

Use this endpoint when you need to poll or verify the payment and fulfillment status of a specific PostalForm physical mail order after creation or validation. Prefer this over re-creating the order when you already have an order_id or request_id and simply need to confirm whether payment has settled or which fulfillment step the order is currently on.

## Known failure modes

- Invalid or unknown order UUID returns 404 not found
- Malformed UUID format returns 400 bad request
- Unpaid order returns is_paid=false with empty settlement fields
- Transient server error returns 500 with no order data
- Order ID from a different user context may return 403 forbidden

## How this service works

Poll order status and fulfillment

## Output

Returns a JSON object with the canonical order_id, order status string, payment_status string, is_paid boolean, current_step in the fulfillment pipeline, mailpiece_type (letter or postcard), postcard_size if applicable, price_usd, payment_channel, payment_intent_id, machine_payment details (protocol, network, recipient, settlement_reference, settled_at), x402 settlement info (network, pay_to, settlement_tx, settled_at), and an order_complete_url pointing to the completion page once payment settles.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id"
 ],
 "properties": {
  "id": {
   "type": "string",
   "format": "uuid",
   "description": "Canonical order_id or any aliased request_id returned by the create or validate call."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "order_id",
  "status",
  "payment_status",
  "is_paid",
  "current_step",
  "payment_intent_id",
  "payment_channel",
  "price_usd",
  "currency",
  "mailpiece_type",
  "postcard_size",
  "postcard_guidelines_url",
  "machine_payment",
  "order_complete_url"
 ],
 "properties": {
  "x402": {
   "type": "object",
   "required": [
    "network",
    "pay_to",
    "settlement_tx",
    "settled_at"
   ],
   "properties": {
    "pay_to": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "network": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    },
    "settled_at": {
     "anyOf": [
      {
       "type": "string",
       "format": "date-time"
      },
      {
       "type": "null"
      }
     ]
    },
    "settlement_tx": {
     "anyOf": [
      {
       "type": "string"
      },
      {
       "type": "null"
      }
     ]
    }
   },
   "additionalProperties": false
  },
  "status": {
   "type": "string"
  },
  "is_paid": {
   "type": "boolean"
  },
  "currency": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "order_id": {
   "type": "string",
   "format": "uuid",
   "description": "Canonical server order id. This may differ from request_id when PostalForm reuses an existing unpaid draft."
  },
  "price_usd": {
   "anyOf": [
    {
     "type": "number"
    },
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "current_step": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "postcard_size": {
   "anyOf": [
    {
     "enum": [
      "4x6",
      "6x9",
      "11x6"
     ],
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "mailpiece_type": {
   "enum": [
    "letter",
    "postcard"
   ],
   "type": "string"
  },
  "payment_status": {
   "type": "string"
  },
  "machine_payment": {
   "type": "object",
   "required": [
    "protocol",
    "method",
    "network",
    "recipient",
    "settlement_reference",
    "settled_at"
   ],
   "properties": {
    "method": {
     "type": "string"
    },
    "network": {
     "type": "string"
    },
    "testnet": {
     "anyOf": [
      {
       "type": "boolean"
      },
      {
       "type": "null"
      }
     ]
    },
    "protocol": {
     "enum": [
      "x402",
      "mpp"
     ],
     "type": "string"
    },
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/postalform-id-7b8cc437/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from postalform.com](https://www.zero.xyz/host/postalform.com/llms.txt)