List business verifications

GEThttps://api.norreach.app/v1/number-verifications

The workspace's business verifications for buying numbers in countries that ask for documents: country, number type, status (draft, submitted, approved, declined, expired), why it was declined, and what was sent — labels and file names only, never the values or the files. Pending ones are checked again while you read.

numbers:readOperation id: list_number_verifications

GET/number-verifications

curl -X GET "https://api.norreach.app/v1/number-verifications" \
  -H "Authorization: Bearer $NORREACH_API_KEY"

List business verifications

{
  "object": "list",
  "data": [
    {
      "id": "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d1e",
      "object": "number_verification",
      "country": "SE",
      "number_type": "local",
      "status": "submitted",
      "decline_reason": null,
      "submitted_at": "2026-11-05T09:00:00.000Z",
      "decided_at": null,
      "checked_at": "2026-11-05T09:00:00.000Z",
      "created_at": "2026-11-05T08:59:58.000Z",
      "fields": [
        {
          "label": "Company registration number",
          "kind": "text"
        },
        {
          "label": "Address matching the DID area code",
          "kind": "address"
        },
        {
          "label": "Proof of address",
          "kind": "document"
        }
      ],
      "documents": [
        {
          "label": "Proof of address",
          "file_name": "utility-bill.pdf",
          "size": 182311,
          "content_type": "application/pdf"
        }
      ]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Authorizations

Authorizationstringheaderrequired

Bearer authentication: send Authorization: Bearer <key>, with an API key or an OAuth access token. The key needs the scope numbers:read. API keys and scopes

Response

200application/json— List business verifications

object"list"required

dataobject[]required

Show child attributes

data[].idstring (uuid)required

An id (UUID).

data[].object"number_verification"required

data[].countrystringrequired

data[].number_typeenumrequired

One of:localmobiletoll_freenationalshared_cost

data[].statusenumrequired

One of:draftsubmittedapproveddeclinedexpired

data[].decline_reasonstring | nullrequired

data[].submitted_atstring | nullrequired

data[].decided_atstring | nullrequired

data[].checked_atstring | nullrequired

data[].created_atstring | nullrequired

data[].fieldsobject[]required

Show child attributes

data[].fields[].labelstringrequired

data[].fields[].kindstringrequired

data[].documentsobject[]required

Show child attributes

data[].documents[].labelstringrequired

data[].documents[].file_namestringrequired

data[].documents[].sizeintegerrequired

data[].documents[].content_typestringrequired

has_morebooleanrequired

next_cursorstring | nullrequired

Errors

Errors are application/problem+json with a stable code.

Status	Code	Meaning
400	`bad_request`	The request couldn't be read.
400	`unknown_field`	The request has a field this operation doesn't know.
401	`unauthorized`	A valid API key is required.
403	`insufficient_scope`	This API key doesn't have the scope this operation needs.
403	`feature_not_enabled`	The API isn't switched on for this workspace.
429	`rate_limited`	Too many requests. Slow down and try again.
500	`server_error`	Something went wrong on our side.
503	`unavailable`	The API isn't available right now. Try again shortly.

GET/number-verifications

curl -X GET "https://api.norreach.app/v1/number-verifications" \
  -H "Authorization: Bearer $NORREACH_API_KEY"

List business verifications

{
  "object": "list",
  "data": [
    {
      "id": "8b9c0d1e-2f3a-4b4c-9d5e-6f7a8b9c0d1e",
      "object": "number_verification",
      "country": "SE",
      "number_type": "local",
      "status": "submitted",
      "decline_reason": null,
      "submitted_at": "2026-11-05T09:00:00.000Z",
      "decided_at": null,
      "checked_at": "2026-11-05T09:00:00.000Z",
      "created_at": "2026-11-05T08:59:58.000Z",
      "fields": [
        {
          "label": "Company registration number",
          "kind": "text"
        },
        {
          "label": "Address matching the DID area code",
          "kind": "address"
        },
        {
          "label": "Proof of address",
          "kind": "document"
        }
      ],
      "documents": [
        {
          "label": "Proof of address",
          "file_name": "utility-bill.pdf",
          "size": 182311,
          "content_type": "application/pdf"
        }
      ]
    }
  ],
  "has_more": false,
  "next_cursor": null
}