For developers

One token. Predictable paths.

Bearer auth, one response envelope across every product, and a sandbox that returns the same shapes as production. Copy a request, swap the key, ship.

Get an API key Full documentation

Endpoints

Bearer token

Identical environments

curl "https://stargate.infobelpro.com/vatsearch/v1/verify?vat_number=BE0453834657" \
  -H "Authorization: Bearer ifp_live_your_key"

Response

{
  "data": {
    "country": "BE",
    "vat": "BE0453834657",
    "valid": true,
    "company": {
      "name": "ACME EUROPE SA",
      "registration_number": "0453834657",
      "address": {
        "street": "Rue de l'Industrie 12",
        "postal_code": "1000",
        "city": "Bruxelles",
        "country": "BE"
      }
    }
  },
  "request_id": "b3f1c2a8-..."
}

X-Stargate-Credits-Used: 1

Playground

Try a lookup without a key

These responses come from local fixtures, so you can see the exact shape before you sign up. No key, no credits.

Try a lookup

Or try one of these

Runs against local fixtures — no key needed and no credits spent.

GET /vatsearch/v1/verifyIdle

// Run a lookup to see a response.

Reference

Every endpoint, and what it costs

Credits are drawn per billable response. Failed calls and no-match responses are never charged.

VAT Search 2 endpoints

GET /vatsearch/v1/search

Find VAT numbers and registered details from a company name.

1 credit

GET /vatsearch/v1/verify

Validate a known VAT number against the registered record.

1 credit

Firmographics Data 1 endpoint

POST /firmographics/v1/search

Search company and POI records with a unified filter model.

1 credit

Company Financials 2 endpoints

POST /financials/v1/search

Search companies and return latest financial figures.

2 credits

GET /financials/v1/company/{id}/{section}

Fetch a detailed section (finance, ratio, ownership, …) for one company.

1 credit

Limits & errors

Two limits, clearly signalled

429

Burst rate limit

Short-window protection per key and product. Returns 429 with a Retry-After header — back off and retry.

402

Credits exhausted

When the prepaid balance reaches zero, billable calls return 402. Top up to continue.

Credit headers on every billable response

X-Stargate-Credits-Used X-Stargate-Credits-Limit X-Stargate-Credits-Remaining

Get a key and start calling

Sandbox access is immediate, and the same code ships to production.