numbers.verified.start

Start verifying a number.

Reference

POST/api/v1/verified-numbers/start

Auth: API key in X-API-Key
Content: application/json
Returns: 200 · StartResponse

Issue a code and send it. The rate limits live in the service, not here, so the trigger API and any future admin path get them too rather than each route re-implementing them.

Arguments

Argument	In	Type	Required
`phone_number`	body	`string`	required
`label`	body	`string`	optional
`language`	body	`string`	optional

Example request

curl -X POST "https://api.decibyl.ai/api/v1/verified-numbers/start" \
  -H "X-API-Key: dcb_your_key" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"string","label":"string","language":"string"}'

Response

{
  "phone_number": "string",
  "expires_in_seconds": 1,
  "channel": "string",
  "language": "string"
}

Errors

Status	When
`404`	Not found
`422`	Validation Error