GET/api/v6/numberinsight/{number}

Single number lookup

Country, line type, current carrier and area of a phone number.

Scope

Any valid API key

Usage limit

60 requests per minute

Idempotency

Supports Idempotency-Key

Resolves a phone number: country, line type, carrier (porting-aware in Colombia), area and, for Colombia, the routing NRN.

The response shape is identical for Colombia and international numbers: fields that do not apply come back as null, so your client needs a single parsing branch.

Path parameters

number

stringrequired

Number in E.164 (+5491123456789), E.164 without + (5491123456789) or Colombian national format (10 digits).

Headers

Idempotency-Key

stringoptional

Optional idempotency key (1 to 255 characters from A-Za-z0-9_-). Repeating the same operation with the same key returns the original response without running it again. See the idempotency guide.

Responses

200

Number resolved. Non-applicable fields come back null.

{
  "success": true,
  "data": {
    "phoneNumber": {
      "e164": "+573001234567",
      "national": "3001234567",
      "raw": "3001234567"
    },
    "valid": true,
    "country": { "iso2": "CO", "callingCode": "57", "name": "Colombia", "mcc": "732" },
    "lineType": "mobile",
    "numberType": "mobile",
    "ported": true,
    "operator": { "name": "Tigo", "brand": "Tigo", "mnc": "103", "nrn": "103" },
    "area": null,
    "timezone": null,
    "portability": {
      "donorOperator": { "name": "Claro", "brand": "Claro" },
      "initialOperator": { "name": "Claro", "brand": "Claro" },
      "activatedAt": "2024-08-12",
      "processedAt": "2024-08-11T14:32:00Z",
      "sourceDate": "2024-08-11"
    },
    "zone": { "id": "103", "name": "Tigo" }
  },
  "meta": {
    "requestId": "8f0c0e2a4b1d4c8fae2b7a91e0c5d3f6",
    "timestamp": "2026-06-18T09:00:00+00:00",
    "responseTimeMs": 2.1
  }
}

400

Invalid idempotency key.

401

Invalid or missing credentials.

403

The account cannot run this lookup.

409

A request with the same idempotency key is still in progress.

422

The idempotency key was reused with a different body.

429

Request limit exceeded.

503

The lookup service is refreshing. Retry in a few seconds.

Possible errors

Codes this endpoint can return in error.code. The full detail lives in the catalog.

401AUTH_REQUIREDNo Bearer token was sent, and every call requires one.401AUTH_INVALID_KEYThe API key is not recognized: wrong format, revoked or expired.403ACCOUNT_NOT_ACTIVEYour organization is suspended or closed.403ACCOUNT_BLOCKEDA full block is active: every call is rejected.400IDEMPOTENCY_KEY_INVALIDThe idempotency key does not match the format.409IDEMPOTENCY_IN_PROGRESSThe first request with that key is still in progress.422IDEMPOTENCY_KEY_REUSEDThe key already exists, but with a different body.429RATE_TPS_EXCEEDEDYou exceeded your organization quota for this endpoint.503INFRA_CACHE_UNAVAILABLEAn internal component is temporarily unavailable.

See the full catalog

Scope and limits

Path parameters

Headers

Responses

Possible errors