{
  "generated_at": "2026-05-11T00:56:48.476130+00:00",
  "slug": "postalform-com-api-machine-orders",
  "title": "Postalform \u00b7 Machine Orders",
  "url": "https://postalform.com/api/machine/orders",
  "category": "data",
  "summary": "Postalform \u00b7 Machine Orders \u2014 x402-protected data API. Pay $3.40 per call on base. Indexed by x402all.",
  "seo": {
    "title": "Postalform \u00b7 Machine Orders \u2014 x402 data API \u00b7 $3.40 per call",
    "description": "Postalform \u00b7 Machine Orders \u2014 x402-protected data API. Pay $3.40 per call on base. Indexed by x402all."
  },
  "use_cases": [],
  "risk_notes": [],
  "pricing_sanity": {
    "flag": "expensive_outlier",
    "ratio": 170.0,
    "median_category_atomic": 20000
  },
  "pricing_review_required": false,
  "pricing_decimal_suspect": false,
  "trust_tier": "indexed_external",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "pay_to": "0xa47c51fa156bbf18eb7474e62ee77d1e824bf911",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "max_amount_required_atomic": "3400000",
      "max_timeout_seconds": 300,
      "verified": false,
      "hints": {
        "input": {
          "type": "http",
          "method": "POST",
          "bodyFields": {
            "pdf": {
              "required": true
            },
            "color": {
              "type": "boolean",
              "description": "Defaults to false."
            },
            "certified": {
              "type": "boolean",
              "description": "Certified Mail add-on. Defaults to false."
            },
            "file_name": {
              "type": "string",
              "description": "Optional display file name."
            },
            "buyer_name": {
              "type": "string",
              "required": true,
              "description": "Buyer / wallet owner display name."
            },
            "mail_class": {
              "enum": [
                "standard",
                "priority",
                "express"
              ],
              "type": "string",
              "description": "Mail service level. Defaults to standard."
            },
            "request_id": {
              "type": "string",
              "required": true,
              "description": "Client-generated idempotency key for one logical mailing. Reuse the same value on payment retries, and generate a fresh UUID for a legitimate second order even if the payload is identical."
            },
            "buyer_email": {
              "type": "string",
              "required": true,
              "description": "Required for Stripe receipt delivery."
            },
            "sender_name": {
              "type": "string",
              "required": true
            },
            "double_sided": {
              "type": "boolean",
              "description": "Defaults to true."
            },
            "postcard_size": {
              "enum": [
                "4x6",
                "6x9",
                "11x6"
              ],
              "type": "string",
              "description": "Required when mailpiece_type is postcard. The uploaded PDF must match the exact 2-page bleed template for that size. See /postcard-pdf-guidelines."
            },
            "mailpiece_type": {
              "enum": [
                "letter",
                "postcard"
              ],
              "type": "string",
              "description": "Optional mailpiece type. Defaults to letter. Set to postcard when pdf is a fully composed postcard PDF that follows the published postcard layout guide."
            },
            "recipient_name": {
              "type": "string",
              "required": true
            },
            "sender_address_id": {
              "type": "string",
              "description": "Loqate US Address id. Required for sender Address mode."
            },
            "sender_address_text": {
              "type": "string",
              "description": "Human-readable address text for sender Address mode."
            },
            "sender_address_type": {
              "enum": [
                "Address",
                "Manual"
              ],
              "type": "string",
              "description": "Address strategy for the sender. Omit to default to Address when manual fields are absent."
            },
            "recipient_address_id": {
              "type": "string",
              "description": "Loqate US Address id. Required for recipient Address mode."
            },
            "sender_address_manual": {
              "type": "object",
              "properties": {
                "zip": {
                  "type": "string",
                  "description": "US ZIP or ZIP+4."
                },
                "city": {
                  "type": "string",
                  "description": "US city."
                },
                "line1": {
                  "type": "string",
                  "description": "Street address line 1."
                },
                "line2": {
                  "type": "string",
                  "description": "Optional unit, suite, or secondary line."
                },
                "state": {
                  "type": "string",
                  "description": "Two-letter US state code."
                }
              },
              "description": "Manual sender address. Required for sender Manual mode."
            },
            "recipient_address_text": {
              "type": "string",
              "description": "Human-readable address text for recipient Address mode."
            },
            "recipient_address_type": {
              "enum": [
                "Address",
                "Manual"
              ],
              "type": "string",
              "description": "Address strategy for the recipient. Omit to default to Address when manual fields are absent."
            },
            "recipient_address_manual": {
              "type": "object",
              "properties": {
                "zip": {
                  "type": "string",
                  "description": "US ZIP or ZIP+4."
                },
                "city": {
                  "type": "string",
                  "description": "US city."
                },
                "line1": {
                  "type": "string",
                  "description": "Street address line 1."
                },
                "line2": {
                  "type": "string",
                  "description": "Optional unit, suite, or secondary line."
                },
                "state": {
                  "type": "string",
                  "description": "Two-letter US state code."
                }
              },
              "description": "Manual recipient address. Required for recipient Manual mode."
            }
          }
        },
        "output": {
          "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"
          ],
          "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"
                },
                "recipient": {
                  "type": "string"
                },
                "settled_at": {
                  "anyOf": [
                    {
                      "type": "string",
                      "format": "date-time"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "settlement_reference": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "additionalProperties": true
            },
            "payment_channel": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "payment_intent_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "postcard_guidelines_url": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uri"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Canonical postcard PDF formatting guide. Present for postcard responses and null for letter responses."
            }
          },
          "additionalProperties": true
        }
      }
    }
  ],
  "origin": {
    "slug": "postalform-com",
    "host": "postalform.com",
    "url": "https://postalform.com",
    "favicon": "https://postalform.com/favicon.ico"
  },
  "json_ld": {
    "@id": "https://x402all.com/resource/postalform-com-api-machine-orders",
    "url": "https://x402all.com/resource/postalform-com-api-machine-orders",
    "name": "Postalform \u00b7 Machine Orders",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/postalform-com-api-machine-orders",
      "@type": "Offer",
      "price": "3.4",
      "availability": "https://schema.org/InStock",
      "priceCurrency": "USDC",
      "additionalProperty": [
        {
          "name": "paymentNetwork",
          "@type": "PropertyValue",
          "value": "base"
        },
        {
          "name": "paymentAsset",
          "@type": "PropertyValue",
          "value": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ],
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "price": "3.400000",
        "unitText": "call",
        "priceCurrency": "USDC"
      },
      "eligibleCustomerType": "Agent"
    },
    "sameAs": "https://postalform.com/api/machine/orders",
    "@context": "https://schema.org",
    "provider": {
      "@id": "https://x402all.com/server/postalform-com",
      "url": "https://postalform.com",
      "name": "postalform.com",
      "@type": "Organization"
    },
    "identifier": "postalform-com-api-machine-orders",
    "description": "Postalform \u00b7 Machine Orders \u2014 x402-protected data API. Pay $3.40 per call on base. Indexed by x402all.",
    "potentialAction": {
      "@type": "BuyAction",
      "target": "https://axon402.com/test-buy?resource=postalform-com-api-machine-orders",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "data"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=postalform-com-api-machine-orders",
  "callability": {
    "status": "unknown",
    "schema_callability": 0.186,
    "source": "provider_well_known",
    "source_confidence": 0.95,
    "match_confidence": 0.4,
    "schema_confidence": 0.0,
    "validated_at": "2026-05-10T23:16:18.010136+00:00",
    "warnings": []
  },
  "contract": {
    "route_template": "https://postalform.com/api/machine/orders",
    "examples": [],
    "schema_presence": {
      "path_schema": "unknown",
      "query_schema": "unknown",
      "header_schema": "unknown",
      "request_body_schema": "unknown",
      "response_schema": "unknown"
    },
    "contract_hash": "2e7cf8e7ad19cb161781da839b2d68835eed326e3dfb3518ec7793ff5aeb9fbe"
  }
}