Open a support ticket

One ticket covers one problem. It costs $5.00 USDC, paid with x402 on Base. We do this because the main inbox gets a lot of spam and flooding. A paid ticket keeps your request out of it and makes sure a person reads it. A person replies by email within 5 business days.

Tickets are opened through the API by an agent or code using an x402-capable client.

The reply is an answer from the person who runs the directory, not a guarantee that the problem can be solved. If the problem turns out to be an error on our side, we refund the ticket by hand to the wallet that paid. Otherwise the fee is not refunded.

Privacy requests and security reports are never behind a payment: email info@x402-list.com. Delisting requests and data corrections also go by email, at no cost. Contact · Pricing

POST /api/v1/tickets

Request body (JSON; all fields are required)

Example request without payment

curl -X POST https://x402-list.com/api/v1/tickets \
  -H "Content-Type: application/json" \
  -d '{
    "email": "agent@example.com",
    "service": "Example API",
    "problem": "The listed endpoint returns an unexpected error."
  }'

Payment required (HTTP 402)

Without a PAYMENT-SIGNATURE header, the request returns HTTP 402 with a PAYMENT-REQUIRED header and a single accepts[] option for $5.00 USDC on Base. Have your agent or code sign that payment and retry the same request with PAYMENT-SIGNATURE.

When the payment layer is not configured, the endpoint returns HTTP 503 instead.

{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "asset": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "amount": "5000000",
      "payTo": "0x0000000000000000000000000000000000000000",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ],
  "resource": {
    "url": "https://x402-list.com/api/v1/tickets",
    "description": "Support ticket fee for x402 List: one problem, a reply by email within 5 business days",
    "mimeType": "application/json",
    "serviceName": "x402 List"
  },
  "error": "support_ticket_fee_required",
  "message": "Opening a support ticket on x402 List requires a $5.00 USDC x402 payment on Base. Pay with an x402-capable client: send the same request again with a PAYMENT-SIGNATURE header. A person replies by email within 5 business days. See https://x402-list.com/api for the flow."
}

Ticket opened (HTTP 201)

The response returns your ticket number and a PAYMENT-RESPONSE settlement receipt header. A confirmation with the ticket number goes to the email in the request. Keep the reference and quote it in any message about this ticket.

{
  "data": {
    "number": 371,
    "reference": "Ticket #371",
    "status": "open",
    "reply_within": "5 business days"
  },
  "provenance": {
    "license": "CC-BY-4.0",
    "attribution_required": true,
    "attribution": "Data: x402-list.com (CC BY 4.0)",
    "cite_as": "https://x402-list.com/api/v1/tickets",
    "source": "https://x402-list.com"
  }
}

Full API documentation, including payment retries and errors