Demo Numbers
Demo Numbers

Reserve Number

Reserve a demo number for 15 minutes.

Atomic flow:

  1. Verify eligibility (one-per-lifetime)
  2. Lock a pool row with SELECT ... FOR UPDATE SKIP LOCKED
  3. Insert demo_reservations row
  4. Mark pool row as 'reserved'
  5. Insert phone_numbers row pointing to user+agent
  6. All inside a transaction — rollback on any failure
post/v1/demo/reserve

Request

  • Base URL: https://api.call2me.app
  • URL: https://api.call2me.app/v1/demo/reserve
  • Auth: HTTP bearer

Request body

agent_idstring nullable

Agent to bind the number to. If omitted, user can bind later.

Response

Successful Response

reservation_idstring required
phone_numberstring required
country_codestring required
display_namestring required
agent_idstring nullable required
reserved_atstring date-time required
expires_atstring date-time required
minutes_remaininginteger required

Changes

No recorded changes to this operation across all 1 revision of this API.