hail.sodocs
GET
/v1/verifications/{verification_id}

Path Parameters

verification_id*Verification Id
Formatuuid

Header Parameters

authorization?string|null

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/verifications/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "provider": "string",  "country_code": "string",  "number_type": "string",  "subject_type": "string",  "state": "string",  "rejection_reason": "string",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "submitted_at": "2019-08-24T14:15:22Z",  "approved_at": "2019-08-24T14:15:22Z"}

Get Requirements

What the carrier needs from you to buy this kind of number: the fields, the documents, and whether an address is needed. Build your form from it.

Get Whoami

Identify the caller: auth kind, organization, and (if resolvable) user. Useful for an agent that needs the human's address to put in Reply-To, since the bearer token itself only carries an organization. user_id/email/name come back null for a shared-key (HAIL_API_KEY) call, which has no individual user behind it.