SIMPLE · PREDICTABLE · JSON

Bangladesh lookup
without the noise.

Send a number, receive a structured result. This reference contains the exact request formats, headers, responses, and errors you need to integrate the API.

View request guide ↓

GETQUERY REQUEST

POSTJSON REQUEST

JSONSTRUCTURED RESPONSE

01 · REQUEST

Send a lookup request

Base URL: http://number-lookup.unf.workers.dev

GET

`/lookup?number=0177XXXXXXXXX`

Pass the number as a query parameter. /look is also available with the same behavior.

POST

`/lookup`

Send {"number":"0177XXXXXXXXX"} as a JSON request body.

02 · AUTHENTICATION

Identify your request

Use one of these headers on every lookup request. Keep the key on your server and never expose it in a public client.

Bearer token

Authorization: Bearer YOUR_API_KEY

API key header

X-API-Key: YOUR_API_KEY

03 · EXAMPLES

Ready-to-copy requests

Replace only YOUR_API_KEY and the placeholder number.

curl.sh

curl "http://number-lookup.unf.workers.dev/lookup?number=0177XXXXXXXXX" \
  -H "Authorization: Bearer YOUR_API_KEY"

request.js

const response = await fetch(
  "http://number-lookup.unf.workers.dev/lookup",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-API-Key": "YOUR_API_KEY"
    },
    body: JSON.stringify({ number: "0177XXXXXXXXX" })
  }
);
const data = await response.json();

request.py

import requests

response = requests.get(
    "http://number-lookup.unf.workers.dev/lookup",
    params={"number": "0177XXXXXXXXX"},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())

04 · RESPONSE

Predictable JSON fields

A successful request returns these fields. Values are intentionally omitted from the reference.

nameMatched name or null

numberNormalized number or null

carrierCarrier label or null

locationLocation label or null

typeNumber type or null

response.json

{
  "name": null,
  "number": null,
  "carrier": null,
  "location": null,
  "type": null
}

05 · ERRORS & LIMITS

Handle every response cleanly

Use the HTTP status code first, then read the JSON error message.

Error format

{
  "success": false,
  "error": "..."
}

Common status codes

400 Invalid number or body
401 Missing or invalid API key
403 Revoked API key
429 Request limit reached
502/504 Lookup service unavailable

Rate-limit headers: x-ratelimit-limit, x-ratelimit-remaining, and x-ratelimit-reset. Use GET /health to check service availability.

TELEGRAM COMMUNITY

Stay connected with Infinity

Follow updates, API resources, and new releases from the official channels.

✈ @infinity_codex ✈ @FFxAPI

Bangladesh lookupwithout the noise.