API Documentation

Quick start

Make your first request in seconds. All you need is an API key.

curl -H "X-API-Key: b2t_your_key" \
  "https://b2trust.com/api/v1/search?q=CD+Projekt"

Authentication

Authenticate every request by including your API key in the X-API-Key header.

X-API-Key: b2t_your_key

API keys are prefixed with b2t_. Keep your key secret and never expose it in client-side code.

Endpoints

curl -H "X-API-Key: b2t_your_key" \
  "https://b2trust.com/api/v1/company/PL-7342867148"

curl -X POST \
  -H "X-API-Key: b2t_your_key" \
  -H "Content-Type: application/json" \
  -d '{"account": "PL61109010140000071219812874"}' \
  "https://b2trust.com/api/v1/company/PL-7342867148/verify-bank"

{
  "status": "ok",
  "data": {
    "verified": true,
    "company_name": "CD PROJEKT S.A.",
    "account_count": 2,
    "checked_at": "2026-06-30T15:00:00.000Z"
  }
}

Response schema

All responses follow a consistent envelope format. /search returns an array; /company/{id} returns a single object.

Search response

{
  "status": "ok",
  "query": "CD Projekt",
  "mode": "name",
  "data": [
    {
      "country_code": "PL",
      "national_id": "7342867148",
      "registry_number": "0000317499",
      "company_name": "CD Projekt S.A.",
      "legal_form": "Spółka Akcyjna",
      "status": "active",
      "registered_address": {
        "street": "ul. Jagiellońska 74",
        "city": "Warszawa",
        "postal_code": "03-301",
        "country": "PL"
      },
      "registration_date": "2002-02-01",
      "registry_count": 3,
      "vat_number": "PL7342867148",
      "fetched_at": "2026-04-30T00:23:02.602Z",
      "confidence": {
        "score": 92,
        "label": "High",
        "color": "green",
        "factors": ["Exact name match", "Verified by 3 registries"]
      },
      "first_indexed_at": "2025-11-10T08:14:00.000Z",
      "vies_status": "valid",
      "vies_note": null
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "limit": 50,
    "total_pages": 1,
    "query_time_ms": 412,
    "cache_hit": true,
    "countries": ["PL"],
    "country_counts": { "PL": 1 },
    "legal_forms": ["Spółka Akcyjna"]
  }
}

Company response

The profile returns company identity plus B2Trust Identity Consensus metadata — how many independent sources confirm the entity (registry_count, source_breakdown by type, confirmation_count), EU VAT cross-check, and time-in-index. We expose how many sources confirm a record, never which registries. Natural-person data (directors, beneficial owners, shareholders) and raw bank account numbers are not exposed.

{
  "status": "ok",
  "data": {
    "country_code": "PL",
    "national_id": "7342867148",
    "vat_number": "PL7342867148",
    "secondary_id": "0000317499",
    "registry_number": "0000317499",
    "company_name": "CD Projekt S.A.",
    "legal_form": "Spółka Akcyjna",
    "registered_address": {
      "street": "ul. Jagiellońska 74",
      "city": "Warszawa",
      "postal_code": "03-301",
      "country": "PL"
    },
    "registration_date": "2002-02-01",
    "status": "active",
    "activity_codes": [
      { "code": "62.01.Z", "system": "PKD", "description": "Software development" }
    ],
    "registry_count": 3,
    "bank_accounts_count": 2,
    "verified_at": "2026-04-30T00:23:02.602Z",
    "first_indexed_at": "2025-11-10T08:14:00.000Z",
    "vies_cross_check_status": "valid_match",
    "vies_name": "CD PROJEKT SPÓŁKA AKCYJNA",
    "vies_match_score": 0.94,
    "vies_checked_at": "2026-04-30T00:23:01.000Z",
    "vies_vat_id": "PL7342867148",
    "confirmation_count": 5,
    "source_breakdown": { "registry": 3, "search": 1, "node_scan": 0, "opc": 0, "bulk_import": 1 },
    "first_seen": "2025-11-10T08:14:00.000Z",
    "last_confirmed": "2026-04-30T00:23:02.602Z"
  },
  "meta": {
    "cached": true,
    "enriched": false,
    "source_count": 3,
    "fetched_at": "2026-04-30T00:23:02.602Z",
    "expires_at": "2026-05-07T00:23:02.602Z"
  }
}

Notes on meta.country_counts

When country= is supplied, country_counts reflects only the filtered country (post-filter counts). Without country=, it reports counts across every country present in the result set. meta.countries follows the same source — it is always Object.keys(country_counts).

Rate limits

Limits are enforced per API key. Exceeding either limit returns a 429 status with a Retry-After header. Higher tiers are issued on request — contact contact@b2trust.com.

Error codes

Code examples

Python

import requests

response = requests.get(
    "https://b2trust.com/api/v1/search",
    params={"q": "CD Projekt"},
    headers={"X-API-Key": "b2t_your_key"}
)

data = response.json()
for company in data["data"]:
    print(company["company_name"], company["country_code"])

JavaScript

const response = await fetch(
  "https://b2trust.com/api/v1/search?q=CD+Projekt",
  {
    headers: { "X-API-Key": "b2t_your_key" }
  }
);

const { data } = await response.json();
data.forEach(company => {
  console.log(company.company_name, company.country_code);
});

curl

curl -H "X-API-Key: b2t_your_key" \
  "https://b2trust.com/api/v1/search?q=CD+Projekt&country=PL&limit=5"