Skip to main content
GET
/
v1
/
x402
/
endpoints
/
{id}
/
requirements
Get requirements by ID
curl --request GET \
  --url https://api.swiftpay.finance/v1/x402/endpoints/{id}/requirements \
  --header 'X-Swift-Key: <api-key>'
{
  "success": true,
  "data": {
    "x402Version": 2,
    "requirements": {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "100000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0xForwarderAddress...",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "USDC",
        "version": "2",
        "merchantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "endpointId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "description": "Sentiment analysis — $0.10 per call"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.swiftpay.finance/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Swift-Key
string
header
required

Your secret API key (sk_live_*). Keep this server-side only.

Path Parameters

​
id
string<uuid>
required

Endpoint ID (UUID)

Response

Payment requirements for the endpoint

​
success
enum<boolean>
Available options:
true
​
data
object

Envelope returned by both requirements endpoints. Clients use x402Version when constructing the 402 body and the settle request — no hardcoding required.