Agent Number

POST /demo

Simulated end-to-end flow (no payment, no real number)

Description

Returns canned responses matching the **exact field shapes** of `/subscribe`, `/sms/send`, and `/sms/receive`. Use it to scaffold and test your integration before subscribing — if your code parses the demo response correctly, it will parse the real one. Free, no auth required, no DB writes.

Authentication

None. Public endpoint, no auth required.

Code samples

Pick your runtime. Every sample is in the page source — switching tabs is for your eyes.

curl https://agentnumber.really.com/demo \
  --request POST

Responses

200 Simulated subscribe + send + receive flow.

{
  "demo": true,
  "simulated_subscribe": {
    "token": "demo-token-not-real",
    "number": "+15550000000",
    "expires_at": "2027-04-30T18:24:01.000Z",
    "renewed": false
  },
  "simulated_send": {
    "message_id": "demo_msg_001",
    "status": "queued"
  },
  "simulated_receive": {
    "messages": [
      {
        "id": 1,
        "from_number": "+15555550199",
        "to_number": "+15550000000",
        "body": "123456",
        "message_id": "demo_inbound_001",
        "created_at": "2026-04-30T18:24:01.000Z"
      }
    ],
    "count": 1
  },
  "note": "This is a simulated demo. Every field shape matches the real endpoints — use it to scaffold your integration, then subscribe for a real persistent number."
}