Api Endpoint

Orthogonal

Buy a US or CA phone number

Open interactive test console

Offering

Provider
Orthogonal
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Infrastructure
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://np.orthogonal.com/agentphone/v1/numbers
MIME type
application/json
First seen
2026-10-16T01:50:03.832Z
Last seen
Tags
X402, paid-api, orthogonal-proxy, agentphone, data-apis, voice, phone, sms, AI-agents, telephony

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
3.5 USDC
Atomic price: 3500000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
3500000 atomic units
Atomic price: 3500000 · Network: eip155:5042 · Asset: 0x3600000000000000000000000000000000000000 · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "3500000",
    "payTo": "0x0477aeC8513F73adfe6E3C813650b25a28Cba54A"
  },
  {
    "scheme": "exact",
    "network": "eip155:5042",
    "asset": "0x3600000000000000000000000000000000000000",
    "amount": "3500000",
    "payTo": "0x0477aeC8513F73adfe6E3C813650b25a28Cba54A"
  }
]

Observed health

Status
Healthy
Latest latency
74 ms
Average latency
632 ms
HTTP status
204
Last checked
Reachability
100% over 9 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "body": {
    "type": "object",
    "title": "CreateNumberRequest",
    "properties": {
      "type": {
        "anyOf": [
          {
            "enum": [
              "sms",
              "imessage"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Type"
      },
      "agentId": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Agentid"
      },
      "country": {
        "type": "string",
        "title": "Country",
        "default": "US"
      },
      "areaCode": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Areacode"
      },
      "externalId": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Externalid"
      },
      "imessageType": {
        "anyOf": [
          {
            "enum": [
              "inbound",
              "outbound"
            ],
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "Imessagetype"
      }
    }
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
}

Output schema

{
  "type": "object",
  "title": "PhoneNumberResponse",
  "required": [
    "id",
    "phoneNumber",
    "country",
    "status",
    "createdAt"
  ],
  "properties": {
    "id": {
      "type": "string",
      "title": "Id"
    },
    "type": {
      "type": "string",
      "title": "Type",
      "default": "sms"
    },
    "status": {
      "type": "string",
      "title": "Status"
    },
    "agentId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Agentid"
    },
    "country": {
      "type": "string",
      "title": "Country"
    },
    "createdAt": {
      "type": "string",
      "title": "Createdat",
      "format": "date-time"
    },
    "externalId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Externalid"
    },
    "outboundSms": {
      "enum": [
        "enabled",
        "activating",
        "registration_required"
      ],
      "type": "string",
      "title": "Outboundsms",
      "default": "enabled"
    },
    "phoneNumber": {
      "type": "string",
      "title": "Phonenumber"
    },
    "purchasedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Purchasedat"
    },
    "whatsappEnabled": {
      "type": "boolean",
      "title": "Whatsappenabled",
      "default": false
    },
    "dailyNewContacts": {
      "anyOf": [
        {
          "type": "object",
          "title": "DailyNewContactsUsage",
          "required": [
            "used"
          ],
          "properties": {
            "used": {
              "type": "integer",
              "title": "Used"
            },
            "limit": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Limit"
            }
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "inboundCallsEnabled": {
      "type": "boolean",
      "title": "Inboundcallsenabled",
      "default": true
    },
    "readReceiptsEnabled": {
      "type": "boolean",
      "title": "Readreceiptsenabled",
      "default": true
    }
  }
}