Global Database

Scroll down for code samples, example requests and responses. Select a language for code samples from the tabs above or the mobile navigation menu.

Welcome to the GlobalDatabase API, which provides programmatic access to GlobalDatabase's comprehensive company data. It can be used to enhance a wide variety of business functions, from auto-populating website forms to verifying customer credentials.

Terms and Conditions

Support: Contact

Authentication

The HTTP Authorization request header contains the credentials to authenticate a user agent with a server, usually after the server has responded with a 401 Unauthorized status

Syntax:

Authorization: Token

Example:

Authorization: Token 00000000-0000-0000-0000-000000000000

Authorization: Token your-api-key

Get credentials

Visit GlobalDatabase Profile or contact your account manager

Errors

The API uses conventional Python and HTTP responses for successes or failures of each individual API request.

• TokenVerificationError
  • This error will appear when the introduces token is invalid.
• InvalidRequest
  • This error will appear for any

TokenVerificationError

Response

{
    "detail": "Invalid token"
}

Auth error

InvalidRequest

Response

{
    "field_name": [
        "This field is required."
    ]
}

Validation error

InternalError

Response

{
    "detail": "A server error occurred."
}

Generic api error

LimitError

Response

{
    "access": {
        "permission": "code_permission",
        "permission_name": "Name permission",
        "module": "code_module",
        "module_name": "Name Module",
        "app": "api",
        "app_name": "Api"
    },
    "error_guard": "limits.daily", // or limit
    "message_guard": "You have reached your daily online browsing limit"
}

Limit api error

Release Notes

What changed in the API, newest first. Everything in the latest release is marked across these docs: NEW for a new endpoint or section, UPDATED for an existing one that changed.

October 3, 2026

• KYB API — Ultimate Beneficial Owners: the natural persons who own or control a company, with effective ownership across every route, the threshold you choose, whether the answer is conclusive, and optional enrichment of unresolved chains with external ownership reports.
  • Get UBO — GET /v2/kyb/{id}/ubo
  • Start UBO Enrichment — POST /v2/kyb/{id}/ubo/enrich
  • Get UBO Enrichment Job — GET /v2/kyb/{id}/ubo/enrich/{job_id}

October 2, 2026

• KYP API — Know Your Payee: confirm the payee's bank account, match it to the company in the official register and get a payment decision (OK_TO_PAY, REVIEW_BEFORE_PAYING, DO_NOT_PAY).
  • Run Know Your Payee — POST /v2/know-your-payee
  • Get Know Your Payee Report — GET /v2/know-your-payee/{id}
  • Run from History — POST /v2/know-your-payee/{id}
• Country reference — Bank Verification now covers 9 more countries: Australia, Ethiopia, Ghana, Hong Kong, Kenya, Malaysia, Singapore, Tanzania and Zambia. Bangladesh, Saudi Arabia and Uganda are listed as coming soon.
• Verify Bank Account — proxy identifiers as id_scheme: EMAL (email), MBNO (mobile number), FPSID (FPS ID) and NRIC.
  • holding_entity is now required for every ACNR scheme; a request without it is rejected with 400 instead of failing at the bank.
  • Brazil: the identity type is now NIDN (was TXID). Requests sending TXID are rejected. BRBKBR must be 7–9 characters, and IBAN_BICFI now takes the BIC.
  • United Kingdom: accounts can also be verified by IBAN.
  • China: the ACNR (account number only) scheme is removed; use BICFI_ACNR or CNAPS_ACNR.
  • South Africa: ZANCC must be exactly 6 characters; NIDN is accepted as well as COID.
  • EPC: the scheme takes the IBAN only; no BIC is needed.
• Bank Verification History — each item now says whether a Know Your Payee report was run on it (has_kyp_report).
• MCP Server — connect by signing in with your Global Database account (no API key to paste), now with 24 tools including KYB registry checks, people search and prospecting, and available in the Claude, ChatGPT, Cursor and Zapier directories.

Metrics

You can review how much information you have viewed and received from Global Database as well as check the total limits and how many more credits you have left.

Usage Metrics

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/metrics' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "name": "Executives Company",
        "codename": "executives_company",
        "metrics": [
            {
                "name": "Executives Company",
                "codename": "executives_company",
                "used": 10,
                "total": 100
            }
        ]
    },
    //...
]

GET https://api.globaldatabase.com/v2/metrics

Metrics Permissions

Usage Metrics Contacts

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/metrics/contacts?date_from=2025-03-27 05:30:00&date_to=2025-04-27 05:30:00' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

{
    "email_count": 317,
    "phone_count": 792
}

GET https://api.globaldatabase.com/v2/metrics/contacts

Metrics Permissions Contacts by Date Range

Parameters

Parameter	In	Type	Required	Description
date_from	params	datetime	true	Date From
date_to	params	datetime	true	Date To

Prospecting API

The Prospecting API allows you to browse all companies based on specific parameters and will provide one or more results based on input that can then be further used to derive company details. You can search for companies in a specific location, of a specific size or turnover, or that are part of a particular industry.

Prospecting Companies

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/prospecting' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 1,
    "per_page": 50,
    "filters": {
        "company_status": [
            106
        ],
        "number_of_employees": {
            "gte": 1,
            "lte": 30000
        },
        "legal_form": [
            4024353
        ],
        "location_countries": [
            "1219916_1800795_1814321"
        ]
    }
}'

Request example

{
    "page": 1,
    "per_page": 50,
    "filters": {
        "company_status": [
            106
        ],
        "number_of_employees": {
            "gte": 1,
            "lte": 30000
        },
        "legal_form": [
            4024353
        ],
        "location_countries": [
            "1219916_1800795_1814321"
        ]
    }
}

Success Response

{
    "total_companies": 2594573,
    "total_pages": 200,
    "data": [
        {
            "id": 17784513,
            "name": "FIAT CHRYSLER AUTOMOBILES UK LTD"
        },
        {
            "id": 19844844,
            "name": "BAKKAVOR LIMITED"
        },
        {
        "id": 22084035,
        "name": "ASTRAZENECA UK LIMITED"
        },
        //...
    ]
}

POST https://api.globaldatabase.com/v2/prospecting

Prospecting companies based on search criteria

Parameters

Parameter	In	Type	Required	Description
page	body	int	false	Page number (Maximum page value is 10)
per_page	body	int	false	Number of results per page
filters	body	object	false	Filter criteria json encoded

Fields: filters

Parameter	Type	Required	Description
company_status	array of int	false	Company status, available in nomenclatures
number_of_employees	object	false	Company size "gte" - "lte" range
trading_activity	array of string	false	Trading activity, available in nomenclatures
activity_type	array of int	false	Company activity type, available in nomenclatures
company_type	array of int	false	Company type, available in nomenclatures
company_incorporation	object	false	Company Incorporation "gte" - "lte" range
legal_form	array of int	false	Company form type, available in nomenclatures
industry_focus	array of string	false	Company industries, available in nomenclatures
website_keywords	array of string	false	Company website keywords
nace	array of string	false	NACE Rev. 2, available in nomenclatures
isic	array of string	false	International SIC Code, available in nomenclatures
sic_code_be	array of strings	false	Company Belgium SIC Codes, available in nomenclatures
sic_code_de	array of strings	false	Company Germany SIC Codes, available in nomenclatures
sic_code_dk	array of strings	false	Company Denmark SIC Codes, available in nomenclatures
sic_code_fr	array of strings	false	Company France SIC Codes, available in nomenclatures
sic_code_gb	array of strings	false	Company United Kingdom SIC Codes, available in nomenclatures
sic_code_ie	array of strings	false	Company Ireland SIC Codes, available in nomenclatures
sic_code_it	array of strings	false	Company Italy SIC Codes, available in nomenclatures
sic_code_lu	array of strings	false	Company Luxembourg SIC Codes, available in nomenclatures
sic_code_nl	array of strings	false	Company Netherlands SIC Codes, available in nomenclatures
sic_code_no	array of strings	false	Company Norway SIC Codes, available in nomenclatures
sic_code_se	array of strings	false	Company Sweden SIC Codes, available in nomenclatures
sic_code_sg	array of strings	false	Company Singapore SIC Code SIC Codes, available in nomenclatures
sic_code_us	array of strings	false	Company Singapore SIC Code SIC Codes, available in nomenclatures
sic_code_ca	array of strings	false	Company Canada SIC Codes, available in nomenclatures
sic_code_mx	array of strings	false	Company Mexico SIC Codes, available in nomenclatures
sic_code_anz	array of strings	false	Company ANZ SIC Codes, available in nomenclatures
location_regions	object	false	Company region, available in nomenclatures id (dive into nomenclature) parents (use in prospecting filter)
location_countries	object	false	Company country, available in nomenclatures id (dive into nomenclature) parents (use in prospecting filter)
location_zip	array of strings	false	Company ZIP Code
location_type	array of strings	false	Company City or State
financial_currency	array of strings	false	Company Currency, available in nomenclatures
financial_turnover	object	false	Company Turnover range with "gte" - "lte" values and "currency" ('USD', 'EUR', 'GBP', default: 'USD')
financial_profit	object	false	Company Net Profit "gte" - "lte" range
financial_liabilities	object	false	Company Total Liabilities "gte" - "lte" range
financial_directors	array of int	false	Company Director remuneration "gte" - "lte" range
financial_employee_profit	object	false	Company Profit per Employee "gte" - "lte" range
financial_exports	object	false	Company financial exports "gte" - "lte" range
foreign_parents	string	false	Foreign Parent, available in nomenclatures
ownership_accounts	string	false	Consolidated Accounts, available in nomenclatures
insights_visits	array of strings	false	Company website visits, available in nomenclatures
insights_technologies	array of strings	false	Company website technologies, available in nomenclatures
insights_ranking	object	false	Company website Alexa ranking, available in nomenclatures
advance_companies	array of strings	false	Only Select Companies That, available in nomenclatures
yoy_exports	object	false	Exports "gte" - "lte" range
yoy_liabilities	object	false	Total Liabilities "gte" - "lte" range
yoy_staff	object	false	Staff numbers "gte" - "lte" range
yoy_turnover	object	false	Turnover Growth "gte" - "lte" range
yoy_ebitda	object	false	EBITDA "gte" - "lte" range
yoy_profit	object	false	Profit "gte" - "lte" range
linkedin	url	false	Company Linkedin Url

Companies API

The Companies API allows you to browse all companies based on specific parameters and will provide one or more results based on input that can then be further used to derive company details. You can search for companies in a specific location, of a specific size or turnover, or that are part of a particular industry.

Search Companies

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/overview' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Global Database",
    "country_code": "UK",
    "page": 1
}'

Request example

{
    "name": "Global Database",
    "country_code": "UK",
    "page": 1
}

Success Response

{
    "total_results": 8,
    "total_pages": 2,
    "data": [
        {
            "id": "22401777", //(String) Company ID
            "name": "DATABASE SERVICE PROVIDER GLOBAL LTD", //(String) Company name
            "status": "Active", //(String) Company Status
            "country_code": "GB", //(String) Country code
            "registration_number": "03898451" //(String) Registration Number
        },
        {
            "id": "32019088",
            "name": "ALLIANCE GLOBAL DATABASE SOLUTIONS LTD",
            "status": "Active",
            "country_code": "GB",
            "registration_number": "11189294"
        },
        {
            "id": "28943006",
            "name": "GLOBAL REPERTOIRE DATABASE LIMITED",
            "status": "Active",
            "country_code": "GB",
            "registration_number": "08796841"
        },
        {
            "id": "32544410",
            "name": "GLOBAL CONSUMER DATABASE SERVICE LTD.",
            "status": "Active",
            "country_code": "GB",
            "registration_number": "11589671"
        },
        {
            "id": "22584291",
            "name": "GLOBAL DATABASE MANAGEMENT LIMITED",
            "status": "Active",
            "country_code": "GB",
            "registration_number": "04036430"
        }
    ]
}

Browse companies containing word "Global" in name from United Kingdom

{
  "name": "Global",
  "country_code": "UK",
  "page": 1
}

Browse companies with registration number "07949794" from United Kingdom

{
    "registration_number": "07949794",
    "country_code": "GB",
   "page": 1
}

Browse companies with website "www.novatech.co.uk" from United Kingdom

{
    "website": "www.novatech.co.uk",
    "country_code": "GB",
    "page": 1
}

POST https://api.globaldatabase.com/v2/overview

Find companies based on search criteria

Parameters

Parameter	In	Type	Required	Description
country_code	body	string	false	Country Code ISO 2
state	body	string	false	State (for US use iso 2)
postal_codes	body	array of strings	false	Postal Codes (must be a list, e.g. [])
name	body	string	false	Company Name
registration_number	body	string	false	Registration Number
lei_number	body	string	false	Lei Number
ticker	body	string	false	Ticker
vat_number	body	string	false	VAT Number
website	body	string	false	Company Website
phone_number	body	string	false	Phone Number
person	body	string	false	Full Name Employee
company_status	body	list	false	Company status id, available in nomenclatures
page	body	int	false	Page (default 1)
per_page	body	int	false	Page (Maximum page value is 5)
linkedin	body	url	false	Company Linkedin Url

Company Details

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/companies/20581257' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 20581257
}

Success Response

{
    "id": 17937983,
    "name": "TESCO PLC",
    "registration_number": "00445790",
    "country_code": "GB",
    "company_phone": [
        "+441992632222"
    ],
    "company_email": [],
    "company_fax": [],
    "company_website": "http://www.tesco.com",
    "company_legal_form": "Public Limited Company",
    "status": "Active",
    "brands": "TESCO PLC, TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY",
    "address_street": "TESCO HOUSE SHIRE PARK",
    "address_location": "KESTREL WAY",
    "address_city": "WELWYN GARDEN CITY",
    "country_region": null,
    "zip_code": "AL7 1GA",
    "country_name": "United Kingdom",
    "size": "10001",
    "vat_number": null,
    "founding_date": "1947-11-27",
    "industry": [
        {
            "id": 4592033,
            "type": "industry_focus",
            "value": "Retail"
        },
        {
            "id": 4563309,
            "type": "industry_focus",
            "value": "Fair trade products"
        },
        {
            "id": 4563294,
            "type": "industry_focus",
            "value": "Retail"
        }
    ],
    "sic": [
        {
            "id": 3969852,
            "type": "sic_code_gb",
            "value": "47110 - Retail sale in non-specialised stores with food, beverages or tobacco predominating"
        }
    ],
    "twitter": "twitter.com/tesco",
    "linkedin": "linkedin.com/company/-tesco",
    "facebook": "facebook.com/tesco"
}

GET https://api.globaldatabase.com/v2/companies/{id}

View company details

Parameters

Parameter	In	Type	Required	Description
id	url	string	true	Company ID

Employees API

The Employee API looks up contacts and emails associated with employees in a company and returns information on their location, seniority, department, job title. For example, you can use this to find all Chief Information Security executives working in SMEs in the Automotive industry across the UK.

Search Employee

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/employees' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 1,
    "per_page": 5,
    "filters": {
        "company_id": 20581257
    }
}'

Request example

{
    "page": 1,
    "per_page": 5,
    "filters": {
        "company_id": 20581257
    }
}

Success Response

{
    "total_employees": 69,
    "total_pages": 14,
    "data": [
        {
            "id": "20773074",
            "name": "Alex Puttock",
            "company_id": "20581257",
            "company_name": "NOVATECH LIMITED"
        },
        {
            "id": "20773046",
            "name": "Alex Puttock",
            "company_id": "20581257",
            "company_name": "NOVATECH LIMITED"
        },
        {
            "id": "20773060",
            "name": "Jamie Peter Wilson",
            "company_id": "20581257",
            "company_name": "NOVATECH LIMITED"
        },
        {
            "id": "20773134",
            "name": "David Richard Morgan Furby",
            "company_id": "20581257",
            "company_name": "NOVATECH LIMITED"
        },
        {
            "id": "74271219",
            "name": "Darren Ian Smith",
            "company_id": "20581257",
            "company_name": "NOVATECH LIMITED"
        }
    ]
}

POST https://api.globaldatabase.com/v2/employees

View search employees

Parameters

Parameter	In	Type	Required	Description
page	body	int	false	Page number (Maximum page value is 10)
per_page	body	int	false	Number of results per page
filters	body	object	true	Filter criteria json encoded

Fields: filters

Parameter	Type	Required	Description
full_name	strings	false	Employee full name
advance	array of strings	false	Only Select Contacts That, available in nomenclatures - advance-contacts
seniority	array of int	false	Contact level, available in nomenclatures - seniority_level
department	array of int	false	Contact department, available in nomenclatures - departments
job_title	array of strings	false	Job Title
company_id	int	false	Company ID
linkedin	url	false	Contact Linkedin Url

Employee Details

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/employees/199328763' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 199328763
}

Success Response

{
    "id": "199328763",
    "full_name": "Kerry Louise Johnson",
    "first_name": "Kerry",
    "last_name": "Johnson",
    "patronime_name": "Louise",
    "gender": "F",
    "seniority_level": [
        "Manager"
    ],
    "function_original_name": "governance officer",
    "phone": "+447446108873",
    "email": "kerry.johnson@lewisham.gov.uk",
    "nationality": null,
    "company_name": "LONDON SOUTH BANK UNIVERSITY",
    "twitter": null,
    "linkedin": null,
    "facebook": null
}

GET https://api.globaldatabase.com/v2/employees/{id}

View employee details

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Employee ID

Watch Companies API

The Watch API allows you to keep track of all relevant changes and updates made to a company as well as be informed automatically once chosen indicators change in the company’s profile be that change of name, directors, financial ratios, or legal status. For example, you can keep track of your buyer’s financial situation to gauge their credibility or monitor a provider’s growth to decide if you want to continue working with them.

• Companies Webhook
• The Webhook system allows you to be notified of changes made to indicators you have selected.

Start Watch Company

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/companies/20581257/watch/start' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "fields": [
        "company.name",
        "company.status",
        "company.registration_number",
        "company.vat",
        "company.address_street",
        "company.email",
        "company.phone",
        "company.fax",
        "company.website",
        "company.bank",
        "company.employees_number",
        "company.trading_activity_export",
        "company.trading_activity_import",
        "company.group_structure",
        "company.financial",
        "office.identity",
        "office.email",
        "office.fax",
        "office.phone",
        "office.website",
        "address.street",
        "shareholder.holding",
        "shareholder.holding_historical",
        "shareholder.exit_precise",
        "shareholder.exit_approximate",
        "shareholder.share_type",
        "shareholder.share_price",
        "employee.appointment",
        "employee.phone",
        "employee.email",
        "employee.resignation_date",
        "officer.appointment",
        "officer.phone",
        "officer.email",
        "officer.resignation_date"
    ]
}'

Request example

{
    "fields": [
        "company.name",
        "company.status",
        "company.registration_number",
        "company.vat",
        "company.address_street",
        "company.email",
        "company.phone",
        "company.fax",
        "company.website",
        "company.bank",
        "company.employees_number",
        "company.trading_activity_export",
        "company.trading_activity_import",
        "company.group_structure",
        "company.financial",
        "office.identity",
        "office.email",
        "office.fax",
        "office.phone",
        "office.website",
        "address.street",
        "shareholder.holding",
        "shareholder.holding_historical",
        "shareholder.exit_precise",
        "shareholder.exit_approximate",
        "shareholder.share_type",
        "shareholder.share_price",
        "employee.appointment",
        "employee.phone",
        "employee.email",
        "employee.resignation_date",
        "officer.appointment",
        "officer.phone",
        "officer.email",
        "officer.resignation_date"
    ]
}

Success Response

201

POST https://api.globaldatabase.com/v2/companies/{id}/watch/start

Start watch company

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
fields	body	list	false	Fields to watch (see list below)

Available watch fields:

Every event type below maps to one monitored indicator. The event is delivered when that indicator changes.

Company

Event type	Triggered when
company.name	Company name added, changed or removed
company.status	Company status changed
company.registration_number	Company registration number changed
company.vat	Company VAT code added, changed or removed
company.address_street	Company address added or changed
company.email	Company email added, changed or removed
company.phone	Company phone added, changed or removed
company.fax	Company fax added, changed or removed
company.website	Company website added, changed or removed
company.bank	Company bank account added, changed or removed
company.employees_number	Company employees number added, changed or removed
company.trading_activity_export	Company export activity added, changed or removed
company.trading_activity_import	Company import activity added, changed or removed
company.group_structure	Company group structure added, changed or removed
company.financial	Annual financial report filed

Locations

Event type	Triggered when
office.identity	Office added (new entity)
office.email	Office email added, changed or removed
office.fax	Office fax added, changed or removed
office.phone	Office phone added, changed or removed
office.website	Office website added, changed or removed
address.street	Office street address added or changed

Shareholders

Event type	Triggered when
shareholder.holding	New shareholder registered (live)
shareholder.holding_historical	Historical shareholding registered (backfill)
shareholder.exit_precise	Shareholder exit with exact date
shareholder.exit_approximate	Shareholder exit with approximate date (registry does not report the date)
shareholder.share_type	Shareholder share type added
shareholder.share_price	Shareholder share price added or changed

Employees

Event type	Triggered when
employee.appointment	Employee joined
employee.phone	Employee phone added, changed or removed
employee.email	Employee email added, changed or removed
employee.resignation_date	Employee resignation date registered

Officers

Event type	Triggered when
officer.appointment	Officer appointed
officer.phone	Officer phone added, changed or removed
officer.email	Officer email added, changed or removed
officer.resignation_date	Officer resignation date registered

Stop Watch Company

Code samples

curl -X DELETE 'https://api.globaldatabase.com/v2/companies/20581257/watch/stop' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
    "id": 20581257
}

Success Response

200

DELETE https://api.globaldatabase.com/v2/companies/{id}/watch/stop

Stop watch company

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID

Watched Companies

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/companies/watch?date=2021-08-10' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "fields": ["company.fax"],
  "date": "2021-08-10",
  "page": 1,
  "per_page": 10
}

Success Response

{
  "data": [
    {
      "id": "88663676",
      "name": "MMS A/S af 18.10.2017",
      "country_code": "DK",
      "registration_number": "25638700",
      "date": "2021-08-10",
      "fields": [
        "company.fax",
        "shareholder.name",
        "company.status"
      ]
    },
    //...
  ],
  "total_results": 10,
  "pages": 1
}

GET https://api.globaldatabase.com/v2/companies/watch

List watched companies

Parameters

Parameter	In	Type	Required	Description
date	params	date	false	Date
fields	params	list	false	Fields Watch
page	params	int	false	Page number
per_page	params	int	false	Number of results per page

All Companies Events

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/companies/{id}/watch/events?from_date=2020-08-10&to_date=2021-08-10' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 61862770,
  "fields": ["company.name"],
  "from_date": "2020-08-10",
  "to_date": "2021-08-10",
  "page": 1,
  "per_page": 10
}

Success Response

{
    "data": [
        {
            "status": "UPDATED",
            "message": "Company change his name from <b>PATRICK SWEENEY FUNERAL DIRECTORS LIMITED</b> to <b>PATRICK</b>",
            "date_created": "2021-03-02T06:50:09Z",
            "event_type": "company.name"
        },
        //...
    ],
    "total_results": 5,
    "pages": 1
}

GET https://api.globaldatabase.com/v2/companies/{id}/watch/events

List company events

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
from_date	params	date	false	From Date
to_date	params	date	false	To Date
fields	params	list	false	Fields Watch
page	params	int	false	Page number
per_page	params	int	false	Number of results per page

Watched Company Fields

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/companies/20581257/watch/fields' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
    "id": 20581257
}

Success Response

[
    "vat_number"
]

GET https://api.globaldatabase.com/v2/companies/{id}/watch/stop

Get Watched Company Fields

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID

Add Watched Fields

Code samples

curl -X PUT 'https://api.globaldatabase.com/v2/companies/20581257/watch/fields/add' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "fields": [
        "vat_number"
    ]
}'

Request example

{
    "fields": [
        "vat_number"
    ]
}

Success Response

[
    "company.fax",
    "vat_number"
]

PUT https://api.globaldatabase.com/v2/companies/{id}/watch/start

Add fields for watch company

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
fields	body	list	false	Fields Watch

Remove Watched Fields

Code samples

curl -X PUT 'https://api.globaldatabase.com/v2/companies/20581257/watch/fields/remove' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "fields": [
        "vat_number"
    ]
}'

Request example

{
    "fields": [
        "company.phone"
    ]
}

Success Response

[
    "company.fax",
    "vat_number"
]

PUT https://api.globaldatabase.com/v2/companies/{id}/watch/start

Remove fields for watch company

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
fields	body	list	false	Fields Watch

Set Callback URL

Code samples

curl -X PUT 'https://api.globaldatabase.com/v2/companies/watch/callback' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "callback": "https://globaldatabase.com"
}'

Request example

{
  "callback": "https://globaldatabase.com"
}

Success Response

{
    "callback": "https://globaldatabase.com",
    "secret": "cffa3c394368ef91079f17c0937ed2b55731621c4c1bed8db954186693b3971a"
}

PUT https://api.globaldatabase.com/v2/companies/watch/callback

Set callback url for webhook notifications

Parameters

Parameter	In	Type	Required	Description
callback	body	url	true	Callback URL

secret is generated automatically the first time you set a callback -- you don't send it, the API returns it. It stays the same across later calls, even if you change the callback URL. Use it to verify the X-GD-Signature header on incoming webhooks (see Companies Webhook below).

Get Callback URL

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/companies/watch/callback' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

{
    "callback": "https://globaldatabase.com/",
    "secret": "cffa3c394368ef91079f17c0937ed2b55731621c4c1bed8db954186693b3971a"
}

GET https://api.globaldatabase.com/v2/companies/watch/callback

Get callback url for webhook companies notifications

Companies Webhook

Response

{
  "company_data": {
    "id": 9,
    "name": "TESCO PLC",
    "registration_number": "00445790",
    "country_code": "GB",
    "date": "2021-09-15T18:53:25Z"
  },
  "field": "company.email",
  "status": "UPDATE",
  "new_value": "email@example.com",
  "old_value": "email1@example.com"
}

Headers

Content-Type: application/json
X-GD-Signature: a165b69f316eb1a911bdd436cc5c818cd4cd0885404c4aba1a6cdbcd66a86851

POST https://your_callback_url

Webhook companies notifications

Verifying the signature

Every request carries an X-GD-Signature header: the HMAC-SHA256 (hex-encoded) of the raw request body, keyed with the secret from Set Callback URL / Get Callback URL.

Compute the HMAC over the exact bytes you received -- not a re-serialized copy of the parsed JSON, since key order or spacing can differ and break the comparison. Compare with a constant-time check.

import hmac
import hashlib

def verify(secret: str, raw_body: bytes, signature_header: str) -> bool:
    expected = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature_header)

echo -n '' | openssl dgst -sha256 -hmac ""

Example receiver

A failed delivery (anything but a 2xx response, including a timeout) is retried a few times, checked once a minute. Verify the signature and respond 200 right away; do any slow processing afterwards, off the request.

# Flask
import hashlib
import hmac

from flask import Flask, abort, request

app = Flask(__name__)
WEBHOOK_SECRET = "cffa3c394368ef91079f17c0937ed2b55731621c4c1bed8db954186693b3971a"


@app.route("/gd/webhook", methods=["POST"])
def gd_webhook():
    raw_body = request.get_data()  # raw bytes -- read before anything parses the JSON
    signature = request.headers.get("X-GD-Signature", "")

    expected = hmac.new(WEBHOOK_SECRET.encode(), raw_body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(expected, signature):
        abort(401)

    event = request.get_json()
    handle_event.delay(event)  # queue it -- don't process inline before responding

    return "", 200

// Express
const crypto = require("crypto");
const express = require("express");

const app = express();
const WEBHOOK_SECRET = "cffa3c394368ef91079f17c0937ed2b55731621c4c1bed8db954186693b3971a";

// keep the raw bytes around -- express.json() replaces them with the parsed object
app.use(express.json({
  verify: (req, _res, buf) => { req.rawBody = buf; },
}));

app.post("/gd/webhook", (req, res) => {
  const expected = crypto
    .createHmac("sha256", WEBHOOK_SECRET)
    .update(req.rawBody)
    .digest("hex");
  const received = req.headers["x-gd-signature"] || "";

  const valid = expected.length === received.length
    && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(received));

  if (!valid) return res.sendStatus(401);

  handleEvent(req.body); // queue it -- don't process inline before responding
  res.sendStatus(200);
});

Enrichment API

The Enrichment API is designed to find and receive detailed company and employee information based on domain or email. This can be utilized for only company, employee, or both combined. This solution allows you to look up a person’s position and contact details, receive a detailed profile of a company you’re verifying, or be utilized as an end-customer facing solution to provide them with information and insights. For example, you can provide your end-customers with white-labeled data from Global Database by integrating the Enrichment API into your own solution.

Enrichment Company By Website

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/enrichment/url' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "http://www.tesco.com"
}'

Request example

{
    "url": "http://www.tesco.com"
}

Success Response

{
    "id": 17937983,
    "name": "TESCO PLC",
    "registration_number": "00445790",
    "country_code": "GB",
    "company_phone": [
        "+441992632222"
    ],
    "company_email": [],
    "company_fax": [],
    "company_website": "http://www.tesco.com",
    "company_legal_form": "Public Limited Company",
    "brands": "TESCO PLC, TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY",
    "address_street": "TESCO HOUSE SHIRE PARK",
    "address_location": "KESTREL WAY",
    "address_city": "WELWYN GARDEN CITY",
    "country_region": null,
    "zip_code": "AL7 1GA",
    "country_name": "United Kingdom",
    "size": "10001",
    "vat_number": null,
    "founding_date": "1947-11-27",
    "industry": [
        {
            "id": 4592033,
            "type": "industry_focus",
            "value": "Retail"
        },
        {
            "id": 4563309,
            "type": "industry_focus",
            "value": "Fair trade products"
        },
        {
            "id": 4563294,
            "type": "industry_focus",
            "value": "Retail"
        }
    ],
    "sic": [
        {
            "id": 3969852,
            "type": "sic_code_gb",
            "value": "47110 - Retail sale in non-specialised stores with food, beverages or tobacco predominating"
        }
    ],
    "twitter": "twitter.com/tesco",
    "linkedin": "linkedin.com/company/-tesco",
    "facebook": "facebook.com/tesco"
}

POST https://api.globaldatabase.com/v2/enrichment/url

Parameters

Parameter	In	Type	Required	Description
url	body	string	true	Company Website
include_provenance	body	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Enrichment Company By Linkedin URL

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/enrichment/company/linkedin' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "linkedin": "https://www.linkedin.com/company/global-database/"
}'

Request example

{
    "linkedin": "https://www.linkedin.com/company/global-database/"
}

Success Response

{
    "id": "29707645",
    "name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "registration_number": "09410808",
    "country_code": "GB",
    "company_phone": [
        "+442036406006"
    ],
    "company_email": [
        "info@globaldatabase.com"
    ],
    "company_fax": null,
    "company_website": "http://globaldatabase.com/",
    "company_legal_form": "Private limited company (Ltd.)",
    "status": "Active",
    "brands": "Global Database",
    "address_street": "Artisans' House",
    "address_location": "7 Queensbridge",
    "address_city": "Northampton",
    "country_region": "England",
    "zip_code": "NN4 7BF",
    "country_name": "United Kingdom",
    "size": "3",
    "vat_number": null,
    "founding_date": "2015-01-28",
    "industry": [
        {
            "id": 4563106,
            "type": "industry_focus",
            "value": "Information Technology"
        },
        {
            "id": 4563495,
            "type": "industry_focus",
            "value": "Textile"
        }
    ],
    "sic": [
        {
            "id": 3969895,
            "type": "sic_code_gb",
            "value": "47990 - Other retail sale not in stores, stalls or markets"
        }
    ],
    "twitter": null,
    "linkedin": "linkedin.com/company/global-database",
    "facebook": null
}

POST https://api.globaldatabase.com/v2/enrichment/company/linkedin

Parameters

Parameter	In	Type	Required	Description
linkedin	body	string	true	Company Linkedin Url
include_provenance	body	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Enrichment Company

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/enrichment/company' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "registration_number": "09410808",
    "country_code": "UK"
}'

Request example

{
    "registration_number": "09410808",
    "country_code": "UK"
}

Success Response

{
    "id": "29707645",
    "name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "registration_number": "09410808",
    "country_code": "GB",
    "company_phone": [
        "+442036406006"
    ],
    "company_email": [
        "info@globaldatabase.com"
    ],
    "company_fax": null,
    "company_website": "http://globaldatabase.com/",
    "company_legal_form": "Private limited company (Ltd.)",
    "status": "Active",
    "brands": "Global Database",
    "address_street": "Artisans' House",
    "address_location": "7 Queensbridge",
    "address_city": "Northampton",
    "country_region": "England",
    "zip_code": "NN4 7BF",
    "country_name": "United Kingdom",
    "size": "3",
    "vat_number": null,
    "founding_date": "2015-01-28",
    "industry": [
        {
            "id": 4563106,
            "type": "industry_focus",
            "value": "Information Technology"
        }
    ],
    "sic": [
        {
            "id": 3969895,
            "type": "sic_code_gb",
            "value": "47990 - Other retail sale not in stores, stalls or markets"
        }
    ],
    "twitter": null,
    "linkedin": "linkedin.com/company/global-database",
    "facebook": null
}

POST https://api.globaldatabase.com/v2/enrichment/company

Parameters

Parameter	In	Type	Required	Description
registration_number	body	string	false	Company Registration Number
vat_number	body	string	false	Company VAT Number
ticker	body	string	false	Ticker
country_code	body	string	true	Country Code
state	body	string	false	Is required for Country Code US

Enrichment Contact By Email

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/enrichment/email' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "email": "thomas.vanmourik@culinalogistics.co.uk"
}'

Request example

{
    "email": "thomas.vanmourik@culinalogistics.co.uk"
}

Success Response

{
    "id": "34871530",
    "full_name": "Thomas Van Mourik",
    "first_name": "Thomas",
    "last_name": "Van Mourik",
    "patronime_name": null,
    "gender": "M",
    "seniority_level": [
        "CXO"
    ],
    "function_original_name": "CXO",
    "phone": "+441650695000",
    "email": "thomas.vanmourik@culinalogistics.co.uk",
    "nationality": null,
    "company_id": "24131010",
    "company_name": "CULINA LOGISTICS LIMITED",
    "twitter": null,
    "linkedin": null,
    "facebook": null
}

POST https://api.globaldatabase.com/v2/enrichment/email

Parameters

Parameter	In	Type	Required	Description
email	body	string	true	Contact Email
reveal_phone	body	bool	false	Reveal Phone (Default value is True)
include_details	body	bool	false	Return the extended profile fields (Default value is False). Requires the Contact Details permission, otherwise the response is returned without them

Request example with include_details

{
    "email": "thomas.vanmourik@culinalogistics.co.uk",
    "include_details": true
}

Success Response with include_details

{
    "id": "34871530",
    "full_name": "Thomas Van Mourik",
    "first_name": "Thomas",
    "last_name": "Van Mourik",
    "patronime_name": null,
    "gender": "M",
    "seniority_level": [
        "CXO"
    ],
    "function_original_name": "CXO",
    "phone": "+441650695000",
    "email": "thomas.vanmourik@culinalogistics.co.uk",
    "nationality": null,
    "company_id": "24131010",
    "company_name": "CULINA LOGISTICS LIMITED",
    "twitter": null,
    "linkedin": null,
    "facebook": null,
    "company_website": "https://www.culinagroup.com",
    "company_linkedin": "https://linkedin.com/company/culina-group",
    "country": "United Kingdom",
    "location": "Stafford, England, United Kingdom",
    "headline": "Chief Executive Officer at Culina Logistics",
    "work_experience": [
        {
            "start": "2016 Apr",
            "end": null,
            "company_name": "CULINA LOGISTICS LIMITED",
            "job_title": "Chief Executive Officer"
        }
    ],
    "educations": [
        {
            "study": "BSc Logistics",
            "start": "1998",
            "end": "2001",
            "institution": "University of Warwick"
        }
    ],
    "skills": [
        "Supply Chain",
        "Logistics"
    ]
}

Detail fields

Send include_details: true to receive the extended profile fields below, in addition to the standard response. The parameter requires the Contact Details permission on your account. If the account does not have it, the request still succeeds and the detail fields are simply omitted — no error is returned. Contact your account manager to enable it.

Field	Type	Description
country	string	Contact country
location	string	Contact location (city, region, country)
headline	string	Contact professional headline
work_experience	array of object	Employment history. Each entry has job_title, company_name, start and end (null when the role is current)
educations	array of object	Education history. Each entry has institution, study, start and end
skills	array	Contact skills
company_website	string	Website of the contact's company
company_linkedin	string	Linkedin URL of the contact's company

Enrichment Contact By Linkedin URL

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/enrichment/employee/linkedin' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "linkedin": "https://www.linkedin.com/in/alex-price-991845116/"
}'

Request example

{
    "linkedin": "https://www.linkedin.com/in/alex-price-991845116/"
}

Success Response

{
    "id": "391778535",
    "full_name": "Alex Price",
    "first_name": "Alex",
    "last_name": "Price",
    "patronime_name": null,
    "gender": "M",
    "seniority_level": [
        "Manager"
    ],
    "department": [],
    "function_original_name": "Future Leaders Graduate",
    "phone": "+447984096205",
    "email": "alex.price@ba.com",
    "nationality": null,
    "company_id": "19531621",
    "company_name": "BRITISH AIRWAYS PLC",
    "twitter": null,
    "linkedin": "https://linkedin.com/in/alex-price-991845116",
    "facebook": null
}

POST https://api.globaldatabase.com/v2/enrichment/employee/linkedin

Parameters

Parameter	In	Type	Required	Description
linkedin	body	string	true	Contact Linkedin Url
reveal_email	body	bool	false	Reveal Email (Default value is True)
reveal_phone	body	bool	false	Reveal Phone (Default value is True)
include_details	body	bool	false	Return the extended profile fields (Default value is False). Requires the Contact Details permission, otherwise the response is returned without them

Request example with include_details

{
    "linkedin": "https://linkedin.com/in/alex-price-991845116",
    "include_details": true
}

Success Response with include_details

{
    "id": "391778535",
    "full_name": "Alex Price",
    "first_name": "Alex",
    "last_name": "Price",
    "patronime_name": null,
    "gender": "M",
    "seniority_level": [
        "Manager"
    ],
    "department": [],
    "function_original_name": "Future Leaders Graduate",
    "phone": "+447984096205",
    "email": "alex.price@ba.com",
    "nationality": null,
    "company_id": "19531621",
    "company_name": "BRITISH AIRWAYS PLC",
    "twitter": null,
    "linkedin": "https://linkedin.com/in/alex-price-991845116",
    "facebook": null,
    "company_website": "https://www.britishairways.com",
    "company_linkedin": "https://linkedin.com/company/british-airways",
    "country": "United Kingdom",
    "location": "London, England, United Kingdom",
    "headline": "Future Leaders Graduate at British Airways",
    "work_experience": [
        {
            "start": "2019 Sep",
            "end": null,
            "company_name": "BRITISH AIRWAYS PLC",
            "job_title": "Future Leaders Graduate"
        }
    ],
    "educations": [
        {
            "study": "BSc Management",
            "start": "2015",
            "end": "2018",
            "institution": "University of Manchester"
        }
    ],
    "skills": [
        "Project Management",
        "Data Analysis"
    ]
}

Detail fields

Send include_details: true to receive the extended profile fields below, in addition to the standard response. The parameter requires the Contact Details permission on your account. If the account does not have it, the request still succeeds and the detail fields are simply omitted — no error is returned. Contact your account manager to enable it.

Field	Type	Description
country	string	Contact country
location	string	Contact location (city, region, country)
headline	string	Contact professional headline
work_experience	array of object	Employment history. Each entry has job_title, company_name, start and end (null when the role is current)
educations	array of object	Education history. Each entry has institution, study, start and end
skills	array	Contact skills
company_website	string	Website of the contact's company
company_linkedin	string	Linkedin URL of the contact's company

Enrichment Contact

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/enrichment/employee/contacts' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "Alex",
    "last_name": "Price",
    "company_name": "BRITISH AIRWAYS PLC",
    "email": "alex.price@ba.com"
}'

Request example

{
    "first_name": "Alex",
    "last_name": "Price",
    "company_name": "BRITISH AIRWAYS PLC",
    "email": "alex.price@ba.com"
}

Success Response

{
    "id": "391778535",
    "full_name": "Alex Price",
    "first_name": "Alex",
    "last_name": "Price",
    "patronime_name": null,
    "gender": "M",
    "seniority_level": [
        "Manager"
    ],
    "department": [],
    "function_original_name": "Future Leaders Graduate",
    "phone": "+447984096205",
    "email": "alex.price@ba.com",
    "nationality": null,
    "company_id": "19531621",
    "company_name": "BRITISH AIRWAYS PLC",
    "twitter": null,
    "linkedin": "https://linkedin.com/in/alex-price-991845116",
    "facebook": null
}

POST https://api.globaldatabase.com/v2/enrichment/employee/contacts

Parameters

Parameter	In	Type	Required	Description
first_name	body	string	false	Contact First Name
last_name	body	string	false	Contact First Name
company_name	body	string	false	Company Name
domain	body	string	false	Domain or Website
email	body	string	false	Contact Email
linkedin	body	string	false	Contact Linkedin Profile Url
reveal_email	body	bool	false	Reveal Email (Default value is True)
reveal_phone	body	bool	false	Reveal Phone (Default value is True)
include_details	body	bool	false	Return the extended profile fields (Default value is False). Requires the Contact Details permission, otherwise the response is returned without them

Request example with include_details

{
    "first_name": "Alex",
    "last_name": "Price",
    "company_name": "BRITISH AIRWAYS PLC",
    "email": "alex.price@ba.com",
    "include_details": true
}

Success Response with include_details

{
    "id": "391778535",
    "full_name": "Alex Price",
    "first_name": "Alex",
    "last_name": "Price",
    "patronime_name": null,
    "gender": "M",
    "seniority_level": [
        "Manager"
    ],
    "department": [],
    "function_original_name": "Future Leaders Graduate",
    "phone": "+447984096205",
    "email": "alex.price@ba.com",
    "nationality": null,
    "company_id": "19531621",
    "company_name": "BRITISH AIRWAYS PLC",
    "twitter": null,
    "linkedin": "https://linkedin.com/in/alex-price-991845116",
    "facebook": null,
    "company_website": "https://www.britishairways.com",
    "company_linkedin": "https://linkedin.com/company/british-airways",
    "country": "United Kingdom",
    "location": "London, England, United Kingdom",
    "headline": "Future Leaders Graduate at British Airways",
    "work_experience": [
        {
            "start": "2019 Sep",
            "end": null,
            "company_name": "BRITISH AIRWAYS PLC",
            "job_title": "Future Leaders Graduate"
        }
    ],
    "educations": [
        {
            "study": "BSc Management",
            "start": "2015",
            "end": "2018",
            "institution": "University of Manchester"
        }
    ],
    "skills": [
        "Project Management",
        "Data Analysis"
    ]
}

Detail fields

Send include_details: true to receive the extended profile fields below, in addition to the standard response. The parameter requires the Contact Details permission on your account. If the account does not have it, the request still succeeds and the detail fields are simply omitted — no error is returned. Contact your account manager to enable it.

Field	Type	Description
country	string	Contact country
location	string	Contact location (city, region, country)
headline	string	Contact professional headline
work_experience	array of object	Employment history. Each entry has job_title, company_name, start and end (null when the role is current)
educations	array of object	Education history. Each entry has institution, study, start and end
skills	array	Contact skills
company_website	string	Website of the contact's company
company_linkedin	string	Linkedin URL of the contact's company

Search employees

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/enrichment/employee/search' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "domain_list": [
        "amazon.com"
    ],
    "company_locations": [
        "United States"
    ],
    "employee_locations": [
        "India"
    ],
    "employee_seniorities": [
        "director"
    ],
    "page": 1,
    "per_page": 100
}'

Request example

{
    "domain_list": [
        "amazon.com"
    ],
    "company_locations": [
        "United States"
    ],
    "employee_locations": [
        "India"
    ],
    "employee_seniorities": [
        "director"
    ],
    "page": 1,
    "per_page": 100
}

Success Response

{
    "total_employees": 344,
    "total_pages": 4,
    "data": [
        {
            "id": "fa5ec73398a4a4ce2cd8a1a95c16b5fb",
            "last_name": "Gupta",
            "first_name": "Raghava",
            "name": "Raghava Gupta",
            "seniority_level": "director",
            "job_title": "Director - CrossBorder Tech, Product and Science",
            "twitter": null,
            "facebook": null,
            "linkedin": "http://www.linkedin.com/in/raghavagupta",
            "country": "India",
            "state": "Karnataka",
            "city": "Bengaluru",
            "company": {
                "name": "Amazon",
                "website": "http://www.amazon.com",
                "incorporation_date": 1994,
                "country": "United States",
                "state": "Washington",
                "city": "Seattle",
                "postal_code": "98109",
                "phone": "+12062661000",
                "twitter": "https://twitter.com/amazon",
                "facebook": "https://facebook.com/Amazon/",
                "linkedin": "http://www.linkedin.com/company/amazon",
                "street_address": "345 Boren Avenue North"
            }
        },
        ...
    ]
}

POST https://api.globaldatabase.com/v2/enrichment/employee/search

Parameters

Parameter	In	Type	Required	Description
domain_list	body	list	false	Domains Companies
company_locations	body	list	false	Companies Location
employee_locations	body	list	false	Employees Location
employee_seniorities	body	list	false	Employees Seniorities
page	body	int	false	Page
per_page	body	int	false	Number of results per page

Possible values for employee_seniorities:

• owner
• founder
• c_suite
• partner
• vp
• head
• director
• manager
• senior
• entry
• intern

Autocomplete API

The Autocomplete API’s primary function is to automate the completion of forms and fields with an initial input. This is used to enhance end-customer services as well as populate CRM information with details on each introduced lead, be that company or employee. For example, you can use the Autocomplete API to allow your sales people keep your CRM tidy and organized by automatically filling in all relevant fields once they enter a new lead’s first email address.

Autocomplete Company Detail

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/autocomplete' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "website": "http://www.tesco.com"
}'

Request example

{
    "website": "http://www.tesco.com"
}

Success Response

{
    "id": 17937983,
    "name": "TESCO PLC",
    "registration_number": "00445790",
    "country_code": "GB",
    "company_phone": [
        "+441992632222"
    ],
    "company_email": [],
    "company_fax": [],
    "company_website": "http://www.tesco.com",
    "company_legal_form": "Public Limited Company",
    "brands": "TESCO PLC, TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY",
    "address_street": "TESCO HOUSE SHIRE PARK",
    "address_location": "KESTREL WAY",
    "address_city": "WELWYN GARDEN CITY",
    "country_region": null,
    "zip_code": "AL7 1GA",
    "country_name": "United Kingdom",
    "size": "10001",
    "vat_number": null,
    "founding_date": "1947-11-27",
    "industry": [
        {
            "id": 4592033,
            "type": "industry_focus",
            "value": "Retail"
        },
        {
            "id": 4563309,
            "type": "industry_focus",
            "value": "Fair trade products"
        },
        {
            "id": 4563294,
            "type": "industry_focus",
            "value": "Retail"
        }
    ],
    "sic": [
        {
            "id": 3969852,
            "type": "sic_code_gb",
            "value": "47110 - Retail sale in non-specialised stores with food, beverages or tobacco predominating"
        }
    ],
    "twitter": "twitter.com/tesco",
    "linkedin": "linkedin.com/company/-tesco",
    "facebook": "facebook.com/tesco"
}

Request example

{
    "country_code": "GB"
}

Error Response

{
    "fields": [
        "Select at least one more field ['name', 'registration_number', 'vat_number', 'website', 'phone_number']."
    ]
}

POST https://api.globaldatabase.com/v2/autocomplete

View autocomplete company details

Parameters

Parameter	In	Type	Required	Description
country_code	body	string	false	Country Code ISO
name	body	string	false	Company Name
registration_number	body	string	false	Registration Number
vat_number	body	string	false	VAT Number
ticker	body	string	false	Ticker
website	body	string	false	Company Website
email	body	string	false	Company Email
linkedin	body	url	false	Company Linkedin Url
include_provenance	body	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Financials API

The Financial API is designed to provide detailed information on the latest financial figures for companies. The displayed fields can be adjust to reflect the most important financial indicators for you. For example you can create detailed reports and financial models by analyzing reports of similar companies in a given market.

Company Financials

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/financial/20581257' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "year": 2020
}

Success Response

{
    "2020": {
        "Share-Capital": 535500,
        "Pretax-Profit-Margin": 0.55,
        "Bank-Overdraft-And-LTL": 1234603,
        "Cash-To-Total-Assets": 22.59,
        "Employee-Numbers-Yoy": -1,
        "EBITDA": 305579,
        "World-Turnover": 30705740,
        "Revenue-Per-Employee": 310158.9898989899,
        "Pre-Tax-Profit": 168377,
        "Capital-Employed": 4533491,
        "Human-Capital-Value-Added": 40796.79797979798,
        "Stocks-And-Work-in-Progress": 2321893,
        "Interest-Payable": 18160,
        "Intangible-Assets": 0,
        "P-And-L-Account-Reserve": 1739798,
        "Cost-of-Sales": 25720263,
        "Currency": "GBP",
        "Turnover": 30705740,
        "Total-Long-Term-Liabilities": 1184603,
        "Employee-Numbers": 99,
        "Other-Long-Term-Financing": 0,
        "Total-Liabilities-Yoy": 47.55891242551835,
        "Net-Assets": 3348888,
        "Other-Short-Term-Loans": 0,
        "Total-Current-Assets": 7329410,
        "EBITDA-Margin": 1.0,
        "Consolidated-Accounts": "N",
        "Net-Debt-To-EBITDA-Ratio": -3.5359628770301623,
        "Dividends-Payable": 250430,
        "Other-Short-Term-Financing": 0,
        "Return-On-Assets": 1.99,
        "Total-Non-Current-HP-And-Lease-Commitments": 0,
        "Liquidity-Ratio": 0.8434609219101853,
        "Reporting-period": 13,
        "Taxation": -50772,
        "Miscellaneous-Current-Assets": 0,
        "Shareholder-Funds": 3348888,
        "Auditor-Fees": 43350,
        "Days-Payable-Outstanding": 25.678956218293727,
        "Gearing-Net-Debt-Basis": -32.26,
        "Net-Cash-Flow-before-Financing": 0,
        "Audit-Fees": 25000,
        "Other-Audit-Costs": 18350,
        "Turnover-Yoy": 14.205527131629847,
        "Days-Inventory-Outstanding": 26.96832823987842,
        "Miscellaneous-Current-Liabilities": 2041890,
        "Gearing-Gross-Debt-Basis": 38.36,
        "Interest-Receivable": 0,
        "Wages-And-Salaries": 3852346,
        "Days-Sales-Outstanding": 21.509643066736057,
        "Current-Hire-Purchase-Commitments": 0,
        "Cash": 2365119,
        "Net-Margin": 0.38,
        "Return-On-Equity": 3.51,
        "Depreciation-of-Tangibles": 119042,
        "Total-Fixed-Assets": 3140950,
        "Profit-after-Tax": 117605,
        "Profit-after-Tax-Yoy": -52.05490621343628,
        "Debt-To-Capital": 68.02,
        "Employee-Remuneration": 3416507,
        "Exports-Yoy": 43.78552368091236,
        "Contingent-Liability": 0,
        "Gross-Margin": 16.24,
        "Operating-Profit-Margin": 0.61,
        "Net-Cashflow-before-Financing": 0,
        "Net-Worth": 3348888,
        "Bank-Overdraft": 50000,
        "Sundry-Reserves": 170463,
        "Directors-Remuneration": 590808,
        "Cash-To-Turnover": 5.449435512708698,
        "Revaluation-Reserve": 903127,
        "EBITDA-Yoy": -6.058938540616316,
        "Current-Ratio": 1.234558148411225,
        "Amortisation-of-Intangibles": 0,
        "Reported-Date": "2020-05-31",
        "Return-On-Capital-Employed": 4.56,
        "Tangible-Assets": 3140950,
        "Interest-Coverage-Ratio": 10.271861233480177,
        "Equity-Paid-Up": 535500,
        "Inventory-Turnover-Ratio": 13.22444229772862,
        "Cash-Conversion-Cycle": 22.79901508832075,
        "Total-Liabilities": 7121472,
        "Gearing-Liability-Basis": 212.65,
        "Cash-To-Current-Liabilities-Ratio": 0.3983781686946436,
        "Retained-Profit": -132825,
        "Operating-Profit": 186537,
        "Total-Long-Term-Loans": 950000,
        "Trade-Debtors": 1594061,
        "Bank-Loan": 50000,
        "Total-Assets": 10470360,
        "Trade-Creditors": 3844979,
        "Total-Current-Liabilities": 5936869,
        "Investment-And-Other": 0,
        "Gross-Profit": 4985477,
        "Working-Capital": 1392541
    }
}

GET https://api.globaldatabase.com/v2/financial/{id}

View company financials

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
year	body	int	false	Year
include_provenance	params	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Response Properties

Company Financials by Ticker

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/financial/ticker?ticker=AAPL' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

{
    "2025-09-30": {
        "EBIT": 133050000000,
        "EBITDA": 144748000000,
        "Leases": 15091000000,
        "NetPPE": 49834000000,
        "symbol": "AAPL",
        "NetDebt": 62723000000,
        "BasicEPS": 7.49,
        "Goodwill": null,
        "GrossPPE": 125848000000,
        "Payables": 82876000000,
        "WriteOff": null,
        "Depletion": null,
        "Inventory": 5718000000,
        "NetIncome": 112010000000,
        "SaleOfPPE": null,
        "TotalDebt": 98657000000,
        "DilutedEPS": 7.46,
        "OtherGandA": null,
        "OtherTaxes": null,
        "Properties": 0,
        "CommonStock": 93568000000,
        "CurrentDebt": 20329000000,
        "DeferredTax": null,
        "ExciseTaxes": null,
        "GrossProfit": 195201000000,
        "Receivables": 72957000000,
        "ShareIssued": 14773260000,
        "TotalAssets": 359241000000,
        "report_type": "12M",
        "Amortization": null,
        "CapitalStock": 93568000000,
        "Depreciation": null,
        "FreeCashFlow": 98767000000,
        "LineOfCredit": null,
        "LongTermDebt": 78328000000,
        "OtherPayable": null,
        "PretaxIncome": 132729000000,
        "RawMaterials": null,
        "TaxProvision": 20719000000,
        "TotalRevenue": 416161000000,
        "CashFinancial": 28267000000,
        "ChangesInCash": 5991000000,
        "CostOfRevenue": 220960000000,
        "CurrentAssets": 147957000000,
        "FinishedGoods": null,
        "PrepaidAssets": null,
        "PurchaseOfPPE": -12715000000,
        "TotalExpenses": 283111000000,
        "TreasuryStock": null,
        "WorkInProcess": null,
        "currency_code": "USD",
        "InterestIncome": null,
        "IssuanceOfDebt": 4481000000,
        "PreferredStock": null,
        "RestrictedCash": null,
        "SaleOfBusiness": null,
        "WorkingCapital": -17674000000,
        "AccountsPayable": 69860000000,
        "CashEquivalents": 7667000000,
        "ChangeInPayable": 902000000,
        "CommercialPaper": 7979000000,
        "DividendPaidCFO": null,
        "EndCashPosition": 35934000000,
        "FinancialAssets": null,
        "GainOnSaleOfPPE": null,
        "InterestExpense": null,
        "InterestPaidCFF": null,
        "InterestPaidCFO": null,
        "InterestPayable": null,
        "InvestedCapital": 172390000000,
        "LoansReceivable": null,
        "NotesReceivable": null,
        "OperatingIncome": 133050000000,
        "OtherProperties": null,
        "RepaymentOfDebt": -10932000000,
        "TaxRateForCalcs": 0.156,
        "TaxesReceivable": null,
        "TaxesRefundPaid": null,
        "TotalTaxPayable": 13016000000,
        "DividendsPayable": null,
        "EmployeeBenefits": null,
        "IncomeTaxPayable": 13016000000,
        "MinorityInterest": null,
        "NormalizedEBITDA": 144748000000,
        "NormalizedIncome": 112010000000,
        "OperatingExpense": 62151000000,
        "OperatingRevenue": 416161000000,
        "OtherInventories": null,
        "OtherInvestments": null,
        "OtherReceivables": 33180000000,
        "RetainedEarnings": -14264000000,
        "SalariesAndWages": null,
        "SaleOfInvestment": 53797000000,
        "CashDividendsPaid": -15421000000,
        "ChangeInInventory": 1400000000,
        "CommonStockEquity": 73733000000,
        "CurrentProvisions": null,
        "DeferredIncomeTax": null,
        "FinancingCashFlow": -120686000000,
        "InvestingCashFlow": 15195000000,
        "MinorityInterests": null,
        "NetInterestIncome": null,
        "NetTangibleAssets": 73733000000,
        "OperatingCashFlow": 111482000000,
        "OtherCapitalStock": null,
        "OtherNonCashItems": -89000000,
        "SaleOfIntangibles": null,
        "TangibleBookValue": 73733000000,
        "TotalUnusualItems": null,
        "TradingSecurities": null,
        "AccountsReceivable": 39777000000,
        "BasicAverageShares": 14948500000,
        "CapitalExpenditure": -12715000000,
        "ChangeInTaxPayable": null,
        "CurrentLiabilities": 165631000000,
        "InsuranceAndClaims": null,
        "InterestPaidDirect": null,
        "LongTermProvisions": null,
        "OtherCurrentAssets": 14585000000,
        "OtherIncomeExpense": -321000000,
        "PurchaseOfBusiness": null,
        "RentAndLandingFees": null,
        "StockholdersEquity": 73733000000,
        "UnrealizedGainLoss": null,
        "ChangeInReceivables": -7029000000,
        "CommonStockIssuance": null,
        "CommonStockPayments": -90711000000,
        "CurrentNotesPayable": null,
        "DividendReceivedCFO": null,
        "DividendsPaidDirect": null,
        "GainLossOnSaleOfPPE": null,
        "InterestReceivedCFI": null,
        "InterestReceivedCFO": null,
        "LandAndImprovements": 27337000000,
        "OtherEquityInterest": null,
        "OtherSpecialCharges": null,
        "TotalCapitalization": 152061000000,
        "AmortizationCashFlow": null,
        "DilutedAverageShares": 15004697000,
        "DividendsReceivedCFI": null,
        "GainOnSaleOfBusiness": null,
        "GainOnSaleOfSecurity": null,
        "HedgingAssetsCurrent": null,
        "InvestmentProperties": null,
        "LongTermDebtIssuance": 4481000000,
        "LongTermDebtPayments": -10932000000,
        "OperatingGainsLosses": null,
        "OrdinarySharesNumber": 14773260000,
        "PreferredStockEquity": null,
        "PurchaseOfInvestment": -24407000000,
        "SpecialIncomeCharges": null,
        "TreasurySharesNumber": null,
        "AssetImpairmentCharge": null,
        "BeginningCashPosition": 29943000000,
        "ChangeInPrepaidAssets": null,
        "ClassesofCashPayments": null,
        "DefinedPensionBenefit": null,
        "NetPPEPurchaseAndSale": -12715000000,
        "OtherIntangibleAssets": null,
        "OtherNonCurrentAssets": 62950000000,
        "PreferredSharesNumber": null,
        "PurchaseOfIntangibles": null,
        "ReceiptsfromCustomers": null,
        "RestrictedCommonStock": null,
        "ShortTermDebtIssuance": null,
        "ShortTermDebtPayments": null,
        "TaxesRefundPaidDirect": null,
        "TotalNonCurrentAssets": 211284000000,
        "TotalOtherFinanceCost": null,
        "CashAndCashEquivalents": 35934000000,
        "ChangeInAccountPayable": 902000000,
        "ChangeInAccruedExpense": null,
        "ChangeInWorkingCapital": -25000000000,
        "ConstructionInProgress": null,
        "CurrentAccruedExpenses": 8919000000,
        "CurrentDeferredRevenue": 9055000000,
        "InterestReceivedDirect": null,
        "InvestmentsAndAdvances": 77723000000,
        "IssuanceOfCapitalStock": null,
        "NetCommonStockIssuance": -90711000000,
        "NetIncomeExtraordinary": null,
        "OtherCurrentBorrowings": 12350000000,
        "OtherEquityAdjustments": -5571000000,
        "OtherOperatingExpenses": null,
        "PreferredStockIssuance": null,
        "PreferredStockPayments": null,
        "ReconciledDepreciation": 11698000000,
        "ResearchAndDevelopment": 34550000000,
        "SecuritiesAmortization": null,
        "StockBasedCompensation": 12863000000,
        "AccumulatedDepreciation": -76014000000,
        "AdditionalPaidInCapital": null,
        "AverageDilutionEarnings": null,
        "CapitalLeaseObligations": null,
        "ChangeInDividendPayable": null,
        "ChangeInInterestPayable": null,
        "CommonStockDividendPaid": -15421000000,
        "DividendsReceivedDirect": null,
        "GrossAccountsReceivable": null,
        "NetLongTermDebtIssuance": -6451000000,
        "NonCurrentPrepaidAssets": null,
        "OtherCurrentLiabilities": 44452000000,
        "PreferredStockDividends": null,
        "ReconciledCostOfRevenue": 220960000000,
        "RentExpenseSupplemental": null,
        "TaxEffectOfUnusualItems": 0,
        "TotalPartnershipCapital": null,
        "AmortizationOfSecurities": null,
        "AssetsHeldForSaleCurrent": null,
        "BuildingsAndImprovements": null,
        "ChangeInIncomeTaxPayable": null,
        "DepletionIncomeStatement": null,
        "GainLossOnSaleOfBusiness": null,
        "HeldToMaturitySecurities": null,
        "LongTermEquityInvestment": null,
        "NetOtherFinancingCharges": -6071000000,
        "NetOtherInvestingChanges": -1480000000,
        "NetShortTermDebtIssuance": -2032000000,
        "NonCurrentDeferredAssets": 20777000000,
        "RepurchaseOfCapitalStock": -90711000000,
        "AccruedInterestReceivable": null,
        "AmortizationOfIntangibles": null,
        "GeneralPartnershipCapital": null,
        "ImpairmentOfCapitalAssets": null,
        "LimitedPartnershipCapital": null,
        "MinimumPensionLiabilities": null,
        "NetIssuancePaymentsOfDebt": -8483000000,
        "NetPreferredStockIssuance": null,
        "NonCurrentAccruedExpenses": null,
        "NonCurrentDeferredRevenue": null,
        "NonCurrentNoteReceivables": null,
        "OtherShortTermInvestments": 18763000000,
        "AvailableForSaleSecurities": 77723000000,
        "CapitalExpenditureReported": null,
        "ChangeInOtherCurrentAssets": -9197000000,
        "CurrentDeferredTaxesAssets": null,
        "DuetoRelatedPartiesCurrent": null,
        "EarningsFromEquityInterest": null,
        "InterestIncomeNonOperating": null,
        "NetBusinessPurchaseAndSale": null,
        "OtherNonCurrentLiabilities": 41549000000,
        "PayablesAndAccruedExpenses": 91795000000,
        "PreferredStockDividendPaid": null,
        "SaleOfInvestmentProperties": null,
        "SellingAndMarketingExpense": null,
        "ChangeInOtherWorkingCapital": null,
        "ChangesInAccountReceivables": -6682000000,
        "DepreciationAndAmortization": 11698000000,
        "DepreciationIncomeStatement": null,
        "EffectOfExchangeRateChanges": null,
        "InterestExpenseNonOperating": null,
        "InvestmentinFinancialAssets": 77723000000,
        "MachineryFurnitureEquipment": 83420000000,
        "NetIncomeCommonStockholders": 112010000000,
        "PaymentsonBehalfofEmployees": null,
        "DerivativeProductLiabilities": null,
        "DuefromRelatedPartiesCurrent": null,
        "InterestPaidSupplementalData": null,
        "NetInvestmentPurchaseAndSale": 29390000000,
        "NonCurrentAccountsReceivable": null,
        "ProvisionForDoubtfulAccounts": null,
        "ProvisionandWriteOffofAssets": null,
        "ReceiptsfromGovernmentGrants": null,
        "CurrentCapitalLeaseObligation": null,
        "DuetoRelatedPartiesNonCurrent": null,
        "FixedAssetsRevaluationReserve": null,
        "IncomeTaxPaidSupplementalData": 43369000000,
        "InvestmentsinAssociatesatCost": null,
        "NetIncomeContinuousOperations": 112010000000,
        "NetIntangiblesPurchaseAndSale": null,
        "NonCurrentDeferredLiabilities": null,
        "NonCurrentDeferredTaxesAssets": 20777000000,
        "GainLossOnInvestmentSecurities": null,
        "LongTermCapitalLeaseObligation": null,
        "PurchaseOfInvestmentProperties": null,
        "TotalOperatingIncomeAsReported": 133050000000,
        "ChangeInOtherCurrentLiabilities": -11076000000,
        "CurrentDeferredTaxesLiabilities": null,
        "DilutedNIAvailtoComStockholders": 112010000000,
        "DuefromRelatedPartiesNonCurrent": null,
        "GeneralAndAdministrativeExpense": null,
        "InvestmentsinSubsidiariesatCost": null,
        "OtherNonOperatingIncomeExpenses": -321000000,
        "SellingGeneralAndAdministration": 27601000000,
        "TradeandOtherPayablesNonCurrent": null,
        "GoodwillAndOtherIntangibleAssets": null,
        "InventoriesAdjustmentsAllowances": null,
        "InvestmentsinJointVenturesatCost": null,
        "LiabilitiesHeldforSaleNonCurrent": null,
        "NetIncomeDiscontinuousOperations": null,
        "NetIncomeFromTaxLossCarryforward": null,
        "OtherunderPreferredStockDividend": null,
        "PensionAndEmployeeBenefitExpense": null,
        "ProceedsFromStockOptionExercised": null,
        "ReceivablesAdjustmentsAllowances": null,
        "TotalEquityGrossMinorityInterest": 73733000000,
        "CashFlowFromDiscontinuedOperation": null,
        "ChangeInPayablesAndAccruedExpense": 902000000,
        "DepreciationAmortizationDepletion": 11698000000,
        "NetIncomeFromContinuingOperations": 112010000000,
        "EarningsFromEquityInterestNetOfTax": null,
        "NetForeignCurrencyExchangeGainLoss": null,
        "NonCurrentDeferredTaxesLiabilities": null,
        "RestructuringAndMergernAcquisition": null,
        "TotalUnusualItemsExcludingGoodwill": null,
        "EarningsLossesFromEquityInvestments": null,
        "TotalLiabilitiesNetMinorityInterest": 285508000000,
        "CurrentDebtAndCapitalLeaseObligation": 20329000000,
        "NetNonOperatingInterestIncomeExpense": null,
        "ForeignCurrencyTranslationAdjustments": null,
        "LongTermDebtAndCapitalLeaseObligation": 78328000000,
        "OtherCashAdjustmentInsideChangeinCash": null,
        "PreferredSecuritiesOutsideStockEquity": null,
        "AllowanceForDoubtfulAccountsReceivable": null,
        "NetInvestmentPropertiesPurchaseAndSale": null,
        "OtherCashAdjustmentOutsideChangeinCash": null,
        "PaymentstoSuppliersforGoodsandServices": null,
        "CashFromDiscontinuedFinancingActivities": null,
        "CashFromDiscontinuedInvestingActivities": null,
        "CashFromDiscontinuedOperatingActivities": null,
        "GainsLossesNotAffectingRetainedEarnings": -5571000000,
        "AmortizationOfIntangiblesIncomeStatement": null,
        "OtherCashPaymentsfromOperatingActivities": null,
        "OtherCashReceiptsfromOperatingActivities": null,
        "UnrealizedGainLossOnInvestmentSecurities": null,
        "CashFlowFromContinuingFinancingActivities": -120686000000,
        "CashFlowFromContinuingInvestingActivities": 15195000000,
        "CashFlowFromContinuingOperatingActivities": 111482000000,
        "NetIncomeIncludingNoncontrollingInterests": 112010000000,
        "CashCashEquivalentsAndShortTermInvestments": 54697000000,
        "ExcessTaxBenefitFromStockBasedCompensation": null,
        "InvestmentsInOtherVenturesUnderEquityMethod": null,
        "CashFlowsfromusedinOperatingActivitiesDirect": null,
        "DepreciationAndAmortizationInIncomeStatement": null,
        "TotalNonCurrentLiabilitiesNetMinorityInterest": 119877000000,
        "NetIncomeFromContinuingAndDiscontinuedOperation": 112010000000,
        "DepreciationAmortizationDepletionIncomeStatement": null,
        "PensionandOtherPostRetirementBenefitPlansCurrent": null,
        "NetIncomeFromContinuingOperationNetMinorityInterest": 112010000000,
        "NonCurrentPensionAndOtherPostretirementBenefitPlans": null,
        "FinancialAssetsDesignatedasFairValueThroughProfitorLossTotal": null
    },
    "2024-09-28": {
        "EBIT": 119437000000,
        "EBITDA": 130541000000,
        "Leases": 15091000000,
        "NetPPE": 49834000000,
        "symbol": "AAPL",
        "NetDebt": 62723000000,
        "BasicEPS": 6.16,
        "Goodwill": null,
        "GrossPPE": 125848000000,
        "Payables": 82876000000,
        "WriteOff": null,
        "Depletion": null,
        "Inventory": 5718000000,
        "NetIncome": 99803000000,
        "SaleOfPPE": null,
        "TotalDebt": 98657000000,
        "DilutedEPS": 6.13,
        "OtherGandA": null,
        "OtherTaxes": null,
        "Properties": 0,
        "CommonStock": 93568000000,
        "CurrentDebt": 20329000000,
        "DeferredTax": null,
        "ExciseTaxes": null,
        "GrossProfit": 195201000000,
        "Receivables": 72957000000,
        "ShareIssued": 14773260000,
        "TotalAssets": 352583000000,
        "report_type": "12M",
        "Amortization": null,
        "CapitalStock": 93568000000,
        "Depreciation": null,
        "FreeCashFlow": 98767000000,
        "LineOfCredit": null,
        "LongTermDebt": 78328000000,
        "OtherPayable": null,
        "PretaxIncome": 132729000000,
        "RawMaterials": null,
        "TaxProvision": 20719000000,
        "TotalRevenue": 391035000000,
        "CashFinancial": 28267000000,
        "ChangesInCash": 5991000000,
        "CostOfRevenue": 220960000000,
        "CurrentAssets": 147957000000,
        "FinishedGoods": null,
        "PrepaidAssets": null,
        "PurchaseOfPPE": -12715000000,
        "TotalExpenses": 283111000000,
        "TreasuryStock": null,
        "WorkInProcess": null,
        "currency_code": "USD",
        "InterestIncome": null,
        "IssuanceOfDebt": 4481000000,
        "PreferredStock": null,
        "RestrictedCash": null,
        "SaleOfBusiness": null,
        "WorkingCapital": -17674000000,
        "AccountsPayable": 69860000000,
        "CashEquivalents": 7667000000,
        "ChangeInPayable": 902000000,
        "CommercialPaper": 7979000000,
        "DividendPaidCFO": null,
        "EndCashPosition": 35934000000,
        "FinancialAssets": null,
        "GainOnSaleOfPPE": null,
        "InterestExpense": null,
        "InterestPaidCFF": null,
        "InterestPaidCFO": null,
        "InterestPayable": null,
        "InvestedCapital": 172390000000,
        "LoansReceivable": null,
        "NotesReceivable": null,
        "OperatingIncome": 133050000000,
        "OtherProperties": null,
        "RepaymentOfDebt": -10932000000,
        "TaxRateForCalcs": 0.156,
        "TaxesReceivable": null,
        "TaxesRefundPaid": null,
        "TotalTaxPayable": 13016000000,
        "DividendsPayable": null,
        "EmployeeBenefits": null,
        "IncomeTaxPayable": 13016000000,
        "MinorityInterest": null,
        "NormalizedEBITDA": 144748000000,
        "NormalizedIncome": 112010000000,
        "OperatingExpense": 62151000000,
        "OperatingRevenue": 416161000000,
        "OtherInventories": null,
        "OtherInvestments": null,
        "OtherReceivables": 33180000000,
        "RetainedEarnings": -14264000000,
        "SalariesAndWages": null,
        "SaleOfInvestment": 53797000000,
        "CashDividendsPaid": -15421000000,
        "ChangeInInventory": 1400000000,
        "CommonStockEquity": 73733000000,
        "CurrentProvisions": null,
        "DeferredIncomeTax": null,
        "FinancingCashFlow": -120686000000,
        "InvestingCashFlow": 15195000000,
        "MinorityInterests": null,
        "NetInterestIncome": null,
        "NetTangibleAssets": 73733000000,
        "OperatingCashFlow": 111482000000,
        "OtherCapitalStock": null,
        "OtherNonCashItems": -89000000,
        "SaleOfIntangibles": null,
        "TangibleBookValue": 73733000000,
        "TotalUnusualItems": null,
        "TradingSecurities": null,
        "AccountsReceivable": 39777000000,
        "BasicAverageShares": 14948500000,
        "CapitalExpenditure": -12715000000,
        "ChangeInTaxPayable": null,
        "CurrentLiabilities": 165631000000,
        "InsuranceAndClaims": null,
        "InterestPaidDirect": null,
        "LongTermProvisions": null,
        "OtherCurrentAssets": 14585000000,
        "OtherIncomeExpense": -321000000,
        "PurchaseOfBusiness": null,
        "RentAndLandingFees": null,
        "StockholdersEquity": 73733000000,
        "UnrealizedGainLoss": null,
        "ChangeInReceivables": -7029000000,
        "CommonStockIssuance": null,
        "CommonStockPayments": -90711000000,
        "CurrentNotesPayable": null,
        "DividendReceivedCFO": null,
        "DividendsPaidDirect": null,
        "GainLossOnSaleOfPPE": null,
        "InterestReceivedCFI": null,
        "InterestReceivedCFO": null,
        "LandAndImprovements": 27337000000,
        "OtherEquityInterest": null,
        "OtherSpecialCharges": null,
        "TotalCapitalization": 152061000000,
        "AmortizationCashFlow": null,
        "DilutedAverageShares": 15004697000,
        "DividendsReceivedCFI": null,
        "GainOnSaleOfBusiness": null,
        "GainOnSaleOfSecurity": null,
        "HedgingAssetsCurrent": null,
        "InvestmentProperties": null,
        "LongTermDebtIssuance": 4481000000,
        "LongTermDebtPayments": -10932000000,
        "OperatingGainsLosses": null,
        "OrdinarySharesNumber": 14773260000,
        "PreferredStockEquity": null,
        "PurchaseOfInvestment": -24407000000,
        "SpecialIncomeCharges": null,
        "TreasurySharesNumber": null,
        "AssetImpairmentCharge": null,
        "BeginningCashPosition": 29943000000,
        "ChangeInPrepaidAssets": null,
        "ClassesofCashPayments": null,
        "DefinedPensionBenefit": null,
        "NetPPEPurchaseAndSale": -12715000000,
        "OtherIntangibleAssets": null,
        "OtherNonCurrentAssets": 62950000000,
        "PreferredSharesNumber": null,
        "PurchaseOfIntangibles": null,
        "ReceiptsfromCustomers": null,
        "RestrictedCommonStock": null,
        "ShortTermDebtIssuance": null,
        "ShortTermDebtPayments": null,
        "TaxesRefundPaidDirect": null,
        "TotalNonCurrentAssets": 211284000000,
        "TotalOtherFinanceCost": null,
        "CashAndCashEquivalents": 35934000000,
        "ChangeInAccountPayable": 902000000,
        "ChangeInAccruedExpense": null,
        "ChangeInWorkingCapital": -25000000000,
        "ConstructionInProgress": null,
        "CurrentAccruedExpenses": 8919000000,
        "CurrentDeferredRevenue": 9055000000,
        "InterestReceivedDirect": null,
        "InvestmentsAndAdvances": 77723000000,
        "IssuanceOfCapitalStock": null,
        "NetCommonStockIssuance": -90711000000,
        "NetIncomeExtraordinary": null,
        "OtherCurrentBorrowings": 12350000000,
        "OtherEquityAdjustments": -5571000000,
        "OtherOperatingExpenses": null,
        "PreferredStockIssuance": null,
        "PreferredStockPayments": null,
        "ReconciledDepreciation": 11698000000,
        "ResearchAndDevelopment": 34550000000,
        "SecuritiesAmortization": null,
        "StockBasedCompensation": 12863000000,
        "AccumulatedDepreciation": -76014000000,
        "AdditionalPaidInCapital": null,
        "AverageDilutionEarnings": null,
        "CapitalLeaseObligations": null,
        "ChangeInDividendPayable": null,
        "ChangeInInterestPayable": null,
        "CommonStockDividendPaid": -15421000000,
        "DividendsReceivedDirect": null,
        "GrossAccountsReceivable": null,
        "NetLongTermDebtIssuance": -6451000000,
        "NonCurrentPrepaidAssets": null,
        "OtherCurrentLiabilities": 44452000000,
        "PreferredStockDividends": null,
        "ReconciledCostOfRevenue": 220960000000,
        "RentExpenseSupplemental": null,
        "TaxEffectOfUnusualItems": 0,
        "TotalPartnershipCapital": null,
        "AmortizationOfSecurities": null,
        "AssetsHeldForSaleCurrent": null,
        "BuildingsAndImprovements": null,
        "ChangeInIncomeTaxPayable": null,
        "DepletionIncomeStatement": null,
        "GainLossOnSaleOfBusiness": null,
        "HeldToMaturitySecurities": null,
        "LongTermEquityInvestment": null,
        "NetOtherFinancingCharges": -6071000000,
        "NetOtherInvestingChanges": -1480000000,
        "NetShortTermDebtIssuance": -2032000000,
        "NonCurrentDeferredAssets": 20777000000,
        "RepurchaseOfCapitalStock": -90711000000,
        "AccruedInterestReceivable": null,
        "AmortizationOfIntangibles": null,
        "GeneralPartnershipCapital": null,
        "ImpairmentOfCapitalAssets": null,
        "LimitedPartnershipCapital": null,
        "MinimumPensionLiabilities": null,
        "NetIssuancePaymentsOfDebt": -8483000000,
        "NetPreferredStockIssuance": null,
        "NonCurrentAccruedExpenses": null,
        "NonCurrentDeferredRevenue": null,
        "NonCurrentNoteReceivables": null,
        "OtherShortTermInvestments": 18763000000,
        "AvailableForSaleSecurities": 77723000000,
        "CapitalExpenditureReported": null,
        "ChangeInOtherCurrentAssets": -9197000000,
        "CurrentDeferredTaxesAssets": null,
        "DuetoRelatedPartiesCurrent": null,
        "EarningsFromEquityInterest": null,
        "InterestIncomeNonOperating": null,
        "NetBusinessPurchaseAndSale": null,
        "OtherNonCurrentLiabilities": 41549000000,
        "PayablesAndAccruedExpenses": 91795000000,
        "PreferredStockDividendPaid": null,
        "SaleOfInvestmentProperties": null,
        "SellingAndMarketingExpense": null,
        "ChangeInOtherWorkingCapital": null,
        "ChangesInAccountReceivables": -6682000000,
        "DepreciationAndAmortization": 11698000000,
        "DepreciationIncomeStatement": null,
        "EffectOfExchangeRateChanges": null,
        "InterestExpenseNonOperating": null,
        "InvestmentinFinancialAssets": 77723000000,
        "MachineryFurnitureEquipment": 83420000000,
        "NetIncomeCommonStockholders": 112010000000,
        "PaymentsonBehalfofEmployees": null,
        "DerivativeProductLiabilities": null,
        "DuefromRelatedPartiesCurrent": null,
        "InterestPaidSupplementalData": null,
        "NetInvestmentPurchaseAndSale": 29390000000,
        "NonCurrentAccountsReceivable": null,
        "ProvisionForDoubtfulAccounts": null,
        "ProvisionandWriteOffofAssets": null,
        "ReceiptsfromGovernmentGrants": null,
        "CurrentCapitalLeaseObligation": null,
        "DuetoRelatedPartiesNonCurrent": null,
        "FixedAssetsRevaluationReserve": null,
        "IncomeTaxPaidSupplementalData": 43369000000,
        "InvestmentsinAssociatesatCost": null,
        "NetIncomeContinuousOperations": 112010000000,
        "NetIntangiblesPurchaseAndSale": null,
        "NonCurrentDeferredLiabilities": null,
        "NonCurrentDeferredTaxesAssets": 20777000000,
        "GainLossOnInvestmentSecurities": null,
        "LongTermCapitalLeaseObligation": null,
        "PurchaseOfInvestmentProperties": null,
        "TotalOperatingIncomeAsReported": 133050000000,
        "ChangeInOtherCurrentLiabilities": -11076000000,
        "CurrentDeferredTaxesLiabilities": null,
        "DilutedNIAvailtoComStockholders": 112010000000,
        "DuefromRelatedPartiesNonCurrent": null,
        "GeneralAndAdministrativeExpense": null,
        "InvestmentsinSubsidiariesatCost": null,
        "OtherNonOperatingIncomeExpenses": -321000000,
        "SellingGeneralAndAdministration": 27601000000,
        "TradeandOtherPayablesNonCurrent": null,
        "GoodwillAndOtherIntangibleAssets": null,
        "InventoriesAdjustmentsAllowances": null,
        "InvestmentsinJointVenturesatCost": null,
        "LiabilitiesHeldforSaleNonCurrent": null,
        "NetIncomeDiscontinuousOperations": null,
        "NetIncomeFromTaxLossCarryforward": null,
        "OtherunderPreferredStockDividend": null,
        "PensionAndEmployeeBenefitExpense": null,
        "ProceedsFromStockOptionExercised": null,
        "ReceivablesAdjustmentsAllowances": null,
        "TotalEquityGrossMinorityInterest": 73733000000,
        "CashFlowFromDiscontinuedOperation": null,
        "ChangeInPayablesAndAccruedExpense": 902000000,
        "DepreciationAmortizationDepletion": 11698000000,
        "NetIncomeFromContinuingOperations": 112010000000,
        "EarningsFromEquityInterestNetOfTax": null,
        "NetForeignCurrencyExchangeGainLoss": null,
        "NonCurrentDeferredTaxesLiabilities": null,
        "RestructuringAndMergernAcquisition": null,
        "TotalUnusualItemsExcludingGoodwill": null,
        "EarningsLossesFromEquityInvestments": null,
        "TotalLiabilitiesNetMinorityInterest": 285508000000,
        "CurrentDebtAndCapitalLeaseObligation": 20329000000,
        "NetNonOperatingInterestIncomeExpense": null,
        "ForeignCurrencyTranslationAdjustments": null,
        "LongTermDebtAndCapitalLeaseObligation": 78328000000,
        "OtherCashAdjustmentInsideChangeinCash": null,
        "PreferredSecuritiesOutsideStockEquity": null,
        "AllowanceForDoubtfulAccountsReceivable": null,
        "NetInvestmentPropertiesPurchaseAndSale": null,
        "OtherCashAdjustmentOutsideChangeinCash": null,
        "PaymentstoSuppliersforGoodsandServices": null,
        "CashFromDiscontinuedFinancingActivities": null,
        "CashFromDiscontinuedInvestingActivities": null,
        "CashFromDiscontinuedOperatingActivities": null,
        "GainsLossesNotAffectingRetainedEarnings": -5571000000,
        "AmortizationOfIntangiblesIncomeStatement": null,
        "OtherCashPaymentsfromOperatingActivities": null,
        "OtherCashReceiptsfromOperatingActivities": null,
        "UnrealizedGainLossOnInvestmentSecurities": null,
        "CashFlowFromContinuingFinancingActivities": -120686000000,
        "CashFlowFromContinuingInvestingActivities": 15195000000,
        "CashFlowFromContinuingOperatingActivities": 111482000000,
        "NetIncomeIncludingNoncontrollingInterests": 112010000000,
        "CashCashEquivalentsAndShortTermInvestments": 54697000000,
        "ExcessTaxBenefitFromStockBasedCompensation": null,
        "InvestmentsInOtherVenturesUnderEquityMethod": null,
        "CashFlowsfromusedinOperatingActivitiesDirect": null,
        "DepreciationAndAmortizationInIncomeStatement": null,
        "TotalNonCurrentLiabilitiesNetMinorityInterest": 119877000000,
        "NetIncomeFromContinuingAndDiscontinuedOperation": 112010000000,
        "DepreciationAmortizationDepletionIncomeStatement": null,
        "PensionandOtherPostRetirementBenefitPlansCurrent": null,
        "NetIncomeFromContinuingOperationNetMinorityInterest": 112010000000,
        "NonCurrentPensionAndOtherPostretirementBenefitPlans": null,
        "FinancialAssetsDesignatedasFairValueThroughProfitorLossTotal": null
    }
}

GET https://api.globaldatabase.com/v2/financial/ticker

View public company financials by stock ticker across multiple reporting periods

Parameters

Parameter	In	Type	Required	Description
ticker	query	string	true	Ticker

Response Properties

Digital Insights API

The Digital Insights API showcases a company’s used technologies such as used Analytical tools, technologies used to build their website, Payment systems utilized, and much more from a selection of over 880 tracked technologies. For example, your sales team will appreciate the additional personalization their email will now contain when they reach out to potential customers o propose your product or solution.

Search Company for Digital Insights

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/digital-insights' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "NOVATECH LIMITED"
}'

Request example

{
    "name": "NOVATECH LIMITED"
}

Success Response

[
    {
        "id": "20581257",
        "name": "NOVATECH LIMITED",
        "country_code": "GB",
        "registration_number": "02605046"
    },
    //...
]

Error Response

{
    "fields": [
        "Choose one or more of these fields ['name', 'registration_number']."
    ]
}

POST https://api.globaldatabase.com/v2/digital-insights

View search company for digital insights

Parameters

Parameter	In	Type	Required	Description
name	body	string	false	Company Name
registration_number	body	string	false	Registration Number

Company Digital Insights

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/digital-insights/20581257' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 20581257
}

Success Response

{
    "domain": "novatech.co.uk",
    "id": 308874,
    "nameservers": "hank.ns.cloudflare.com",
    "mx_list": [
        "novatech.co.uk.p10.mxguardian.net."
    ],
    "contact_city": null,
    "contact_country": null,
    "contact_email": null,
    "contact_name": null,
    "contact_phone": null,
    "contact_postalcode": null,
    "contact_state": null,
    "contact_street": null,
    "contact_organization": null,
    "raw": "TEXT",
    "expiration_date": "2025-09-10T00:00:00",
    "created_at": "2020-09-14T13:01:15.482566",
    "ip": "104.20.46.31",
    "isp_name": "CLOUDFLARENET",
    "isp_country": "United States",
    "domain_creation_date": "1996-08-28",
    "domain_name": "novatech.co.uk",
    "engagement_bounce_rate": "0.5325903646130219",
    "engagement_page_views": 1140537.0,
    "engagement_time_on_site": "00:02:55",
    "engagement_total_visits": 303228,
    "engagement_total_relative_change": null,
    "global_rank": 119775,
    "global_rank_change": null,
    "category_rank": 4691,
    "category_rank_change": null,
    "country_rank": 6453,
    "country_rank_change": null,
    "similar_date": "2020-08-01T00:00:00",
    "redirect_url": null,
    "icon_url": "https://site-images.similarcdn.com/image?url=novatech.co.uk&t=1&h=f7a9874c2d9d3d85da032c743400e1f36a6fd02adc1ff24472192000f2c188c3",
    "top_country_shares": [
        {
            "id": 33832425,
            "similar_country_id": 826,
            "share_percent": 0.803093404605964,
            "share_change": null,
            "name": "United Kingdom",
            "similar_web_data_id": 16075338
        },
        //...
    ],
    "referrals": [],
    "keywords": [],
    "referrals_destination": [],
    "visits": [
        {
            "id": 1679,
            "similar_web_data_id": 378,
            "date_value": "2016-07-01",
            "value": 1141493
        },
        //...
    ],
    "stat_organic_search": 162916,
    "stat_organic_search_percent": 53.7,
    "stat_direct": 107862,
    "stat_direct_percent": 35.6,
    "stat_referral": 7253,
    "stat_referral_percent": 2.4,
    "technologies": [
        {
            "id": 2,
            "list": [
                {
                    "id": 2,
                    "name": "Google Analytics",
                    "image_path": "tech/1.png",
                    "description": "Google Analytics is a service offered by ...",
                    "category": 2
                },
                //...
            ],
            "name": "Analytics",
            "parent_id": null,
            "important": false
        },
        //...
    ],
    "graph": {
        "visits": {
            "categories": [],
            "data": [
                [
                    "2016-07-01",
                    1141493
                ],
                //..
            ]
        },
        "sources": {
            "organic": [
                [
                    "2016-07-01",
                    613294.0
                ],
                //..
            ],
            "direct": [
                [
                    "2016-07-01",
                    406046.0
                ],
               //..
            ],
            "referral": [
                [
                    "2016-07-01",
                    27305.0
                ],
                //...
            ]
        }
    },
    "total_traffic": 30806206,
    "up_visits": false,
    "alexa_rank": 140443
}

GET https://api.globaldatabase.com/v2/digital-insights/{id}

View company digital insights

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID

Ownership API

The Ownership API indicated the complete group structure and beneficial owners of a particular business.

Search Company for Ownership

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/ownership' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "BANDENIA GATEWAY LTD"
}'

Request example

{
    "name": "BANDENIA GATEWAY LTD"
}

Success Response

[
    {
        "id": "28672740",
        "name": "BANDENIA GATEWAY LTD",
        "country_code": "GB",
        "registration_number": "08588209"
    },
    {
        "id": "30303326",
        "name": "BANDENIA GROUP GATEWAY TAK LTD",
        "country_code": "GB",
        "registration_number": "09877665"
    },
    //...
]

Error Response

{
    "fields": [
        "Choose one or more of these fields ['name', 'registration_number']."
    ]
}

POST https://api.globaldatabase.com/v2/ownership

View search company for ownership

Parameters

Parameter	In	Type	Required	Description
name	body	string	false	Company Name
registration_number	body	string	false	Registration Number

Company Ownership

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/ownership/28672740' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 28672740
}

Success Response

{
    "shareholders": [
        {
            "id": 45048908,
            "name": "BANDENIA BANQUEROS PRIVADOS INC",
            "quantity": 530000,
            "currency": "GBP",
            "share_value": "530,000 ORDINARY  GBP 1.00",
            "created_at": "2022-02-03T17:29:01.696+0000",
            "share_type": "ORDINARY",
            "share_price": 1.0
        },
        {
            "id": 45048909,
            "name": "BANDENIA FINANCIAL GROUP INC",
            "quantity": 1700000,
            "currency": "GBP",
            "share_value": "1,700,000 ORDINARY  GBP 1.00",
            "created_at": "2022-02-03T17:29:01.698+0000",
            "share_type": "ORDINARY",
            "share_price": 1.0
        },
        //...
    ],
    "data": [],
    "group_structure": [
        {
            "id": 28672740,
            "registration_number": "IE673949",
            "selected": false,
            "name": "BANDENIA GLOBAL LIMITED",
            "children": [
                {
                    "id": 25330406,
                    "registration_number": "06016301",
                    "selected": false,
                    "name": "BANDENIA FIDUCIARY MANAGEMENT LTD",
                    "children": []
                },
                {
                    "id": 28672740,
                    "registration_number": "08588209",
                    "selected": true,
                    "name": "BANDENIA GATEWAY LTD",
                    "children": []
                },
                {
                    "id": 29380240,
                    "registration_number": "09150992",
                    "selected": false,
                    "name": "BANDENIA OIL AND GAS LTD",
                    "children": []
                },
                //...
            ]
        }
    ],
    "registration_number": "08588209"
}

GET https://api.globaldatabase.com/v2/ownership/{id}

View company ownership

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID

KYB API

The KYB API delivers real-time, registry-sourced company verification across 200+ countries, providing complete legal entity details, company status, directors, shareholders, ownership structures, ultimate beneficial owners, VAT/tax IDs, and financial statements. By connecting directly to official government registries and returning everything in one standardized format, the API enables fast, accurate onboarding, supplier due-diligence, and automated compliance workflows with up-to-date and reliable business intelligence.

Search KYB

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/kyb/search' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "GLOBAL DATA INTELLIGENCE",
    "location": "GB"
}'

Request example

{
  "name": "GLOBAL DATA INTELLIGENCE",
  "location": "GB"
}

Request example — with provenance

{
  "name": "GLOBAL DATA INTELLIGENCE",
  "location": "GB",
  "include_provenance": "true"
}

Request example — with jurisdiction

{
  "name": "Shopify",
  "location": "CA",
  "jurisdiction": "ON"
}

Success Response — default

[
  {
    "id": "29707645",
    "name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "registration_number": "09410808",
    "vat_number": "GB260423730",
    "country_code": "GB",
    "state": "Northamptonshire",
    "jurisdiction": null
  }
  // ... more matching companies
]

Success Response — with provenance

[
  {
    "country_code": "GB",
    "id": 29707645,
    "jurisdiction": null,
    "name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "registration_number": "09410808",
    "source": {
      "category": "Government Registry",
      "comment": "Offical registry data",
      "id": 197,
      "name": "Companies House",
      "url": "https://find-and-update.company-information.service.gov.uk"
    },
    "state": "Northamptonshire",
    "vat_number": "GB260423730"
  }
  // ... more matching companies
]

POST https://api.globaldatabase.com/v2/kyb/search

Search for companies by name, registration number, or VAT/EIN to retrieve their basic identification details. This is typically the first step in any KYB workflow—use it to find the correct company record before pulling detailed information. The endpoint returns a list of matching companies with their unique IDs, which you'll use in subsequent calls.

Common use cases:

• Company search during customer onboarding
• Vendor verification before due diligence
• Finding the correct entity when multiple companies share similar names

Parameters

Parameter	In	Type	Required	Description
name	body	string	false	Company Name
registration_number	body	string	false	Registration Number
vat_number	body	string	false	VAT Number / EIN Number
ticker	body	string	false	Ticker
location	body	string	true	Company location. Accepts one of three formats: nomenclature parent id from KYB Countries / KYB Regions (e.g. "1219916_1800795"), ISO 2-letter country code (e.g. "GB", "HK"), or country-state code for US, CA, CN (e.g. "US-CA", "CA-ON", "CN-BJ").
jurisdiction	body	string	false	Narrow results to the companies registered in one jurisdiction of the location. 2-letter region code from KYB Jurisdictions (e.g. "ON", "DE", "BJ"). Only US, CA and CN have jurisdictions.
city_or_state	body	array of strings	false	Narrow results by city or state name. Array of strings (e.g. ["London"], ["California", "Texas"]).
include_provenance	body	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Validation Rules

• Required field: location — The company location must always be provided. One of the following formats:

  • Nomenclature parent id — id value from KYB Countries or KYB Regions (e.g. "1219916_1800795", "1869197_1869198_3210114").
  • ISO country code — 2-letter country code (e.g. "GB", "HK", "DE").
  • Country-state code — - for countries with sub-divisions in nomenclature (US, CA, CN). Examples: "US-CA" (California), "CA-ON" (Ontario), "CN-BJ" (Beijing).

• Optional field: jurisdiction — Must be one of the code values returned by KYB Jurisdictions for the country of location, case-insensitive. When location is a state (e.g. "US-DE"), only that state's code is accepted. A jurisdiction outside the location is rejected with a 400 that lists the available codes:

  {
    "jurisdiction": [
      "Invalid jurisdiction 'MX' for this location. Available: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT."
    ]
  }
  

  A location without jurisdictions (any country other than US, CA, CN) returns "This location has no jurisdictions."

• Conditional requirement: At least one of the following fields must be provided in the request body:

  • name — Company name
  • registration_number — Registration number
  • vat_number — VAT number
  • ticker — Ticker

Note: Requests that do not include location or at least one of name, registration_number, or vat_number will be rejected with a validation error. A location value that does not match any of the three accepted formats, or matches the format but is not found in the nomenclature, returns a validation error.

Examples:

• { "name": "Apple", "location": "US-CA" }
• { "name": "HSBC", "location": "HK" }
• { "name": "Global Data", "location": "1219916_1800795" }
• { "name": "Global Data", "location": "GB", "city_or_state": ["London"] }
• { "name": "Shopify", "location": "CA", "jurisdiction": "ON" }

Lite KYB

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/kyb/29707645/lite' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 29707645
}

Request example — with provenance

{
  "id": 29707645,
  "include_provenance": "true"
}

Success Response — default

{
  "id": "29707645",
  "name": "GLOBAL DATA INTELLIGENCE LIMITED",
  "registration_number": "09410808",
  "vat_number": "GB260423730",
  "incorporation_date": "2015-01-28",
  "status": "Active",
  "country_code": "GB",
  "country_name": "United Kingdom",
  "country_region": "Northamptonshire",
  "address_street": "Artisans' House",
  "address_location": "7 Queensbridge",
  "address_city": "Northampton",
  "zip_code": "NN4 7BF",
  "legal_form": "Private limited company (Ltd.)",
  "website": "https://www.globaldatabase.com/",
  "linkedin": "linkedin.com/company/global-database",
  "ticker": null,
  "jurisdiction": null
}

Success Response — with provenance

{
  "id": 29707645,
  "basic": {
    "name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "registration_number": "09410808",
    "vat_number": "GB260423730",
    "incorporation_date": "2015-01-28",
    "status": "Active",
    "legal_form": "Private limited company (Ltd.)",
    "source": {
      "category": "Government Registry",
      "comment": "Offical registry data",
      "id": 197,
      "name": "Companies House",
      "url": "https://find-and-update.company-information.service.gov.uk"
    }
  },
  "address": {
    "country_code": "GB",
    "country_name": "United Kingdom",
    "country_region": "Northamptonshire",
    "address_street": "Artisans' House",
    "address_location": "7 Queensbridge",
    "address_city": "Northampton",
    "zip_code": "NN4 7BF",
    "jurisdiction": null,
    "source": {
      "category": "Government Registry",
      "comment": "Offical registry data",
      "id": 197,
      "name": "Companies House",
      "url": "https://find-and-update.company-information.service.gov.uk"
    }
  },
  "contact": {
    "website": "https://www.globaldatabase.com/",
    "linkedin": "linkedin.com/company/global-database",
    "source": {
      "category": "Enriched",
      "comment": "Contact information aggregated and enriched from multiple sources",
      "id": 1153,
      "name": "Contact Enrichment",
      "url": null
    }
  }
}

GET https://api.globaldatabase.com/v2/kyb/{id}/lite

Retrieve core company information in a single call. This endpoint returns essential company details including legal name, registration number, incorporation date, current status, registered address, and online presence. Perfect for basic company verification, status checks, or populating company profiles without needing full financial data.

What you get:

• Legal entity name and registration details
• Incorporation date and current operational status
• Full registered address
• VAT/tax identification numbers
• Legal form (Ltd., LLC, GmbH, etc.)
• Website and LinkedIn profiles when available

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
include_provenance	params	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Officers KYB

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/kyb/29707645/officers?page=1&per_page=10' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 29707645,
  "page": 1,
  "per_page": 10
}

Request example — with provenance

{
  "id": 29707645,
  "page": 1,
  "per_page": 10,
  "include_provenance": "true"
}

Success Response — default

{
  "data": [
    {
      "id": 212160656,
      "first_name": "Nicolae",
      "last_name": "Buldumac",
      "appointed_at": "2015-01-28",
      "resigned_at": null,
      "work_status": "ACTIVE",
      "date_of_birth_year": 1985,
      "date_of_birth_month": 12,
      "job_title": "Director",
      "address_country": "GB",
      "address_line_1": "7 Queensbridge, Artisans' House",
      "address_locality": "Northampton",
      "address_region": "Northamptonshire",
      "address_postal_code": "NN4 7BF"
    }
    // ... more officers
  ],
  "total_pages": 1,
  "total_results": 3
}

Success Response — with provenance

{
  "data": [
    {
      "id": 212160656,
      "officer": {
        "first_name": "Nicolae",
        "last_name": "Buldumac",
        "date_of_birth_year": 1985,
        "date_of_birth_month": 12,
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "appointment": {
        "appointed_at": "2015-01-28",
        "resigned_at": null,
        "work_status": "ACTIVE",
        "job_title": "Director",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "address": {
        "address_country": "GB",
        "address_line_1": "7 Queensbridge, Artisans' House",
        "address_locality": "Northampton",
        "address_region": "Northamptonshire",
        "address_postal_code": "NN4 7BF",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "contact": {
        "email": "nbuldumac@globaldatabase.com",
        "phone": null,
        "source": {
          "category": "Enriched",
          "comment": "Officer contact information aggregated and enriched from multiple sources",
          "id": 1157,
          "name": "Officer Contact Enrichment",
          "url": null
        }
      }
    }
    // ... more officers. Officers sourced only from a registry omit the
    // enriched "contact" block.
  ],
  "total_pages": 1,
  "total_results": 3
}

GET https://api.globaldatabase.com/v2/kyb/{id}/officers

Access complete information on company directors, executives, and officers. Returns the full list of individuals with control or significant influence over the company, including their appointment dates, positions, and addresses. Essential for beneficial ownership verification, sanctions screening, and understanding who's actually running the business.

Key data points:

• Full names and dates of birth (year/month)
• Job titles and roles (Director, Secretary, Manager, etc.)
• Appointment dates
• Registered addresses
• Paginated results for companies with many officers

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
page	params	int	false	Page number
per_page	params	int	false	Number of results per page
include_provenance	params	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Officers Search KYB

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/kyb/officers/search' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Nicolae Buldumac"
}'

Request example

{
  "name": "Nicolae Buldumac"
}

Request example — with provenance

{
  "name": "Nicolae Buldumac",
  "include_provenance": "true"
}

Success Response — default

[
  {
    "id": 212160656,
    "company_id": 29707645,
    "company_name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "registration_number": "09410808",
    "company_status": "Active",
    "incorporation_date": "2015-01-28",
    "full_name": "Nicolae Buldumac",
    "first_name": "Nicolae",
    "last_name": "Buldumac",
    "middle_name": null,
    "title": "Mr",
    "sex": "M",
    "nationality": "Romanian",
    "date_of_birth_year": 1985,
    "date_of_birth_month": 12,
    "officer_role": "Director",
    "appointed_at": "2015-01-28",
    "resigned_at": null,
    "work_status": "ACTIVE",
    "country_of_residence": "GB",
    "address_country": "GB",
    "address_line_1": "7 Queensbridge, Artisans' House",
    "address_locality": "Northampton",
    "address_region": "Northamptonshire",
    "address_postal_code": "NN4 7BF",
    "email": "nbuldumac@globaldatabase.com"
  }
  // ... more companies linked to this officer
]

Success Response — with provenance

[
  {
    "id": 212160656,
    "company": {
      "company_id": 29707645,
      "company_name": "GLOBAL DATA INTELLIGENCE LIMITED",
      "registration_number": "09410808",
      "company_status": "Active",
      "incorporation_date": "2015-01-28",
      "source": {
        "category": "Government Registry",
        "comment": "Offical registry data",
        "id": 197,
        "name": "Companies House",
        "url": "https://find-and-update.company-information.service.gov.uk"
      }
    },
    "officer": {
      "first_name": "Nicolae",
      "last_name": "Buldumac",
      "date_of_birth_year": 1985,
      "date_of_birth_month": 12,
      "type": "Person",
      "source": {
        "category": "Government Registry",
        "comment": "Offical registry data",
        "id": 197,
        "name": "Companies House",
        "url": "https://find-and-update.company-information.service.gov.uk"
      }
    },
    "appointment": {
      "appointed_at": "2015-01-28",
      "resigned_at": null,
      "work_status": "ACTIVE",
      "job_title": "Director",
      "source": {
        "category": "Government Registry",
        "comment": "Offical registry data",
        "id": 197,
        "name": "Companies House",
        "url": "https://find-and-update.company-information.service.gov.uk"
      }
    },
    "address": {
      "address_country": "GB",
      "address_line_1": "7 Queensbridge, Artisans' House",
      "address_locality": "Northampton",
      "address_region": "Northamptonshire",
      "address_postal_code": "NN4 7BF",
      "source": {
        "category": "Government Registry",
        "comment": "Offical registry data",
        "id": 197,
        "name": "Companies House",
        "url": "https://find-and-update.company-information.service.gov.uk"
      }
    },
    "contact": {
      "email": "nbuldumac@globaldatabase.com",
      "phone": null,
      "source": {
        "category": "Enriched",
        "comment": "Officer contact information aggregated and enriched from multiple sources",
        "id": 1157,
        "name": "Officer Contact Enrichment",
        "url": null
      }
    }
  }
  // ... more companies. The enriched "contact" block and registry "source"
  // values vary by officer and jurisdiction; some items omit them.
]

POST https://api.globaldatabase.com/v2/kyb/officers/search

Search for company directors, officers, and key individuals by name to discover every company where they hold or have held a position. Returns appointment dates, roles, company details, and current status — across all jurisdictions in the GlobalDatabase registry. This is the reverse of the existing /kyb/{id}/officers endpoint — start from a person's name and find all companies they are connected to.

Key use cases:

• Reverse officer lookup — find all companies linked to an individual
• PEP & sanctions screening — identify all corporate roles held by a flagged individual
• Enhanced due diligence — cross-reference a director's declared roles against registry records
• Network mapping — build a full picture of an individual's corporate footprint

Parameters

Parameter	In	Type	Required	Description
name	body	string	true	Full or partial name of the officer or director. Minimum 2 characters
date_of_birth_year	body	integer	false	Year of birth for disambiguation. 4-digit year format (YYYY)
country_code	body	string	false	Country code in ISO 3166-1 alpha-2 format (e.g. GB, US, DE)
status	body	string	false	Officer appointment status. C — current (active), P — previous (resigned)
appointment_date	body	object	false	Date range filter for appointment date. Object with gte (from) and lte (to) fields in YYYY-MM-DD format
resignation_date	body	object	false	Date range filter for resignation date. Object with gte (from) and lte (to) fields in YYYY-MM-DD format
company_name	body	string	false	Filter results by company name
company_reg_number	body	string	false	Filter results by company registration number
company_status	body	array	false	Filter by company status. Array of nomenclature IDs from Company Status nomenclature
company_countries	body	array	false	Filter by company countries. Array of nomenclature IDs from KYB Countries
include_provenance	body	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Validation Rules

• Required field: name — The officer name must always be provided (minimum 2 characters).
• Date range objects: appointment_date and resignation_date accept an object with optional gte (greater than or equal) and lte (less than or equal) fields in YYYY-MM-DD format. You can provide only gte, only lte, or both.

Shareholders KYB

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/kyb/29707645/shareholders?page=1&per_page=10' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 29707645,
  "page": 1,
  "per_page": 10
}

Request example — with provenance

{
  "id": 29707645,
  "page": 1,
  "per_page": 10,
  "include_provenance": "true"
}

Success Response — default

{
  "data": [
    {
      "currency": "GBP",
      "id": 712449329,
      "name": "NICOLAE BULDUMAC",
      "percentage": null,
      "quantity": 9000,
      "share_price": 0.009999999776482582,
      "share_type": "ORDINARY",
      "share_value": "9000.0 ORDINARY GBP 0.01",
      "status": null,
      "total_value": 89.99999798834324
    }
    // ... more shareholders
  ],
  "total_pages": 1,
  "total_results": 2
}

Success Response — with provenance

{
  "data": [
    {
      "currency": "GBP",
      "id": 712449329,
      "name": "NICOLAE BULDUMAC",
      "percentage": null,
      "quantity": 9000,
      "share_price": 0.009999999776482582,
      "share_type": "ORDINARY",
      "share_value": "9000.0 ORDINARY GBP 0.01",
      "status": null,
      "total_value": 89.99999798834324
    }
    // ... more shareholders
  ],
  "source": {
    "category": "Government Registry",
    "comment": "Offical registry data",
    "id": 197,
    "name": "Companies House",
    "url": "https://find-and-update.company-information.service.gov.uk"
  },
  "total_pages": 1,
  "total_results": 2
}

GET https://api.globaldatabase.com/v2/kyb/{id}/shareholders

View complete ownership structure and shareholding details. This endpoint reveals who owns the company, how much they own, and the value of their holdings. Critical for identifying ultimate beneficial owners (UBOs), assessing control structures, and conducting thorough due diligence.

Returns:

• Shareholder names (individuals or corporate entities)
• Share quantities and types (Ordinary, Preference, etc.)
• Share prices and total ownership values
• Currency denominations
• Paginated for complex ownership structures

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
page	params	int	false	Page number
per_page	params	int	false	Number of results per page
include_provenance	params	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Shareholders Search KYB

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/kyb/shareholders/search/lite' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Nicolae Buldumac"
}'

Request example

{
  "name": "Nicolae Buldumac"
}

Request example — with provenance

{
  "name": "Nicolae Buldumac",
  "include_provenance": "true"
}

Success Response (view_mode full)

{
    "data": [
        {
            "company": {
                "id": 29707645,
                "name": "GLOBAL DATA INTELLIGENCE LIMITED",
                "registration_number": "09410808",
                "address": {
                    "zip": "NN4 7BF",
                    "city": "Northampton",
                    "address1": "Artisans' House",
                    "address2": "7 Queensbridge",
                    "country_region": "Northamptonshire"
                },
                "vat_number": "GB260423730"
            },
            "created": "2026-03-08T00:30:10,037+0000",
            "currency": "GBP",
            "id": 712449329,
            "name": "NICOLAE BULDUMAC",
            "percentage": 90.0,
            "quantity": 9000,
            "share_price": 0.01,
            "share_type": "ORDINARY",
            "share_value": "9000.0 ORDINARY GBP 0.01",
            "status": "C",
            "type": "Person"
        }
        // ... more holdings
    ],
    "total_pages": 1,
    "total_results": 1
}

Success Response (view_mode lite)

{
    "data": [
        {
            "company": {
                "id": 29707645,
                "name": "GLOBAL DATA INTELLIGENCE LIMITED",
                "registration_number": "09410808",
                "address": {
                    "zip": "NN4 7BF",
                    "city": "Northampton",
                    "address1": "Artisans' House",
                    "address2": "7 Queensbridge",
                    "country_region": "Northamptonshire"
                },
                "vat_number": "GB260423730"
            },
            "name": "NICOLAE BULDUMAC",
            "type": "Person"
        }
        // ... more holders
    ],
    "total_pages": 1,
    "total_results": 1
}

Success Response (with provenance) — each item gains a source object

{
    "data": [
        {
            "company": {
                "id": 29707645,
                "name": "GLOBAL DATA INTELLIGENCE LIMITED",
                "registration_number": "09410808",
                "address": {
                    "zip": "NN4 7BF",
                    "city": "Northampton",
                    "address1": "Artisans' House",
                    "address2": "7 Queensbridge",
                    "country_region": "Northamptonshire"
                },
                "vat_number": "GB260423730"
            },
            "name": "NICOLAE BULDUMAC",
            "source": {
                "category": "Government Registry",
                "comment": "Offical registry data",
                "id": 197,
                "name": "Companies House",
                "url": "https://find-and-update.company-information.service.gov.uk"
            },
            "type": "Person"
        }
        // ... more holders
    ],
    "total_pages": 1,
    "total_results": 1
}

POST https://api.globaldatabase.com/v2/kyb/shareholders/search/{view_mode}

Search for shareholders by name to discover every company in which an individual or corporate entity holds a stake. Returns the holder, the company they are linked to, and that company's core registry details — across all jurisdictions in the GlobalDatabase registry. This is the reverse of the existing /kyb/{id}/shareholders endpoint — start from a shareholder's name and find all companies they own a share of.

View modes:

• lite — returns the holder (name, type) and the linked company only
• full — adds shareholding detail: percentage, quantity, share_type, share_price, share_value, currency, status, holding id and created date

Key use cases:

• Reverse shareholder lookup — find all companies linked to a person or entity
• Ultimate beneficial owner (UBO) discovery and ownership-network mapping
• Enhanced due diligence — cross-reference declared holdings against registry records
• Filter ownership by stake size using the percentage range

Parameters

Parameter	In	Type	Required	Description
view_mode	url	string	true	View mode. Either lite or full — controls the level of detail returned
name	body	string	true	Shareholder name. Minimum 2 characters, maximum 500
company_name	body	string	false	Filter by company name
registration_number	body	string	false	Filter by company registration number
vat_number	body	string	false	Filter by company VAT number
location_countries	body	array	false	Filter by location. Array of ISO 3166-1 alpha-2 country codes (e.g. GB)
percentage	body	object	false	Ownership percentage range. Object with gte (min) and lte (max) fields, each between 1 and 100
page	body	int	false	Page number. Default 1
per_page	body	int	false	Number of results per page. Default 10, maximum 50
include_provenance	body	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Validation Rules

• Required field: name — The shareholder name must always be provided (between 2 and 500 characters).
• view_mode: Must be either lite or full in the URL path. Each mode is gated by its own permission.
• location_countries: Each item must be a 2-letter ISO 3166-1 alpha-2 country code (e.g. GB). Unknown or malformed codes return 400 Bad Request.
• percentage: gte and lte are each optional integers between 1 and 100. You can provide only gte, only lte, or both.

Group Structures Lite KYB

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/kyb/29707645/group-structures/lite' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 29707645
}

Request example — with provenance

{
  "id": 29707645,
  "include_provenance": "true"
}

Success Response — default

[
  {
    "id": 29707645,
    "name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "country": "GB",
    "registration_number": "GB 09410808",
    "selected": true,
    "children": []
  }
]

Success Response — with provenance

{
  "data": [
    {
      "id": 29707645,
      "name": "GLOBAL DATA INTELLIGENCE LIMITED",
      "country": "GB",
      "registration_number": "GB 09410808",
      "selected": true,
      "children": []
    }
  ],
  "source": {
    "category": "Modelled",
    "comment": "Relationship derived using proprietary linkage methodologies and available corporate relationship data",
    "id": 895,
    "name": "Global Data Intelligence Limited",
    "url": "https://www.globaldatabase.com/"
  }
}

GET https://api.globaldatabase.com/v2/kyb/{id}/group-structures/lite

Get a simplified view of corporate group relationships. Shows immediate parent-subsidiary connections for the company. Use this for a quick overview of whether the company is standalone or part of a larger corporate structure.

Best for:

• Quick checks on corporate independence
• Initial group structure assessment
• Validating if deeper structure analysis is needed

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
include_provenance	params	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Group Structures Full KYB

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/kyb/29707645/group-structures/full' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 29707645
}

Request example — with provenance

{
  "id": 29707645,
  "include_provenance": "true"
}

Success Response — default

[
  {
    "id": 29707645,
    "name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "country": "GB",
    "registration_number": "GB 09410808",
    "selected": true,
    "children": [
      {
        "id": 222828368,
        "name": "GLOBAL DATABASE, SRL",
        "country": "MD",
        "registration_number": "MD 1021600025805",
        "selected": false,
        "children": []
      }
    ]
  }
]

Success Response — with provenance

{
  "data": [
    {
      "id": 29707645,
      "name": "GLOBAL DATA INTELLIGENCE LIMITED",
      "country": "GB",
      "registration_number": "GB 09410808",
      "selected": true,
      "children": [
        {
          "id": 222828368,
          "name": "GLOBAL DATABASE, SRL",
          "country": "MD",
          "registration_number": "MD 1021600025805",
          "selected": false,
          "children": []
        }
      ]
    }
  ],
  "source": {
    "category": "Modelled",
    "comment": "Relationship derived using proprietary linkage methodologies and available corporate relationship data",
    "id": 895,
    "name": "Global Data Intelligence Limited",
    "url": "https://www.globaldatabase.com/"
  }
}

GET https://api.globaldatabase.com/v2/kyb/{id}/group-structures/full

Map the complete corporate family tree. Returns the full hierarchy showing parent companies, subsidiaries, and sister companies across all levels. Essential for understanding complex ownership chains, identifying ultimate parent entities, and assessing group-wide risk exposure.

Use cases:

• Ultimate beneficial owner (UBO) identification
• Group risk assessment
• Compliance with corporate transparency requirements
• M&A due diligence on corporate structures

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
include_provenance	params	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Financial KYB

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/kyb/29707645/financial' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 29707645
}

Request example — with provenance

{
  "id": 29707645,
  "include_provenance": "true"
}

Success Response — default

{
    "years": [
        "2016-01-28",
        "2017-01-31",
        "2018-01-31",
        ...
    ],
    "groups": [
        {
            "id": "Summary",
            "name": "Summary",
            "order": 0,
            "list": [
                {
                    "name": "Reporting period",
                    "list": {
                        "2016-01-28": "12",
                        "2017-01-31": "12",
                        "2018-01-31": "12",
                        ...
                    }
                },
                {
                    "name": "Currency",
                    "list": {
                        "2016-01-28": "GBP",
                        "2017-01-31": "GBP",
                        "2018-01-31": "GBP",
                        ...
                    }
                },
                {
                    "name": "Consolidated A/cs",
                    "list": {
                        "2016-01-28": "N",
                        "2017-01-31": "N",
                        "2018-01-31": "N",
                        ...
                    }
                },
                {
                    "name": "Employee Numbers",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        "2018-01-31": "1",
                        ...
                    },
                    "progress": [
                        33,
                        33,
                        33,
                        ...
                    ]
                },
                {
                    "name": "Working Capital",
                    "list": {
                        "2016-01-28": "1838.0",
                        "2017-01-31": "-23025.0",
                        "2018-01-31": "-9784.0",
                        ...
                    },
                    "progress": [
                        1,
                        -8,
                        -3,
                        ...
                    ]
                },
                {
                    "name": "Total Liabilities",
                    "list": {
                        "2016-01-28": "4531.0",
                        "2017-01-31": "30050.0",
                        "2018-01-31": "34620.0",
                        ...
                    },
                    "progress": [
                        1,
                        4,
                        4,
                        ...
                    ]
                },
                {
                    "name": "Total Assets",
                    "list": {
                        "2016-01-28": "6369.0",
                        "2017-01-31": "37075.0",
                        "2018-01-31": "45327.0",
                        ...
                    },
                    "progress": [
                        1,
                        6,
                        7,
                        ...
                    ]
                },
                {
                    "name": "Net Assets",
                    "list": {
                        "2016-01-28": "1838.0",
                        "2017-01-31": "7025.0",
                        "2018-01-31": "10707.0",
                        ...
                    },
                    "progress": [
                        1,
                        3,
                        4,
                        ...
                    ]
                }
            ]
        },
        {
            "id": "Income Statement",
            "name": "Income Statement",
            "order": 1,
            "list": [
                {
                    "name": "Reporting period",
                    "list": {
                        "2016-01-28": "12",
                        "2017-01-31": "12",
                        "2018-01-31": "12",
                        ...
                    }
                },
                {
                    "name": "Currency",
                    "list": {
                        "2016-01-28": "GBP",
                        "2017-01-31": "GBP",
                        "2018-01-31": "GBP",
                        ...
                    }
                },
                {
                    "name": "Consolidated A/cs",
                    "list": {
                        "2016-01-28": "N",
                        "2017-01-31": "N",
                        "2018-01-31": "N",
                        ...
                    }
                },
                {
                    "name": "Amortisation of Intangibles",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        "2018-01-31": null,
                        ...
                    },
                    "progress": [
                        14,
                        100,
                        ...
                    ]
                },
                {
                    "name": "Depreciation of Tangibles",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        "2018-01-31": "10558.0",
                        ...
                    },
                    "progress": [
                        96,
                        100,
                        100,
                        ...
                    ]
                },
                {
                    "name": "P&L Account Reserve",
                    "list": {
                        "2016-01-28": "1837",
                        "2017-01-31": "7024",
                        "2018-01-31": "10706",
                        ...
                    },
                    "progress": [
                        1,
                        3,
                        ...
                    ]
                }
            ]
        },
        {
            "id": "Balance Sheet",
            "name": "Balance Sheet",
            "order": 2,
            "list": [
                {
                    "name": "Reporting period",
                    "list": {
                        "2016-01-28": "12",
                        "2017-01-31": "12",
                        "2018-01-31": "12",
                        ...
                    }
                },
                {
                    "name": "Currency",
                    "list": {
                        "2016-01-28": "GBP",
                        "2017-01-31": "GBP",
                        "2018-01-31": "GBP",
                        ...
                    }
                },
                {
                    "name": "Consolidated A/cs",
                    "list": {
                        "2016-01-28": "N",
                        "2017-01-31": "N",
                        "2018-01-31": "N",
                        ...
                    }
                },
                {
                    "name": "Total Assets",
                    "list": {
                        "2016-01-28": "6369.0",
                        "2017-01-31": "37075.0",
                        "2018-01-31": "45327.0",
                        ...
                    },
                    "progress": [
                        1,
                        6,
                        7,
                        ...
                    ]
                },
                {
                    "name": "Total Liabilities",
                    "list": {
                        "2016-01-28": "4531.0",
                        "2017-01-31": "30050.0",
                        "2018-01-31": "34620.0",
                        ...
                    },
                    "progress": [
                        1,
                        4,
                        4,
                        ...
                    ]
                },
                {
                    "name": "Net Assets",
                    "list": {
                        "2016-01-28": "1838.0",
                        "2017-01-31": "7025.0",
                        "2018-01-31": "10707.0",
                        ...
                    },
                    "progress": [
                        1,
                        3,
                        4,
                        ...
                    ]
                },
                {
                    "name": "Total Current Assets",
                    "list": {
                        "2016-01-28": "6369",
                        "2017-01-31": "7025",
                        "2018-01-31": "24836",
                        ...
                    },
                    "progress": [
                        1,
                        1,
                        4,
                        ...
                    ]
                },
                {
                    "name": "Total Current Liabilities",
                    "list": {
                        "2016-01-28": "4531.0",
                        "2017-01-31": "30050.0",
                        "2018-01-31": "34620.0",
                        ...
                    },
                    "progress": [
                        1,
                        4,
                        4,
                        ...
                    ]
                },
                {
                    "name": "Total Fixed Assets",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": "30050",
                        "2018-01-31": "20491",
                        ...
                    },
                    "progress": [
                        31,
                        21,
                        ...
                    ]
                },
                {
                    "name": "Total Long Term Liabilities",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        "2018-01-31": null,
                        ...
                    },
                    "progress": [
                        0,
                        9,
                        ...
                    ]
                },
                {
                    "name": "Working Capital",
                    "list": {
                        "2016-01-28": "1838.0",
                        "2017-01-31": "-23025.0",
                        "2018-01-31": "-9784.0",
                        ...
                    },
                    "progress": [
                        1,
                        -8,
                        ...
                    ]
                },
                {
                    "name": "Intangible Assets",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        "2018-01-31": null,
                        ...
                    },
                    "progress": [
                        0,
                        100,
                        ...
                    ]
                },
                {
                    "name": "Investment & Other",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        "2018-01-31": null,
                        ...
                    },
                    "progress": [
                        87,
                        ...
                    ]
                },
                {
                    "name": "Total Long Term Loans",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        ...
                    },
                    "progress": [
                        100,
                        ...
                    ]
                },
                {
                    "name": "Bank Loan",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        "2018-01-31": "1815.0",
                        ...
                    },
                    "progress": [
                        9,
                        41,
                        ...
                    ]
                },
                {
                    "name": "Tangible Assets",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": "30050",
                        ...
                    },
                    "progress": [
                        100,
                        68,
                        ...
                    ]
                },
                {
                    "name": "Bank Overdraft",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": "6546",
                        "2018-01-31": "1815",
                        ...
                    },
                    "progress": [
                        33,
                        9,
                        ...
                    ]
                },
                {
                    "name": "Miscellaneous Current Liabilities",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": "22389.0",
                        ...
                    },
                    "progress": [
                        27,
                        33,
                        ...
                    ]
                },
                {
                    "name": "Trade Creditors",
                    "list": {
                        "2016-01-28": "4531.0",
                        "2017-01-31": "1115.0",
                        ...
                    },
                    "progress": [
                        3,
                        1,
                        ...
                    ]
                },
                {
                    "name": "Trade Debtors",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": "4236.0",
                        "2018-01-31": "18888.0",
                        ...
                    },
                    "progress": [
                        1,
                        4,
                        2,
                        ...
                    ]
                },
                {
                    "name": "Cash",
                    "list": {
                        "2016-01-28": "6369",
                        "2017-01-31": "2421",
                        "2018-01-31": "4248",
                        ...
                    },
                    "progress": [
                        3,
                        1,
                        ...
                    ]
                },
                {
                    "name": "Bank Overdraft & LTL",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": "6546",
                        "2018-01-31": "1815",
                        ...
                    },
                    "progress": [
                        1,
                        0,
                        ...
                    ]
                },
                {
                    "name": "Capital Employed",
                    "list": {
                        "2016-01-28": "1838",
                        "2017-01-31": "7025",
                        "2018-01-31": "10707",
                        ...
                    },
                    "progress": [
                        1,
                        2,
                        ...
                    ]
                },
                {
                    "name": "Borrowings Due After One Year",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        ...
                    },
                    "progress": [
                        0,
                        100,
                        ...
                    ]
                },
                {
                    "name": "Equity Paid Up",
                    "list": {
                        "2016-01-28": "1",
                        "2017-01-31": "1",
                        "2018-01-31": "1",
                        ...
                    },
                    "progress": [
                        1,
                        1,
                        ...
                    ]
                },
                {
                    "name": "Investments",
                    "list": {
                        "2016-01-28": null,
                        "2017-01-31": null,
                        ...
                    },
                    "progress": [
                        0,
                        ...
                    ]
                },
                ...
            ]
        },
        {
            "id": "Cashflow",
            "name": "Cashflow",
            "order": 3,
            "list": [
                {
                    "name": "Reporting period",
                    "list": {
                        "2016-01-28": "12",
                        "2017-01-31": "12",
                        "2018-01-31": "12",
                        ...
                    }
                },
                {
                    "name": "Currency",
                    "list": {
                        "2016-01-28": "GBP",
                        "2017-01-31": "GBP",
                        "2018-01-31": "GBP",
                        ...
                    }
                },
                {
                    "name": "Consolidated A/cs",
                    "list": {
                        "2016-01-28": "N",
                        "2017-01-31": "N",
                        "2018-01-31": "N",
                        ...
                    }
                },
                {
                    "name": "Cash",
                    "list": {
                        "2016-01-28": "6369",
                        "2017-01-31": "2421",
                        "2018-01-31": "4248",
                        ...
                    },
                    "progress": [
                        3,
                        1,
                        2,
                        ...
                    ]
                }
            ]
        },
        {
            "id": "Capital & Reserves",
            "name": "Capital & Reserves",
            "order": 4,
            "list": [
                {
                    "name": "Reporting period",
                    "list": {
                        "2016-01-28": "12",
                        "2017-01-31": "12",
                        "2018-01-31": "12",
                        ...
                    }
                },
                {
                    "name": "Currency",
                    "list": {
                        "2016-01-28": "GBP",
                        "2017-01-31": "GBP",
                        "2018-01-31": "GBP",
                        ...
                    }
                },
                {
                    "name": "Consolidated A/cs",
                    "list": {
                        "2016-01-28": "N",
                        "2017-01-31": "N",
                        "2018-01-31": "N",
                        ...
                    }
                },
                {
                    "name": "Capital Employed",
                    "list": {
                        "2016-01-28": "1838",
                        "2017-01-31": "7025",
                        "2018-01-31": "10707",
                        ...
                    },
                    "progress": [
                        1,
                        2,
                        3,
                       ...
                    ]
                },
                ....
            ]
        },
        {
            "id": "KPIs & Ratios",
            "name": "KPIs & Ratios",
            "order": 5,
            "list": [
                {
                    "name": "Reporting period",
                    "list": {
                        "2016-01-28": "12",
                        "2017-01-31": "12",
                        ...
                    }
                },
                {
                    "name": "Currency",
                    "list": {
                        "2016-01-28": "GBP",
                        "2017-01-31": "GBP",
                        ...
                    }
                },
                {
                    "name": "Consolidated A/cs",
                    "list": {
                        "2016-01-28": "N",
                        "2017-01-31": "N",
                        ...
                    }
                },
                {
                    "name": "Current Ratio",
                    "list": {
                        "2016-01-28": "1.4056499668947253",
                        "2017-01-31": "0.23377703826955074",
                        "2018-01-31": "0.7173887926054304",
                        ...
                    },
                    "progress": [
                        29,
                        5,
                        15,
                        ...
                    ]
                },
                ...
            ]
        }
    ]
}

Success Response — with provenance

The body is identical to the default response, with a top-level source object appended describing where the figures came from:

{
    "years": [ ... ],
    "groups": [ ... ],
    "source": {
        "category": "Government Registry",
        "comment": "Offical registry data",
        "id": 197,
        "name": "Companies House",
        "url": "https://find-and-update.company-information.service.gov.uk"
    }
}

GET https://api.globaldatabase.com/v2/kyb/{id}/financial

Access multi-year financial statements and performance data. This endpoint delivers comprehensive financial information including balance sheets, income statements, cash flow data, and calculated financial ratios—all pulled directly from official filings. Track financial health, analyze trends over time, and make informed decisions about creditworthiness and business stability.

Includes:

• Summary metrics: Working capital, total assets/liabilities, employee counts
• Income statements: Revenue, costs, depreciation, P&L reserves
• Balance sheet data: Assets, liabilities, equity, working capital details
• Cash flow information: Cash positions over time
• Capital & reserves: Shareholder equity and retained earnings
• KPIs & financial ratios: Current ratio, profitability metrics, and more
• Multi-year history: Track trends across reporting periods

Perfect for:

• Credit risk assessment
• Financial health monitoring
• Supplier financial vetting
• Investment due diligence
• Automated credit limit calculations

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
include_provenance	params	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Full KYB

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/kyb/29707645/full' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
  "id": 29707645
}

Success Response — default

{
  "lite": {
    "id": "29707645",
    "name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "registration_number": "09410808",
    "vat_number": "GB260423730",
    "incorporation_date": "2015-01-28",
    "status": "Active",
    "country_code": "GB",
    "country_name": "United Kingdom",
    "country_region": "Northamptonshire",
    "address_street": "Artisans' House",
    "address_location": "7 Queensbridge",
    "address_city": "Northampton",
    "zip_code": "NN4 7BF",
    "legal_form": "Private limited company (Ltd.)",
    "website": "https://www.globaldatabase.com/",
    "linkedin": "linkedin.com/company/global-database",
    "ticker": null,
    "jurisdiction": null
  },
  "officers": [
    {
      "id": 212160656,
      "first_name": "Nicolae",
      "last_name": "Buldumac",
      "appointed_at": "2015-01-28",
      "resigned_at": null,
      "work_status": "ACTIVE",
      "date_of_birth_year": 1985,
      "date_of_birth_month": 12,
      "job_title": "Director",
      "address_country": "GB",
      "address_line_1": "7 Queensbridge, Artisans' House",
      "address_locality": "Northampton",
      "address_region": "Northamptonshire",
      "address_postal_code": "NN4 7BF"
    }
  ],
  "shareholders": [
    {
      "id": 712449329,
      "name": "NICOLAE BULDUMAC",
      "currency": "GBP",
      "percentage": 90.0,
      "quantity": 9000,
      "share_price": 0.01,
      "share_type": "ORDINARY",
      "share_value": "9000.0 ORDINARY GBP 0.01",
      "status": null,
      "total_value": 90.0
    }
  ],
  "group_structures_full": [
    {
      "id": 222828368,
      "company": false,
      "company_id": 222828368,
      "country_source": "GB",
      "country_target": "MD",
      "source": "GB 09410808",
      "target": "MD 1021600025805",
      "title": "GLOBAL DATA INTELLIGENCE LIMITED",
      "target_title": "GLOBAL DATABASE, SRL",
      "details": "MD 1021600025805",
      "temporary": false
    }
  ],
  "financial": {
    "id": "Summary",
    "name": "Summary",
    "years": ["2023-01-31", "2024-01-31", "2025-01-31"],
    "groups": [
      {
        "order": 0,
        "id": "Summary",
        "name": "Summary",
        "list": [
          {
            "name": "Net Assets",
            "list": {
              "2023-01-31": "-239021.00",
              "2024-01-31": "-252504.00",
              "2025-01-31": "-213633.00"
            },
            "progress": [-95, -100, -85]
          }
        ]
      }
    ]
  }
}

Request example — with provenance

{
  "id": 29707645,
  "include_provenance": "true"
}

Success Response — with provenance

{
  "lite": {
    "id": 29707645,
    "basic": {
      "name": "GLOBAL DATA INTELLIGENCE LIMITED",
      "registration_number": "09410808",
      "vat_number": "GB260423730",
      "incorporation_date": "2015-01-28",
      "status": "Active",
      "legal_form": "Private limited company (Ltd.)",
      "source": {
        "category": "Government Registry",
        "comment": "Offical registry data",
        "id": 197,
        "name": "Companies House",
        "url": "https://find-and-update.company-information.service.gov.uk"
      }
    },
    "address": {
      "country_code": "GB",
      "country_name": "United Kingdom",
      "country_region": "Northamptonshire",
      "address_street": "Artisans' House",
      "address_location": "7 Queensbridge",
      "address_city": "Northampton",
      "zip_code": "NN4 7BF",
      "jurisdiction": null,
      "source": {
        "category": "Government Registry",
        "comment": "Offical registry data",
        "id": 197,
        "name": "Companies House",
        "url": "https://find-and-update.company-information.service.gov.uk"
      }
    },
    "contact": {
      "website": "https://www.globaldatabase.com/",
      "linkedin": "linkedin.com/company/global-database",
      "source": {
        "category": "Enriched",
        "comment": "Contact information aggregated and enriched from multiple sources",
        "id": 1153,
        "name": "Contact Enrichment",
        "url": null
      }
    }
  },
  "officers": [
    {
      "id": 212160656,
      "officer": {
        "first_name": "Nicolae",
        "last_name": "Buldumac",
        "date_of_birth_year": 1985,
        "date_of_birth_month": 12,
        "type": "Person",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "appointment": {
        "appointed_at": "2015-01-28",
        "resigned_at": null,
        "work_status": "ACTIVE",
        "job_title": "Director",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "address": {
        "address_country": "GB",
        "address_line_1": "7 Queensbridge, Artisans' House",
        "address_locality": "Northampton",
        "address_region": "Northamptonshire",
        "address_postal_code": "NN4 7BF",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "contact": {
        "email": "nbuldumac@globaldatabase.com",
        "phone": null,
        "source": {
          "category": "Enriched",
          "comment": "Officer contact information aggregated and enriched from multiple sources",
          "id": 1157,
          "name": "Officer Contact Enrichment",
          "url": null
        }
      }
    },
    {
      "id": 574491992,
      "officer": {
        "first_name": "Vitalie",
        "last_name": "Aremescu",
        "date_of_birth_year": 1985,
        "date_of_birth_month": 10,
        "type": "Person",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "appointment": {
        "appointed_at": "2017-01-31",
        "resigned_at": "2022-06-17",
        "work_status": "RESIGNED",
        "job_title": "Director",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "address": {
        "address_country": "MD",
        "address_line_1": "7 Queensbridge, Artisans' House",
        "address_locality": "Northampton",
        "address_region": "Northamptonshire",
        "address_postal_code": "NN4 7BF",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      }
    }
  ],
  "shareholders": [
    {
      "id": 712449329,
      "name": "NICOLAE BULDUMAC",
      "currency": "GBP",
      "percentage": 90.0,
      "quantity": 9000,
      "share_price": 0.01,
      "share_type": "ORDINARY",
      "share_value": "9000.0 ORDINARY GBP 0.01",
      "status": null,
      "total_value": 90.0
    },
    {
      "id": 712449332,
      "name": "VITALIE AREMESCU",
      "currency": "GBP",
      "percentage": 10.0,
      "quantity": 1000,
      "share_price": 0.01,
      "share_type": "ORDINARY",
      "share_value": "1000.0 ORDINARY GBP 0.01",
      "status": null,
      "total_value": 10.0
    }
  ],
  "group_structures_full": {
    "data": [
      {
        "id": 29707645,
        "name": "GLOBAL DATA INTELLIGENCE LIMITED",
        "country": "GB",
        "registration_number": "GB 09410808",
        "selected": true,
        "children": [
          {
            "id": 222828368,
            "name": "GLOBAL DATABASE, SRL",
            "country": "MD",
            "registration_number": "MD 1021600025805",
            "selected": false,
            "children": []
          }
        ]
      }
    ],
    "source": {
      "category": "Modelled",
      "comment": "Relationship derived using proprietary linkage methodologies and available corporate relationship data",
      "id": 895,
      "name": "Global Data Intelligence Limited",
      "url": "https://www.globaldatabase.com/"
    }
  },
  "financial": {
    "years": ["2023-01-31", "2024-01-31", "2025-01-31"],
    "groups": [
      {
        "order": 0,
        "id": "Summary",
        "name": "Summary",
        "list": [
          {
            "name": "Employee Numbers",
            "list": {
              "2023-01-31": "3.00",
              "2024-01-31": "3.00",
              "2025-01-31": "1.00"
            },
            "progress": [100, 100, 33]
          },
          {
            "name": "Total Assets",
            "list": {
              "2023-01-31": "397190.00",
              "2024-01-31": "133371.00",
              "2025-01-31": "618593.00"
            },
            "progress": [64, 22, 100]
          },
          {
            "name": "Net Assets",
            "list": {
              "2023-01-31": "-239021.00",
              "2024-01-31": "-252504.00",
              "2025-01-31": "-213633.00"
            },
            "progress": [-95, -100, -85]
          }
        ]
      }
    ],
    "source": {
      "category": "Government Registry",
      "comment": "Offical registry data",
      "id": 197,
      "name": "Companies House",
      "url": "https://find-and-update.company-information.service.gov.uk"
    }
  }
}

With include_provenance, each section is enriched with the source it came from. The shapes change accordingly: lite is grouped into basic / address / contact blocks; each officers record is split into officer / appointment / address / contact blocks; group_structures_full becomes { "data": [tree], "source": {...} } with nested children; and financial carries a top-level source. Every block carries its own source object.

Partial Response — a section over its limit (with provenance)

{
  "lite": {
    "error": {
      "status_code": 403,
      "detail": {
        "access": {
          "permission": "api_kyb_lite",
          "permission_name": "Api KYB Lite",
          "module": "api_kyb",
          "module_name": "Api KYB",
          "app": "api",
          "app_name": "API"
        },
        "error_guard": "limits.daily",
        "message_guard": "You have reached your daily online browsing limit"
      }
    }
  },
  "officers": [
    {
      "id": 212160656,
      "officer": {
        "first_name": "Nicolae",
        "last_name": "Buldumac",
        "date_of_birth_year": 1985,
        "date_of_birth_month": 12,
        "type": "Person",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "appointment": {
        "appointed_at": "2015-01-28",
        "resigned_at": null,
        "work_status": "ACTIVE",
        "job_title": "Director",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "address": {
        "address_country": "GB",
        "address_line_1": "7 Queensbridge, Artisans' House",
        "address_locality": "Northampton",
        "address_region": "Northamptonshire",
        "address_postal_code": "NN4 7BF",
        "source": {
          "category": "Government Registry",
          "comment": "Offical registry data",
          "id": 197,
          "name": "Companies House",
          "url": "https://find-and-update.company-information.service.gov.uk"
        }
      },
      "contact": {
        "email": "nbuldumac@globaldatabase.com",
        "phone": null,
        "source": {
          "category": "Enriched",
          "comment": "Officer contact information aggregated and enriched from multiple sources",
          "id": 1157,
          "name": "Officer Contact Enrichment",
          "url": null
        }
      }
    }
  ],
  "shareholders": [
    {
      "id": 712449329,
      "name": "NICOLAE BULDUMAC",
      "currency": "GBP",
      "percentage": 90.0,
      "quantity": 9000,
      "share_price": 0.01,
      "share_type": "ORDINARY",
      "share_value": "9000.0 ORDINARY GBP 0.01",
      "status": null,
      "total_value": 90.0
    }
  ],
  "group_structures_full": {
    "data": [
      {
        "id": 29707645,
        "name": "GLOBAL DATA INTELLIGENCE LIMITED",
        "country": "GB",
        "registration_number": "GB 09410808",
        "selected": true,
        "children": [
          {
            "id": 222828368,
            "name": "GLOBAL DATABASE, SRL",
            "country": "MD",
            "registration_number": "MD 1021600025805",
            "selected": false,
            "children": []
          }
        ]
      }
    ],
    "source": {
      "category": "Modelled",
      "comment": "Relationship derived using proprietary linkage methodologies and available corporate relationship data",
      "id": 895,
      "name": "Global Data Intelligence Limited",
      "url": "https://www.globaldatabase.com/"
    }
  },
  "financial": {
    "years": ["2023-01-31", "2024-01-31", "2025-01-31"],
    "groups": [
      {
        "order": 0,
        "id": "Summary",
        "name": "Summary",
        "list": [
          {
            "name": "Net Assets",
            "list": {
              "2023-01-31": "-239021.00",
              "2024-01-31": "-252504.00",
              "2025-01-31": "-213633.00"
            },
            "progress": [-95, -100, -85]
          }
        ]
      }
    ],
    "source": {
      "category": "Government Registry",
      "comment": "Offical registry data",
      "id": 197,
      "name": "Companies House",
      "url": "https://find-and-update.company-information.service.gov.uk"
    }
  }
}

GET https://api.globaldatabase.com/v2/kyb/{id}/full

Retrieve every KYB detail for one company in a single call: company overview (lite), all officers, all shareholders, the full group structure (group_structures_full), and financial statements. Saves you from issuing five separate requests when building a complete company profile.

Officers and shareholders carry the full set (every record, not paginated) — unlike the standalone /officers and /shareholders endpoints, which are paginated.

Each section is metered and authorised independently. A section is never allowed to fail the whole call:

• On success, the section holds its data (an object for lite / financial, an array for officers / shareholders / group_structures_full).
• If your account is not entitled to a section, or has reached its usage limit, that section holds an error object with status_code 403 and the access / limit detail.
• If a section simply has no data for this company, it holds an error object with status_code 404 and the source's explanation.

This means a 200 OK response can still carry per-section errors — always check each section for an error key before reading its data.

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Company ID
include_provenance	params	boolean	false	Enrich the response with source metadata for each field. Useful for audit and compliance.

Get UBO

Returns the natural persons who ultimately own or control a company — its Ultimate Beneficial Owners (UBOs).

Ownership is followed up the chain of shareholders, through every holding company, until it reaches people. Percentages along a route are multiplied (a person holding 70% of a company that holds 60% of the target owns 42% of the target through that route); when the same person owns the target through several routes, the routes are added. A person is a UBO when the total, their effective ownership, is strictly above the threshold you request (default 25%).

The answer always says how far it can be trusted:

• chain_complete — every branch of the ownership was resolved to a person or a listed company.
• ubo_determination_conclusive — what is left unresolved cannot change the list of UBOs. A result can be conclusive with an incomplete chain: at a 25% threshold, an unresolved 7% cannot hide another UBO.
• percentages_are_minimum — part of the ownership is unresolved, so the real percentages may be higher. Show them as ≥ 31.64%, not 31.64%.

Two ways to get a result.

1. Get UBO answers from Global Database data. Most companies are answered within the request; a calculation that needs longer answers 202 with a job_id.
2. With enrichment=external_if_needed, Get UBO may also buy ownership reports from external providers for the companies in the chain that cannot be resolved otherwise. External enrichment can take longer than a request: if it is not finished in time, the response is 202 with a job_id. Start UBO Enrichment starts the same job explicitly. Follow it with Get UBO Enrichment Job; once it is complete, Get UBO with the same threshold and max_depth returns the enriched result.

Usage. Each new UBO calculation counts as one UBO call. The same request for the same company within 24 hours returns the same result and is not counted again; following a job, or reading a result you already have, is free — and still possible after your UBO limit is reached. An enrichment job also consumes one enrichment unit per new external report bought — never for a report already held and still valid, for a lookup that fails, or when the data we have is enough. A request that fails (any 4xx or 5xx) is not charged.

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/kyb/29707645/ubo?threshold=25&max_depth=10&include_provenance=true&enrichment=external_if_needed&max_enrichment_units=3' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

{
    "company": {
        "id": "29707645",
        "name": "GLOBAL DATA INTELLIGENCE LIMITED",
        "status": "Active",
        "country_code": "GB",
        "registration_number": "09410808"
    },
    "summary": {
        "as_of": "2026-10-02",
        "threshold": 25.0,
        "max_depth": 10,
        "max_depth_reached": 1,
        "total_ubos": 1,
        "determination": "calculated",
        "chain_complete": true,
        "ubo_determination_conclusive": true,
        "percentages_are_minimum": false,
        "risk_flags": [],
        "data_warnings": [],
        "ownership_breakdown": {
            "ubo_percentage": 90.0,
            "below_threshold_person_percentage": 10.0,
            "listed_entity_percentage": 0.0,
            "unresolved_entity_percentage": 0.0,
            "untraced_percentage": 0.0,
            "total_percentage": 100.0
        },
        "enrichment": {
            "mode": "internal",
            "job_id": null,
            "status": "not_requested",
            "entities_requested": 0,
            "entities_enriched": 0,
            "reports_bought": 0,
            "reports_from_cache": 0,
            "reports_pending": 0,
            "units_consumed": 0,
            "budget_exhausted": false,
            "retry_after_seconds": null
        }
    },
    "data": [
        {
            "id": "12541533",
            "full_name": "NICOLAE BULDUMAC",
            "first_name": "Nicolae",
            "last_name": "Buldumac",
            "status": null,
            "ceased_on": null,
            "notified_on": null,
            "is_pep": null,
            "nationality": "Romanian",
            "date_of_birth": {
                "month": 12,
                "year": 1985
            },
            "country_of_residence": null,
            "address": {
                "locality": "Egham",
                "postal_code": "TW20 9RB",
                "country_code": null
            },
            "control_types": [
                "ownership"
            ],
            "ownership": {
                "range": null,
                "direct_percentage": 90.0,
                "indirect_percentage": 0.0,
                "effective_percentage": 90.0,
                "voting_percentage": null,
                "has_direct_ownership": true,
                "has_indirect_ownership": false
            },
            "paths_total": 1,
            "paths_truncated": false,
            "paths": [
                {
                    "type": "direct",
                    "depth": 1,
                    "path_percentage": 90.0,
                    "nodes": [
                        {
                            "name": "GLOBAL DATA INTELLIGENCE LIMITED",
                            "type": "company",
                            "level": 0,
                            "entity_id": "29707645",
                            "country_code": "GB"
                        },
                        {
                            "name": "NICOLAE BULDUMAC",
                            "type": "person",
                            "level": 1,
                            "entity_id": "12541533",
                            "percentage": 90.0,
                            "percentage_derived": false
                        }
                    ]
                }
            ],
            "provenance": {
                "source": null,
                "determination_type": "calculated",
                "retrieved_at": "2026-10-02"
            }
        }
    ],
    "terminal_entities": [],
    "total_results": 1,
    "total_pages": 1
}

Still calculating (202)

{
    "job_id": "ubo_2faf63c57c5a1d32a714",
    "status": "processing",
    "company_id": "29707645",
    "threshold": 25.0,
    "created_at": "2026-10-02T16:29:16Z"
}

No UBO above the threshold

{
    "company": {
        "...": "..."
    },
    "summary": {
        "determination": "none_identified",
        "total_ubos": 0,
        "...": "...",
        "senior_managing_officials": [
            {
                "officer_id": "50000001",
                "full_name": "ANNA BROWN",
                "officer_role": "Director"
            },
            {
                "officer_id": "50000002",
                "full_name": "PETER GREEN",
                "officer_role": "Secretary"
            }
        ]
    },
    "data": [],
    "terminal_entities": [],
    "total_results": 0,
    "total_pages": 0
}

GET https://api.globaldatabase.com/v2/kyb/{id}/ubo

Get the Ultimate Beneficial Owners of a company.

Common use cases:

• Identify the beneficial owners during customer or supplier onboarding (KYC / KYB)
• Screen the owners against sanctions and PEP lists
• Show the ownership routes behind each owner

If this account has a finished enrichment job for the company with the same threshold and max_depth (within 24 hours), its enriched result is returned — free, whatever enrichment is requested. With an external enrichment, a job already running for the same threshold and max_depth is joined rather than started again.

When the result takes longer than the request allows, the response is 202 Accepted with a job_id: follow it with Get UBO Enrichment Job and call this endpoint again once it is complete.

Parameters

Parameter	In	Type	Required	Description
id	path	int	true	Company ID
threshold	query	number	false	Minimum effective ownership, in %, for a person to be a UBO: the person must be strictly above it. Default 25, greater than 0 and at most 100.
max_depth	query	int	false	Maximum number of ownership levels followed above the company. Default 10, from 1 to 20.
include_provenance	query	boolean	false	Add provenance to each UBO. Default false.
enrichment	query	string	false	internal (default) — Global Database data only, no external call. external_if_needed — external providers may be used where an unresolved branch could change the UBO result at your threshold. external_force — enrich unresolved branches even when they cannot change the result (not available yet: answers 400).
max_enrichment_units	query	int	false	Only with an external enrichment: most enrichment units the request may consume, 1 to 100. Default: everything your account has left.
page	query	int	false	Page of UBOs in data. Default 1.
per_page	query	int	false	UBOs per page. Default 50, at most 100.

Responses

Status	Meaning
200	The UBO result.
202	Still calculating: job_id to follow with Get UBO Enrichment Job.
502	The calculation failed. Not charged; retry.
400	Invalid parameter.
403	The UBO API, or external enrichment, is not part of your subscription.
404	Company not found.
429	UBO or enrichment limit reached.
503	Temporarily unavailable; retry later. Not charged.

Response fields

company

Field	Type	Description
id	string	Global Database company ID.
name	string	Legal company name.
status	string	Company status as registered.
country_code	string	ISO 3166-1 alpha-2 country code.
registration_number	string	Registration number.

summary — describes every UBO, whatever page is returned.

Field	Type	Description
as_of	date	Date of the calculation.
threshold	number	Threshold used.
max_depth	int	Maximum depth requested.
max_depth_reached	int	Deepest ownership level actually reached.
total_ubos	int	Number of UBOs.
determination	string	calculated — UBOs found, the answer is final; partial — the unresolved part could still change the list; none_identified — final, nobody is above the threshold; listed_parent — no UBO, ownership ends in listed companies; exempt_listed — the company itself is listed; not_available — no shareholder data for the company.
chain_complete	boolean	Every branch was resolved to a person or a listed company.
ubo_determination_conclusive	boolean	What is unresolved cannot change the list of UBOs.
percentages_are_minimum	boolean	Part of the ownership is unresolved: the percentages are minimums.
ownership_breakdown	object	Where 100% of the company ends up (below). null for exempt_listed and not_available.
risk_flags	array	possible_undisclosed_ubo (the unresolved part is larger than the threshold), circular_ownership, foreign_intermediate_entity (a company in the chain is registered in another country).
data_warnings	array	incomplete_chain, derived_percentages (some percentages were computed from share counts), holdings_over_100_normalised, max_nodes_reached, enrichment_in_progress.
senior_managing_officials	array	Only when there is no UBO: up to 5 current officers of the company (officer_id, full_name, officer_role).
enrichment	object	How external enrichment contributed (below).

summary.ownership_breakdown — always sums to 100.

Field	Description
ubo_percentage	Held by the UBOs.
below_threshold_person_percentage	Held by persons who are not above the threshold.
listed_entity_percentage	Ends in listed companies.
unresolved_entity_percentage	Ends in companies that could not be resolved further (see terminal_entities).
untraced_percentage	No owner known (the shareholders of a company add up to less than 100%).
total_percentage	Always 100.

summary.enrichment

Field	Type	Description
mode	string	internal or external_if_needed.
job_id	string	Enrichment job behind the result; null for an internal result.
status	string	not_requested, not_needed (our data was enough), pending, processing, complete, partial (stopped by the unit limit or time), failed.
entities_requested	int	Companies selected for external enrichment so far.
entities_enriched	int	Companies resolved with an external report (bought or reused).
reports_bought	int	New external reports bought.
reports_from_cache	int	External reports already held and reused, free.
reports_pending	int	Reports ordered and not received yet.
units_consumed	int	Enrichment units charged to your account.
budget_exhausted	boolean	max_enrichment_units (or your remaining allowance) stopped further enrichment.
retry_after_seconds	int	While the job runs: suggested polling interval.

data[] — the UBOs, largest effective ownership first.

Field	Type	Description
id	string	Person ID.
full_name	string	Full name.
first_name / last_name	string	May be null.
nationality	string	May be null.
date_of_birth	object	{"month", "year"} — the day is never returned. May be null.
address	object	locality, postal_code, country_code — the street is never returned. May be null.
control_types	array	ownership — effective ownership above the threshold; indirect_control — controls more than the threshold through majority-held companies.
ownership	object	direct_percentage, indirect_percentage, effective_percentage (direct + indirect), has_direct_ownership, has_indirect_ownership.
paths_total	int	Ownership routes found.
paths_truncated	boolean	More than 10 routes: only the 10 largest are listed.
paths	array	The routes, largest first (below).
provenance	object	Only with include_provenance=true: source, determination_type and retrieved_at. source is null until available.
status, ceased_on, notified_on, is_pep, country_of_residence, ownership.range, ownership.voting_percentage	—	Reserved: returned as null until available.

paths[]

Field	Description
type	direct — the person holds the company itself; indirect — through other companies.
depth	Ownership steps from the company to the person.
path_percentage	This route's share of the company (the product of the percentages along it).
nodes	From the company (level 0) up to the person. Each node: name, type (company / person), level, entity_id, country_code, and — except the company itself — percentage (held in the node below it), percentage_derived (true when computed from share counts) and, with include_provenance=true, provenance (source, source_type, retrieved_at; source and source_type are null until available).

terminal_entities[] — where a branch stopped before reaching a person, largest share first.

Field	Description
entity_id	Company ID; null when the holder is known only by name.
name, type, country_code	The holder.
effective_percentage	Share of the company that stops here.
reason	listed_company, ownership_not_available, unidentified_entity, circular_ownership, max_depth_reached, max_nodes_reached (the structure is too large to follow completely), source_unavailable.
listing	Reserved, null.
path	Route from the company to the holder, same node format as paths.

Terminal entities describe the completeness of the data; they are not by themselves a risk indicator.

Start UBO Enrichment

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/kyb/29707645/ubo/enrich' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "threshold": 25,
  "max_depth": 10,
  "max_enrichment_units": 3
}'

Job started (202)

{
    "job_id": "ubo_f093cd6ec129f546aa1d",
    "status": "pending",
    "company_id": "29707645",
    "threshold": 25.0,
    "created_at": "2026-10-02T16:35:16Z"
}

Same request, job already complete (200)

{
    "job_id": "ubo_f093cd6ec129f546aa1d",
    "status": "complete",
    "company_id": "29707645",
    "threshold": 25.0,
    "created_at": "2026-10-02T16:35:16Z",
    "result_url": "/v2/kyb/29707645/ubo?threshold=25&max_depth=10"
}

POST https://api.globaldatabase.com/v2/kyb/{id}/ubo/enrich

Start a job that resolves the ownership chain further with external ownership reports.

This endpoint or Get UBO? Both run the same enrichment and are charged the same. Get UBO with enrichment=external_if_needed waits for the result (up to about 10 seconds, then 202); this endpoint returns the job_id at once, without waiting — use it to start enrichment for many companies and collect the results later.

Global Database data is used first. A report is bought only for a company that could still change the list of UBOs at your threshold — an unresolved 7% cannot hide a 25% owner, so it is left alone. The job climbs further through every company a report reveals, until it reaches people, max_depth, or the enrichment units it may use.

The job runs in external_if_needed mode, like Get UBO with enrichment=external_if_needed. It never consumes more than max_enrichment_units, nor more than your account has left. The same request within 24 hours returns the same job and is not charged again: 202 while it runs, 200 with result_url once it is complete.

Parameters

Parameter	In	Type	Required	Description
id	path	int	true	Company ID
threshold	body	number	false	As for Get UBO. Default 25.
max_depth	body	int	false	As for Get UBO. Default 10.
include_provenance	body	boolean	false	As for Get UBO. Default false.
max_enrichment_units	body	int	false	Most enrichment units this job may consume, 1 to 100. Default: everything your account has left.

Responses

Status	Meaning
200	The same job already complete: job_id and result_url.
202	Job started, or the same job still running: job_id.
400	Invalid parameter.
403	External enrichment is not part of your subscription.
404	Company not found.
429	UBO or enrichment limit reached.
503	Temporarily unavailable; retry later. Not charged.

Get UBO Enrichment Job

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/kyb/29707645/ubo/enrich/ubo_f093cd6ec129f546aa1d' \
  -H 'Authorization: Token YOUR_API_KEY'

Running

{
    "job_id": "ubo_f093cd6ec129f546aa1d",
    "status": "processing",
    "progress": {
        "entities_resolved": 3,
        "entities_pending": 1,
        "current_depth": 4
    }
}

Complete

{
    "job_id": "ubo_f093cd6ec129f546aa1d",
    "status": "complete",
    "progress": {
        "entities_resolved": 4,
        "entities_pending": 0,
        "current_depth": 4
    },
    "result_url": "/v2/kyb/29707645/ubo?threshold=25&max_depth=10"
}

GET https://api.globaldatabase.com/v2/kyb/{id}/ubo/enrich/{job_id}

Follow a UBO job. Free, and available even after your UBO limit is reached.

Poll every few seconds — at most 60 times a minute — while status is pending or processing. When it is complete, result_url is the Get UBO call that returns the result. A job stays available for 24 hours.

Parameters

Parameter	In	Type	Required	Description
id	path	int	true	Company ID
job_id	path	string	true	job_id from Start UBO Enrichment, or from a 202 of Get UBO.

Responses

Status	Meaning
200	The job status.
403	The UBO API is not part of your subscription.
404	No such job for this company and account.
429	More than 60 polls in a minute.

Response fields

Field	Type	Description
job_id	string	The job.
status	string	pending, processing, complete or failed.
progress.entities_resolved	int	Companies resolved with external reports so far.
progress.entities_pending	int	Reports ordered and not received yet.
progress.current_depth	int	Deepest ownership level enriched so far.
result_url	string	Only when complete: the call that returns the result.

Credit Report API

The Credit Report API provide full detailed Business Credit Reports for selected companies.

Search Credit Report

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/credit-report?company=00445790&country=GB' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
    "company": "00445790",
    "country": "GB"
}

Success Response

[
    {
        "id": "GB-0-00445790",
        "name": "TESCO PLC",
        "address": {
            "post_code": "AL7 1GA",
            "city": "WELWYN GARDEN CITY",
            "province": null,
            "text": "WELWYN GARDEN CITY",
            "street": "TESCO HOUSE SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA"
        },
        "registration_number": "00445790",
        "vat_number": [
            "GB220430231"
        ],
        "status": "Active"
    }
]

Request example

{
    "company": "00445790"
}

Error Response

{
    "country": [
        "This field is required."
    ]
}

GET https://api.globaldatabase.com/v2/credit-report

Search for companies by Legal Name or Registration ID number and their country ID to learn if Global Database can provide you with a detailed Credit Report for that given company.

Parameters

Parameter	In	Type	Required	Description
company	query	string	false	Company Name
registration_number	query	string	false	Registration Number
vat_number	query	string	false	VAT Number
country	query	string	true	Country Code ISO
province	query	string	false	Province, available in nomenclatures
registered_city	query	string	false	City
post_code	query	string	false	Post Code

Generate Credit Report

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/credit-report/report/json' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_id": "GB-0-00445790",
    "country": "GB"
}'

Request example

{
    "source_id": "GB-0-00445790",
    "country": "GB"
}

Success Response

{
    "id": 52,
    "name": "TESCO PLC",
    "source_id": "GB-0-00445790",
    "expired": false,
    "date_created": "2021-09-30T07:09:57.081437Z",
    "address": {
        "province": null,
        "post_code": "AL7 1GA",
        "city": "WELWYN GARDEN CITY",
        "text": "TESCO HOUSE SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA, WELWYN GARDEN CITY, None, AL7 1GA, GB",
        "street": "TESCO HOUSE SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA"
    },
    "status": "pending",
    "registration_number": "00445790"
    "country": "GB"
}

POST https://api.globaldatabase.com/v2/credit-report/report/{format}

Generate the Credit Report itself based on the requested company name. Depending on the given company and country the generation process can be instant or take up to 3 minutes to complete. You will receive the Credit Report ID as the results of Generation procedure. Multiple Generate requests can be completed at the same time if you are looking to look up multiple companies and would like to wait for each one to finalize before requesting the next one.

Parameters

Parameter	In	Type	Required	Description
format	url	string	false	Response format: json or html. If not specified, json is used by default.
source_id	body	string	true	Source Id
country	body	string	true	Country Code ISO

Check Credit Report

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/credit-report/568/check' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
    "id": 568
}

Success Response

{
  true
}

GET https://api.globaldatabase.com/v2/credit-report/{id}/check

Check credit report availability

Parameters

Parameter	In	Type	Required	Description
id	url	int	true	Credit Report ID

Content Credit Report by ID

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/credit-report/report/json/52/file' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
    "report_id": 52
}

Success Response

{
    "ccj": [],
    "liens": [],
    "bankers": [],
    "summary": {
        "ebitda": 4516000000.0,
        "charges": 2,
        "country": "GB",
        "comments": null,
        "extended": [
            {
                "Charges": 2,
                "Mortgages": 9,
                "Court Judgments": 8
            },
            {
                "EBITDA": 4516000000.0,
                "Turnover": 57887000000.0,
                "Age of Business": 73,
                "Number of Employees": "367321"
            }
        ],
        "language": "EN",
        "turnover": 57887000000.0,
        "mortgages": 9,
        "last_update": null,
        "nsso_number": null,
        "cash_at_bank": 2510000000.0,
        "nsso_summons": null,
        "liable_for_vat": null,
        "age_of_business": 73,
        "fin_information": null,
        "charges_dynamics": null,
        "court_judgements": 8,
        "derogatory_legal": null,
        "mortgages_dynamics": "04-11-2009",
        "rating_information": null,
        "shareholder_equity": 12343000000.0,
        "things_to_consider": [
            "This company has been treated as a PLC company in terms of the score/limit that has been generated",
            "This company's Asset Ratio shows a moderate amount of cover on outstanding obligations."
        ],
        "company_description": "",
        "number_of_employees": "367321",
        "overall_credit_risk": {
            "pod": 0.0597,
            "commonValue": "A",
            "creditLimit": {
                "value": "100000000",
                "currency": "GBP"
            },
            "providerValue": {
                "value": "86",
                "maxValue": "100",
                "minValue": "1"
            },
            "commonDescription": "Very Low Risk",
            "providerDescription": "Very Low Risk"
        },
        "payment_information": null,
        "protested_bills_flag": null,
        "additional_foreign_oenb": null,
        "credit_score_description": null,
        "pd_according_to_basel_ii": null,
        "court_judgements_dynamics": null,
        "overall_credit_risk_class": "Very Low Risk",
        "credit_limit_recommendation": {
            "value": "100000000",
            "currency": "GBP"
        },
        "what_you_should_be_aware_of": "",
        "company_credibility_assessment": null,
        "what_we_like_about_this_company": [
            "This is a very large company with Total Assets in excess of £5 billion and Equity greater than £50 million.",
            "This company's auditors have reported no adverse information."
        ]
    },
    "ccj_exact": [
        {
            "date": "25 Mar 2020",
            "type": null,
            "court": "COUNTY COURT BUSINESS CENTRE",
            "amount": 9139.0,
            "status": "Judgment",
            "date_paid": null,
            "case_number": "G3AT671V"
        },
        //...
    ],
    "ccj_grouped": [],
    "ccj_possible": [
        {
            "date": "23 Sep 2015",
            "type": null,
            "court": "COUNTY COURT BUSINESS CENTRE",
            "amount": 43926.0,
            "status": "Judgment",
            "date_paid": null,
            "case_number": "B2QZ4N96"
        }
    ],
    "judicial_ccj": [],
    "order_logger": {
        "order": null,
        "api_key": null,
        "company": null,
        "country": null,
        "end_time": null,
        "provider": null,
        "start_time": null,
        "parsing_time": null,
        "pdf_traceback": null,
        "parsing_status": null,
        "provider_error": null,
        "sentry_event_id": null,
        "get_report_error": null,
        "get_status_error": null,
        "our_response_time": null,
        "parsing_exception": null,
        "place_order_error": null,
        "provider_duration": null,
        "provider_response": null,
        "get_status_counter": null,
        "get_report_duration": null,
        "get_report_response": null,
        "get_status_duration": null,
        "get_status_response": null,
        "pdf_generation_time": null,
        "pdf_report_document": null,
        "get_report_timestamp": null,
        "place_order_duration": null,
        "place_order_response": null,
        "provider_status_code": null,
        "pdf_generation_status": null,
        "place_order_timestamp": null,
        "provider_order_reason": null,
        "get_report_status_code": null,
        "get_status_status_code": null,
        "place_order_status_code": null,
        "check_order_availability_error": null,
        "check_order_availability_duration": null,
        "check_order_availability_response": null,
        "check_order_availability_timestamp": null,
        "check_order_availability_status_code": null
    },
    "shareholders": [
        {
            "name": "UNDISCLOSED",
            "address": null,
            "currency": "GBP",
            "quantity": 8174160481,
            "percentage": 100.0,
            "share_type": "ORDINARY",
            "start_date": null,
            "share_price": null,
            "total_value": 408708024.05,
            "share_classes": [
                {
                    "currency": "GBP",
                    "shareType": "ORDINARY",
                    "valuePerShare": 0.05,
                    "additionalData": {
                        "percentSharesHeld": 100.0
                    },
                    "valueOfSharesOwned": 408708024.05,
                    "numberOfSharesOwned": 8174160481
                }
            ],
            "shareholder_type": "Other"
        }
    ],
    "land_registry": [],
    "score_history": [
        {
            "date": "06-12-2019",
            "event": null,
            "score": 86,
            "description": "Very Low Risk"
        },
        //...
    ],
    "search_logger": {
        "query": null,
        "api_key": null,
        "country": null,
        "provider": null,
        "sentry_event_id": null,
        "our_response_time": null,
        "our_response_nr_companies": null,
        "provider_name_search_time": null,
        "provider_errors_name_search": null,
        "provider_reg_nr_search_time": null,
        "provider_errors_reg_nr_search": null,
        "provider_nr_companies_name_search": null,
        "provider_response_code_name_search": null,
        "provider_response_text_name_search": null,
        "provider_nr_companies_reg_nr_search": null,
        "provider_response_code_reg_nr_search": null,
        "provider_response_text_reg_nr_search": null
    },
    "branch_details": [
        {
            "fax": null,
            "tel": null,
            "name": null,
            "type": null,
            "address": null,
            "country": null
        },
        //...
    ],
    "employees_info": [
        {
            "year": 2021,
            "number_of_employees": "367321"
        },
        {
            "year": 2020,
            "number_of_employees": "354448"
        },
        {
            "year": 2019,
            "number_of_employees": "464505"
        },
        {
            "year": 2017,
            "number_of_employees": "464520"
        }
    ],
    "additional_misc": [],
    "company_profile": {
        "fax": "",
        "name": "TESCO PLC",
        "email": null,
        "status": "Active",
        "auditor": "DELOITTE LLP",
        "website": "https://www.tescoplc.com/",
        "province": null,
        "sic_code": "SIC03, 5211, Retail in non-specialised stores holding an alcohol licence, with food, beverages or tobacco predominating, not elsewhere classified; SIC07, 47110, Retail sale in non-specialised stores with food, beverages or tobacco predominating",
        "ofac_bool": null,
        "ofac_date": null,
        "post_code": "AL7 1GA",
        "source_id": null,
        "legal_form": "Public limited with Share Capital",
        "vat_number": "GB220430231",
        "export_bool": null,
        "import_bool": null,
        "main_products": null,
        "parent_company": null,
        "registered_city": null,
        "trading_address": "Tesco House Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA",
        "telephone_number": "+01992632222",
        "type_of_accounts": "Consolidated",
        "principal_activity": "SIC07, 47110, Retail sale in non-specialised stores with food, beverages or tobacco predominating",
        "registered_address": "TESCO HOUSE SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA",
        "registration_number": "00445790",
        "date_of_incorporation": "27-11-1947",
        "latest_filed_accounts": "16-07-2021",
        "stock_exchange_status": null,
        "cross_border_agent_bool": null,
        "ultimate_holding_company": null
    },
    "enquiries_trend": {
        "breakdown": {
            "month1": 12,
            "month2": 53,
            "month3": 79,
            "month4": 69,
            "month5": 89,
            "month6": 48,
            "month7": 95,
            "month8": 111,
            "month9": 72,
            "month10": 88,
            "month11": 105,
            "month12": 127,
            "months1to3": 144,
            "months4to6": 206,
            "months7to9": 278,
            "months10to12": 320,
            "monthlyAverage": 79.0,
            "latestEnquiryDate": "2021-09-11T14:58:30Z"
        },
        "total_3_months": 144,
        "total_6_months": 350,
        "total_9_months": 628,
        "total_12_months": 948,
        "the_last_enquiry_date": "11-09-2021",
        "average_reports_taken_each_month": "79",
        "number_of_enquiries_in_the_past_12_months": 948
    },
    "historic_health": [
        {
            "date": "26-06-2020",
            "event": "Profit Warning",
            "description": "Following revised macro-economic assumptions regarding GDP and unemployment levels, we have increased our provision for potential bad debts at Tesco Bank and we now expect to report a loss for the Bank of between £(175)m and £(200)m for the 2020/21 financial year.  We will continue to review any changes made to macro-economic forecasts and this could result in releases from or additions to this provision. Whilst headline profitability is impacted in the short term, the Bank's capital ratios and liquidity remain strong"
        }
    ],
    "trading_address": [
        {
            "phone": "+0345 6778993",
            "address": "1 Laurel Drive, Bridge Of Don, Aberdeen, Aberdeenshire, AB22 8HB"
        },
        //...
    ],
    "document_filings": [
        {
            "date": "16-07-2021",
            "description": "New Accounts Filed",
            "number_of_deeds": null
        },
        //...
    ],
    "coface_financials": [],
    "current_directors": [
        {
            "job": "Director",
            "name": "Ms Karen Tracy Whitworth",
            "title": "Ms",
            "gender": "Female",
            "address": "Tesco House Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA",
            "nationality": "British",
            "date_of_birth": "01-08-1969",
            "appointment_date": "18-06-2021",
            "current_appointments": 4
        },
        //...
    ],
    "administrative_ccj": [],
    "custom_data_tables": [],
    "financials_summary": {
        "ebitda": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2647000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "turnover": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    55917000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6438000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    45877000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "working_capital": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    -4332000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "employee_numbers": [
            {
                "date": "25-02-2017",
                "value": "464,520.00"
            },
            //...
        ],
        "profit_after_tax": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    58000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "reporting_period": [
            {
                "date": "25-02-2017",
                "value": "27-02-2016 - 25-02-2017"
            },
            //...
        ],
        "consolidated_a_cs": [
            {
                "date": "25-02-2017",
                "value": true
            },
            //...
        ],
        "total_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    39439000000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "import_export_info": {
        "export_info": null,
        "import_info": null,
        "export_countries": "",
        "import_countries": ""
    },
    "previous_directors": [
        {
            "job": null,
            "name": "Olivia Garfield",
            "title": null,
            "period": "",
            "address": null,
            "nationality": null,
            "date_of_birth": null,
            "total_appointments": null,
            "present_appointments": 0,
            "previous_appointments": 1,
            "dissolved_appointments": 0
        },
        //...
    ],
    "fresh_investigation": {
        "order": null,
        "status": null,
        "company": null,
        "due_date": null,
        "parameters": null,
        "date_checked": null,
        "date_created": null,
        "provider_country": null,
        "provider_order_id": null,
        "provider_response": null,
        "provider_investigation_status": null
    },
    "payment_information": [],
    "credit_limit_history": [
        {
            "date": "06-12-2019",
            "limit": {
                "value": 100000000.0,
                "currency": "GBP"
            },
            "description": null
        },
        //...
    ],
    "financials_cash_flow": {
        "increase_in_cash": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    881000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_change_in_cash": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    881000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_cash_flow_from_financing": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    -1387000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_cash_flow_from_operations": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1989000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_cash_flow_before_financing": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2268000000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "current_directorships": [],
    "mortgages_and_charges": [
        {
            "type": "ACCOUNT SECURITY AGREEMENT",
            "satisfied": null,
            "created_date": "04-11-2009",
            "registered_date": "06-11-2009",
            "persons_entitled": "TESCO TRUSTEE COMPANY OF IRELAND LIMITED AS TRUSTEE OF THE TESCO IRELAND LIMITED SENIOR EXECUTI",
            "further_information": "RIGHT TITLE BENEFIT AND INTEREST IN ANDTO THE ACCOUNT BEING THE EURO DESIGNATED ACCOUNT IN THE NAME OF THE COMPANY WITH SORT CODE 40-05-15 ACCOUNT NUMBER 67851117, AND THE DEPOSIT. SEE IMAGE FOR FULL DETAILS"
        },
        //...
    ],
    "previous_company_names": [
        {
            "name": "TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY",
            "period": "25-08-1983"
        }
    ],
    "previous_directorships": [],
    "share_capital_structure": {
        "issued_capital": 408708024.05,
        "nominal_capital": null,
        "issued_capital_currency": "GBP",
        "number_of_shares_issued": 8174160481,
        "nominal_capital_currency": null
    },
    "ccj_summarised_defendant": [],
    "ccj_summarised_plaintiff": [],
    "financials_balance_sheet": {
        "cash": [
            {
                "dynamics": 6.2,
                "indicator": [
                    "24-02-2018",
                    4059000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "stock": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2301000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6438000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "fixed_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    30804000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    45877000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "trade_debtors": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    697000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "bank_overdraft": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    912000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "current_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    15073000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "tangible_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    18108000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "trade_creditors": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    4914000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "intangible_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2717000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    39439000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_fixed_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    30804000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "current_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    19405000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "investment_and_other": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    9979000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "other_long_term_financing": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2986000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "other_short_term_financing": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    8584000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_long_term_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    20034000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "miscellaneous_current_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    4995000000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "group_structure_extended": [
        {
            "level": 0,
            "status": "Active",
            "address": null,
            "turnover": null,
            "net_worth": null,
            "company_name": "TESCO PLC",
            "registered_number": "00445790",
            "registered_country": "GB",
            "percent_of_ownership": null,
            "latest_annual_accounts": "27-02-2021"
        },
        //...
    ],
    "financials_kpis_and_ratios": {
        "net_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.001037251640824794
                ],
                "consolidated": true
            },
            //...
        ],
        "gross_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.05189834933919917
                ],
                "consolidated": true
            },
            //...
        ],
        "current_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.78
                ],
                "consolidated": true
            },
            //...
        ],
        "ebitda_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.047338018849366024
                ],
                "consolidated": true
            },
            //...
        ],
        "debt_to_capital": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.8596682433463392
                ],
                "consolidated": true
            },
            //...
        ],
        "liquidity_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.66
                ],
                "consolidated": true
            },
            //...
        ],
        "gearing_net_debt": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    3.9933209071140108
                ],
                "consolidated": true
            },
            //...
        ],
        "return_on_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.02216797087865379
                ],
                "consolidated": true
            },
            //...
        ],
        "return_on_equity": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.009009009009009009
                ],
                "consolidated": true
            },
            //...
        ],
        "consolidated_a_cs": [
            {
                "date": "25-02-2017",
                "value": true
            },
            //...
        ],
        "gearing_liability": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6.125970798384592
                ],
                "consolidated": true
            },
            //...
        ],
        "gearing_gross_debt": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    4.586828207517863
                ],
                "consolidated": true
            },
            //...
        ],
        "cash_turnover_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.06833342275157823
                ],
                "consolidated": true
            },
            //...
        ],
        "cash_to_total_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.08328792205244458
                ],
                "consolidated": true
            },
            //...
        ],
        "pre_tax_profit_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.26
                ],
                "consolidated": true
            },
            //...
        ],
        "operating_profit_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.01818767101239337
                ],
                "consolidated": true
            },
            //...
        ],
        "inventory_turnover_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    4.12
                ],
                "consolidated": true
            },
            //...
        ],
        "return_on_capital_employed": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.55
                ],
                "consolidated": true
            },
            //...
        ],
        "cash_to_current_liabilities_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.1969080133986086
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "financials_misc_indicators": {
        "goodwill": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    null
                ],
                "consolidated": true
            },
            //...
        ],
        "pensions": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.0
                ],
                "consolidated": true
            },
            //...
        ],
        "audit_fees": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "derivatives": "",
        "auditor_fees": "",
        "equity_shares": "",
        "all_other_income": "",
        "customer_accounts": "",
        "deposits_by_banks": "",
        "dividends_payable": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.0
                ],
                "consolidated": true
            },
            //...
        ],
        "contingent_liability": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    "YES"
                ],
                "consolidated": true
            },
            //...
        ],
        "employee_remuneration": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6051000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "financial_liabilities": "",
        "interest_bearing_loans": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    9330000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "amortisation_of_intangibles": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    299000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "fees_and_commission_expense": "",
        "interest_and_similar_income": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    null
                ],
                "consolidated": true
            },
            //...
        ],
        "loans_and_advances_to_banks": "",
        "interest_and_similar_expense": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1015000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "loans_and_advances_to_customers": "",
        "derivative_financial_instruments": "",
        "cash_and_balances_at_central_banks": "",
        "available_for_sale_financial_assets": "",
        "treasury_bill_and_other_eligible_bills": "",
        "items_in_the_course_of_collection_from_other_banks": "",
        "items_in_the_course_of_transmission_from_other_banks": ""
    },
    "financials_profit_and_loss": {
        "weeks": [
            {
                "date": "25-02-2017",
                "value": 52
            },
            //...
        ],
        "export": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    null
                ],
                "consolidated": true
            },
            //...
        ],
        "currency": [
            {
                "date": "25-02-2017",
                "value": "GBP"
            },
            //...
        ],
        "taxation": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    -87000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "audit_fees": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "depreciation": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1331000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "gross_profit": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2902000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "pre_tax_profit": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    145000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "retained_profit": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    -40000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "operating_profit": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1017000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "profit_after_tax": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    58000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "consolidated_a_cs": [
            {
                "date": "25-02-2017",
                "value": true
            },
            //...
        ],
        "dividends_payable": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.0
                ],
                "consolidated": true
            },
            //...
        ],
        "interest_payments": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1015000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "wages_and_salaries": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6051000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "directors_emoluments": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    7800000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "group_structure_affiliated": [],
    "current_company_secretaries": [
        {
            "job": "Company Secretary",
            "name": "Mr Robert John Welch",
            "title": "Mr",
            "period": null,
            "address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA",
            "nationality": null,
            "date_of_birth": null,
            "appointment_date": "10-08-2016",
            "current_appointments": 1
        }
    ],
    "group_structure_subsidiaries": [
        {
            "level": null,
            "status": "Active",
            "address": null,
            "turnover": null,
            "net_worth": null,
            "company_name": "TESCO TRUSTEE COMPANY OF IRELAND DESIGNATED ACTIVITY COMPANY",
            "registered_number": "IE096453",
            "registered_country": "IE",
            "latest_annual_accounts": null
        },
        //...
    ],
    "previous_company_secretaries": [],
    "financials_capital_and_reserves": {
        "equity_paid_up": "",
        "sundry_reserves": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    5697000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "capital_employed": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    26472000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "interest_payments": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1015000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "shareholder_funds": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6438000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "revaluation_reserve": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.0
                ],
                "consolidated": true
            },
            //...
        ],
        "called_up_share_capital": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    409000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "p_and_l_account_reserve": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    332000000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "financials_growth_and_industry_comparison": {
        "net_assets": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "total_assets": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "current_ratio": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "debt_to_capital": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "working_capital": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "consolidated_a_cs": [
            {
                "date": "25-02-2017",
                "value": true
            },
            //...
        ],
        "total_liabilities": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ]
    },
    "name": "TESCO PLC",
    "nr": 634
}

GET https://api.globaldatabase.com/v2/credit-report/report/{format}/{report_id}/file

Introduce the Credit Report ID to get access to the requested Credit Report.

Parameters

Parameter	In	Type	Required	Description
format	url	string	false	Response format: json or html. If not specified, json is used by default.
report_id	url	int	true	Report Id

Generate CR and Get Content

Code samples

curl -X POST 'https://platform.globaldatabase.com/v2/credit-report/report/json/file' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "source_id": "GB-0-00445790",
    "country": "GB"
}'

Request example

{
    "source_id": "GB-0-00445790",
    "country": "GB"
}

Success Response

{
    "ccj": [],
    "liens": [],
    "bankers": [],
    "summary": {
        "ebitda": 4516000000.0,
        "charges": 2,
        "country": "GB",
        "comments": null,
        "extended": [
            {
                "Charges": 2,
                "Mortgages": 9,
                "Court Judgments": 8
            },
            {
                "EBITDA": 4516000000.0,
                "Turnover": 57887000000.0,
                "Age of Business": 73,
                "Number of Employees": "367321"
            }
        ],
        "language": "EN",
        "turnover": 57887000000.0,
        "mortgages": 9,
        "last_update": null,
        "nsso_number": null,
        "cash_at_bank": 2510000000.0,
        "nsso_summons": null,
        "liable_for_vat": null,
        "age_of_business": 73,
        "fin_information": null,
        "charges_dynamics": null,
        "court_judgements": 8,
        "derogatory_legal": null,
        "mortgages_dynamics": "04-11-2009",
        "rating_information": null,
        "shareholder_equity": 12343000000.0,
        "things_to_consider": [
            "This company has been treated as a PLC company in terms of the score/limit that has been generated",
            "This company's Asset Ratio shows a moderate amount of cover on outstanding obligations."
        ],
        "company_description": "",
        "number_of_employees": "367321",
        "overall_credit_risk": {
            "pod": 0.0597,
            "commonValue": "A",
            "creditLimit": {
                "value": "100000000",
                "currency": "GBP"
            },
            "providerValue": {
                "value": "86",
                "maxValue": "100",
                "minValue": "1"
            },
            "commonDescription": "Very Low Risk",
            "providerDescription": "Very Low Risk"
        },
        "payment_information": null,
        "protested_bills_flag": null,
        "additional_foreign_oenb": null,
        "credit_score_description": null,
        "pd_according_to_basel_ii": null,
        "court_judgements_dynamics": null,
        "overall_credit_risk_class": "Very Low Risk",
        "credit_limit_recommendation": {
            "value": "100000000",
            "currency": "GBP"
        },
        "what_you_should_be_aware_of": "",
        "company_credibility_assessment": null,
        "what_we_like_about_this_company": [
            "This is a very large company with Total Assets in excess of £5 billion and Equity greater than £50 million.",
            "This company's auditors have reported no adverse information."
        ]
    },
    "ccj_exact": [
        {
            "date": "25 Mar 2020",
            "type": null,
            "court": "COUNTY COURT BUSINESS CENTRE",
            "amount": 9139.0,
            "status": "Judgment",
            "date_paid": null,
            "case_number": "G3AT671V"
        },
        //...
    ],
    "ccj_grouped": [],
    "ccj_possible": [
        {
            "date": "23 Sep 2015",
            "type": null,
            "court": "COUNTY COURT BUSINESS CENTRE",
            "amount": 43926.0,
            "status": "Judgment",
            "date_paid": null,
            "case_number": "B2QZ4N96"
        }
    ],
    "judicial_ccj": [],
    "order_logger": {
        "order": null,
        "api_key": null,
        "company": null,
        "country": null,
        "end_time": null,
        "provider": null,
        "start_time": null,
        "parsing_time": null,
        "pdf_traceback": null,
        "parsing_status": null,
        "provider_error": null,
        "sentry_event_id": null,
        "get_report_error": null,
        "get_status_error": null,
        "our_response_time": null,
        "parsing_exception": null,
        "place_order_error": null,
        "provider_duration": null,
        "provider_response": null,
        "get_status_counter": null,
        "get_report_duration": null,
        "get_report_response": null,
        "get_status_duration": null,
        "get_status_response": null,
        "pdf_generation_time": null,
        "pdf_report_document": null,
        "get_report_timestamp": null,
        "place_order_duration": null,
        "place_order_response": null,
        "provider_status_code": null,
        "pdf_generation_status": null,
        "place_order_timestamp": null,
        "provider_order_reason": null,
        "get_report_status_code": null,
        "get_status_status_code": null,
        "place_order_status_code": null,
        "check_order_availability_error": null,
        "check_order_availability_duration": null,
        "check_order_availability_response": null,
        "check_order_availability_timestamp": null,
        "check_order_availability_status_code": null
    },
    "shareholders": [
        {
            "name": "UNDISCLOSED",
            "address": null,
            "currency": "GBP",
            "quantity": 8174160481,
            "percentage": 100.0,
            "share_type": "ORDINARY",
            "start_date": null,
            "share_price": null,
            "total_value": 408708024.05,
            "share_classes": [
                {
                    "currency": "GBP",
                    "shareType": "ORDINARY",
                    "valuePerShare": 0.05,
                    "additionalData": {
                        "percentSharesHeld": 100.0
                    },
                    "valueOfSharesOwned": 408708024.05,
                    "numberOfSharesOwned": 8174160481
                }
            ],
            "shareholder_type": "Other"
        }
    ],
    "land_registry": [],
    "score_history": [
        {
            "date": "06-12-2019",
            "event": null,
            "score": 86,
            "description": "Very Low Risk"
        },
        //...
    ],
    "search_logger": {
        "query": null,
        "api_key": null,
        "country": null,
        "provider": null,
        "sentry_event_id": null,
        "our_response_time": null,
        "our_response_nr_companies": null,
        "provider_name_search_time": null,
        "provider_errors_name_search": null,
        "provider_reg_nr_search_time": null,
        "provider_errors_reg_nr_search": null,
        "provider_nr_companies_name_search": null,
        "provider_response_code_name_search": null,
        "provider_response_text_name_search": null,
        "provider_nr_companies_reg_nr_search": null,
        "provider_response_code_reg_nr_search": null,
        "provider_response_text_reg_nr_search": null
    },
    "branch_details": [
        {
            "fax": null,
            "tel": null,
            "name": null,
            "type": null,
            "address": null,
            "country": null
        },
        //...
    ],
    "employees_info": [
        {
            "year": 2021,
            "number_of_employees": "367321"
        },
        {
            "year": 2020,
            "number_of_employees": "354448"
        },
        {
            "year": 2019,
            "number_of_employees": "464505"
        },
        {
            "year": 2017,
            "number_of_employees": "464520"
        }
    ],
    "additional_misc": [],
    "company_profile": {
        "fax": "",
        "name": "TESCO PLC",
        "email": null,
        "status": "Active",
        "auditor": "DELOITTE LLP",
        "website": "https://www.tescoplc.com/",
        "province": null,
        "sic_code": "SIC03, 5211, Retail in non-specialised stores holding an alcohol licence, with food, beverages or tobacco predominating, not elsewhere classified; SIC07, 47110, Retail sale in non-specialised stores with food, beverages or tobacco predominating",
        "ofac_bool": null,
        "ofac_date": null,
        "post_code": "AL7 1GA",
        "source_id": null,
        "legal_form": "Public limited with Share Capital",
        "vat_number": "GB220430231",
        "export_bool": null,
        "import_bool": null,
        "main_products": null,
        "parent_company": null,
        "registered_city": null,
        "trading_address": "Tesco House Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA",
        "telephone_number": "+01992632222",
        "type_of_accounts": "Consolidated",
        "principal_activity": "SIC07, 47110, Retail sale in non-specialised stores with food, beverages or tobacco predominating",
        "registered_address": "TESCO HOUSE SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA",
        "registration_number": "00445790",
        "date_of_incorporation": "27-11-1947",
        "latest_filed_accounts": "16-07-2021",
        "stock_exchange_status": null,
        "cross_border_agent_bool": null,
        "ultimate_holding_company": null
    },
    "enquiries_trend": {
        "breakdown": {
            "month1": 12,
            "month2": 53,
            "month3": 79,
            "month4": 69,
            "month5": 89,
            "month6": 48,
            "month7": 95,
            "month8": 111,
            "month9": 72,
            "month10": 88,
            "month11": 105,
            "month12": 127,
            "months1to3": 144,
            "months4to6": 206,
            "months7to9": 278,
            "months10to12": 320,
            "monthlyAverage": 79.0,
            "latestEnquiryDate": "2021-09-11T14:58:30Z"
        },
        "total_3_months": 144,
        "total_6_months": 350,
        "total_9_months": 628,
        "total_12_months": 948,
        "the_last_enquiry_date": "11-09-2021",
        "average_reports_taken_each_month": "79",
        "number_of_enquiries_in_the_past_12_months": 948
    },
    "historic_health": [
        {
            "date": "26-06-2020",
            "event": "Profit Warning",
            "description": "Following revised macro-economic assumptions regarding GDP and unemployment levels, we have increased our provision for potential bad debts at Tesco Bank and we now expect to report a loss for the Bank of between £(175)m and £(200)m for the 2020/21 financial year.  We will continue to review any changes made to macro-economic forecasts and this could result in releases from or additions to this provision. Whilst headline profitability is impacted in the short term, the Bank's capital ratios and liquidity remain strong"
        }
    ],
    "trading_address": [
        {
            "phone": "+0345 6778993",
            "address": "1 Laurel Drive, Bridge Of Don, Aberdeen, Aberdeenshire, AB22 8HB"
        },
        //...
    ],
    "document_filings": [
        {
            "date": "16-07-2021",
            "description": "New Accounts Filed",
            "number_of_deeds": null
        },
        //...
    ],
    "coface_financials": [],
    "current_directors": [
        {
            "job": "Director",
            "name": "Ms Karen Tracy Whitworth",
            "title": "Ms",
            "gender": "Female",
            "address": "Tesco House Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA",
            "nationality": "British",
            "date_of_birth": "01-08-1969",
            "appointment_date": "18-06-2021",
            "current_appointments": 4
        },
        //...
    ],
    "administrative_ccj": [],
    "custom_data_tables": [],
    "financials_summary": {
        "ebitda": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2647000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "turnover": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    55917000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6438000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    45877000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "working_capital": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    -4332000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "employee_numbers": [
            {
                "date": "25-02-2017",
                "value": "464,520.00"
            },
            //...
        ],
        "profit_after_tax": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    58000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "reporting_period": [
            {
                "date": "25-02-2017",
                "value": "27-02-2016 - 25-02-2017"
            },
            //...
        ],
        "consolidated_a_cs": [
            {
                "date": "25-02-2017",
                "value": true
            },
            //...
        ],
        "total_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    39439000000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "import_export_info": {
        "export_info": null,
        "import_info": null,
        "export_countries": "",
        "import_countries": ""
    },
    "previous_directors": [
        {
            "job": null,
            "name": "Olivia Garfield",
            "title": null,
            "period": "",
            "address": null,
            "nationality": null,
            "date_of_birth": null,
            "total_appointments": null,
            "present_appointments": 0,
            "previous_appointments": 1,
            "dissolved_appointments": 0
        },
        //...
    ],
    "fresh_investigation": {
        "order": null,
        "status": null,
        "company": null,
        "due_date": null,
        "parameters": null,
        "date_checked": null,
        "date_created": null,
        "provider_country": null,
        "provider_order_id": null,
        "provider_response": null,
        "provider_investigation_status": null
    },
    "payment_information": [],
    "credit_limit_history": [
        {
            "date": "06-12-2019",
            "limit": {
                "value": 100000000.0,
                "currency": "GBP"
            },
            "description": null
        },
        //...
    ],
    "financials_cash_flow": {
        "increase_in_cash": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    881000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_change_in_cash": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    881000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_cash_flow_from_financing": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    -1387000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_cash_flow_from_operations": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1989000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_cash_flow_before_financing": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2268000000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "current_directorships": [],
    "mortgages_and_charges": [
        {
            "type": "ACCOUNT SECURITY AGREEMENT",
            "satisfied": null,
            "created_date": "04-11-2009",
            "registered_date": "06-11-2009",
            "persons_entitled": "TESCO TRUSTEE COMPANY OF IRELAND LIMITED AS TRUSTEE OF THE TESCO IRELAND LIMITED SENIOR EXECUTI",
            "further_information": "RIGHT TITLE BENEFIT AND INTEREST IN ANDTO THE ACCOUNT BEING THE EURO DESIGNATED ACCOUNT IN THE NAME OF THE COMPANY WITH SORT CODE 40-05-15 ACCOUNT NUMBER 67851117, AND THE DEPOSIT. SEE IMAGE FOR FULL DETAILS"
        },
        //...
    ],
    "previous_company_names": [
        {
            "name": "TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY",
            "period": "25-08-1983"
        }
    ],
    "previous_directorships": [],
    "share_capital_structure": {
        "issued_capital": 408708024.05,
        "nominal_capital": null,
        "issued_capital_currency": "GBP",
        "number_of_shares_issued": 8174160481,
        "nominal_capital_currency": null
    },
    "ccj_summarised_defendant": [],
    "ccj_summarised_plaintiff": [],
    "financials_balance_sheet": {
        "cash": [
            {
                "dynamics": 6.2,
                "indicator": [
                    "24-02-2018",
                    4059000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "stock": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2301000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "net_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6438000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "fixed_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    30804000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    45877000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "trade_debtors": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    697000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "bank_overdraft": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    912000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "current_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    15073000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "tangible_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    18108000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "trade_creditors": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    4914000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "intangible_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2717000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    39439000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_fixed_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    30804000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "current_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    19405000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "investment_and_other": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    9979000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "other_long_term_financing": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2986000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "other_short_term_financing": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    8584000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "total_long_term_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    20034000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "miscellaneous_current_liabilities": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    4995000000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "group_structure_extended": [
        {
            "level": 0,
            "status": "Active",
            "address": null,
            "turnover": null,
            "net_worth": null,
            "company_name": "TESCO PLC",
            "registered_number": "00445790",
            "registered_country": "GB",
            "percent_of_ownership": null,
            "latest_annual_accounts": "27-02-2021"
        },
        //...
    ],
    "financials_kpis_and_ratios": {
        "net_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.001037251640824794
                ],
                "consolidated": true
            },
            //...
        ],
        "gross_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.05189834933919917
                ],
                "consolidated": true
            },
            //...
        ],
        "current_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.78
                ],
                "consolidated": true
            },
            //...
        ],
        "ebitda_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.047338018849366024
                ],
                "consolidated": true
            },
            //...
        ],
        "debt_to_capital": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.8596682433463392
                ],
                "consolidated": true
            },
            //...
        ],
        "liquidity_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.66
                ],
                "consolidated": true
            },
            //...
        ],
        "gearing_net_debt": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    3.9933209071140108
                ],
                "consolidated": true
            },
            //...
        ],
        "return_on_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.02216797087865379
                ],
                "consolidated": true
            },
            //...
        ],
        "return_on_equity": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.009009009009009009
                ],
                "consolidated": true
            },
            //...
        ],
        "consolidated_a_cs": [
            {
                "date": "25-02-2017",
                "value": true
            },
            //...
        ],
        "gearing_liability": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6.125970798384592
                ],
                "consolidated": true
            },
            //...
        ],
        "gearing_gross_debt": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    4.586828207517863
                ],
                "consolidated": true
            },
            //...
        ],
        "cash_turnover_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.06833342275157823
                ],
                "consolidated": true
            },
            //...
        ],
        "cash_to_total_assets": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.08328792205244458
                ],
                "consolidated": true
            },
            //...
        ],
        "pre_tax_profit_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.26
                ],
                "consolidated": true
            },
            //...
        ],
        "operating_profit_margin": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.01818767101239337
                ],
                "consolidated": true
            },
            //...
        ],
        "inventory_turnover_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    4.12
                ],
                "consolidated": true
            },
            //...
        ],
        "return_on_capital_employed": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.55
                ],
                "consolidated": true
            },
            //...
        ],
        "cash_to_current_liabilities_ratio": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.1969080133986086
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "financials_misc_indicators": {
        "goodwill": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    null
                ],
                "consolidated": true
            },
            //...
        ],
        "pensions": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.0
                ],
                "consolidated": true
            },
            //...
        ],
        "audit_fees": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "derivatives": "",
        "auditor_fees": "",
        "equity_shares": "",
        "all_other_income": "",
        "customer_accounts": "",
        "deposits_by_banks": "",
        "dividends_payable": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.0
                ],
                "consolidated": true
            },
            //...
        ],
        "contingent_liability": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    "YES"
                ],
                "consolidated": true
            },
            //...
        ],
        "employee_remuneration": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6051000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "financial_liabilities": "",
        "interest_bearing_loans": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    9330000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "amortisation_of_intangibles": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    299000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "fees_and_commission_expense": "",
        "interest_and_similar_income": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    null
                ],
                "consolidated": true
            },
            //...
        ],
        "loans_and_advances_to_banks": "",
        "interest_and_similar_expense": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1015000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "loans_and_advances_to_customers": "",
        "derivative_financial_instruments": "",
        "cash_and_balances_at_central_banks": "",
        "available_for_sale_financial_assets": "",
        "treasury_bill_and_other_eligible_bills": "",
        "items_in_the_course_of_collection_from_other_banks": "",
        "items_in_the_course_of_transmission_from_other_banks": ""
    },
    "financials_profit_and_loss": {
        "weeks": [
            {
                "date": "25-02-2017",
                "value": 52
            },
            //...
        ],
        "export": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    null
                ],
                "consolidated": true
            },
            //...
        ],
        "currency": [
            {
                "date": "25-02-2017",
                "value": "GBP"
            },
            //...
        ],
        "taxation": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    -87000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "audit_fees": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "depreciation": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1331000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "gross_profit": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    2902000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "pre_tax_profit": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    145000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "retained_profit": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    -40000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "operating_profit": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1017000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "profit_after_tax": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    58000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "consolidated_a_cs": [
            {
                "date": "25-02-2017",
                "value": true
            },
            //...
        ],
        "dividends_payable": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.0
                ],
                "consolidated": true
            },
            //...
        ],
        "interest_payments": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1015000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "wages_and_salaries": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6051000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "directors_emoluments": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    7800000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "group_structure_affiliated": [],
    "current_company_secretaries": [
        {
            "job": "Company Secretary",
            "name": "Mr Robert John Welch",
            "title": "Mr",
            "period": null,
            "address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA",
            "nationality": null,
            "date_of_birth": null,
            "appointment_date": "10-08-2016",
            "current_appointments": 1
        }
    ],
    "group_structure_subsidiaries": [
        {
            "level": null,
            "status": "Active",
            "address": null,
            "turnover": null,
            "net_worth": null,
            "company_name": "TESCO TRUSTEE COMPANY OF IRELAND DESIGNATED ACTIVITY COMPANY",
            "registered_number": "IE096453",
            "registered_country": "IE",
            "latest_annual_accounts": null
        },
        //...
    ],
    "previous_company_secretaries": [],
    "financials_capital_and_reserves": {
        "equity_paid_up": "",
        "sundry_reserves": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    5697000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "capital_employed": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    26472000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "interest_payments": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    1015000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "shareholder_funds": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    6438000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "revaluation_reserve": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    0.0
                ],
                "consolidated": true
            },
            //...
        ],
        "called_up_share_capital": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    409000000.0
                ],
                "consolidated": true
            },
            //...
        ],
        "p_and_l_account_reserve": [
            {
                "dynamics": null,
                "indicator": [
                    "25-02-2017",
                    332000000.0
                ],
                "consolidated": true
            },
            //...
        ]
    },
    "financials_growth_and_industry_comparison": {
        "net_assets": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "total_assets": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "current_ratio": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "debt_to_capital": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "working_capital": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ],
        "consolidated_a_cs": [
            {
                "date": "25-02-2017",
                "value": true
            },
            //...
        ],
        "total_liabilities": [
            {
                "date": "2017 vs 2016",
                "value": null
            },
            //...
        ]
    },
    "name": "TESCO PLC",
    "nr": 634
}

POST https://api.globaldatabase.com/v2/credit-report/report/{format}/file

A unified model of the Generate Credit Report and Get/View Credit Report by ID, can be used to avoid the 2-step process. This option is better for single requests where the delay in the Generate Credit Report phase will not cause a problem for you or your end-customer.

Parameters

Parameter	In	Type	Required	Description
format	url	string	false	Response format: json or html. If not specified, json is used by default.
source_id	body	string	true	Source Id
country	body	string	true	Country Code ISO

Response Properties

Get Credit Report by ID

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/credit-report/report/json/52' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
    "report_id": 52
}

Success Response

{
    "id": 52,
    "name": "TESCO PLC",
    "source_id": "GB-0-00445790",
    "url": null,
    "expired": false,
    "date_created": "2021-09-30T07:09:57.081437Z",
    "address": {
        "province": null,
        "post_code": "AL7 1GA",
        "city": "WELWYN GARDEN CITY",
        "text": "TESCO HOUSE SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA, WELWYN GARDEN CITY, None, AL7 1GA, GB",
        "street": "TESCO HOUSE SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA"
    },
    "status": "finish",
    "registration_number": "00445790"
}

GET https://api.globaldatabase.com/v2/credit-report/report/{format}/{report_id}

Get Credit Report by ID

Parameters

Parameter	In	Type	Required	Description
format	url	string	false	Response format: json or html. If not specified, json is used by default.
report_id	url	int	true	Report Id

Purchased Credit Report

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/credit-report/purchased?search=tesco' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Request example

{
    "page": 1,
    "per_page": 10,
    "search": "tesco"
}

Success Response

{
    "data": [
        {
            "id": 31,
            "name": "TESCO PLC",
            "source_id": "GB-0-00445790",
            "expired": false,
            "date_created": "2021-09-16T08:08:13.951869Z",
            "address": {
                "city": "WELWYN GARDEN CITY",
                "text": "TESCO HOUSE SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA, WELWYN GARDEN CITY, None, AL7 1GA, None",
                "street": "TESCO HOUSE SHIRE PARK, KESTREL WAY, WELWYN GARDEN CITY, AL7 1GA",
                "province": null,
                "post_code": "AL7 1GA"
            },
            "status": "finish",
            "country": "GB",
            "registration_number": "00445790"
        }
    ],
    "total_results": 1,
    "pages": 1
}

GET https://api.globaldatabase.com/v2/credit-report/purchased

Purchased Credit Reports. Here you can review the previously Generated Credit Reports as well as access them without using your allotted credits.

Parameters

Parameter	In	Type	Required	Description
search	body	string	false	Company Name
page	body	int	false	Page
per_page	body	int	false	Per Page

Bank Verification API

The Bank Verification API exposes Verification of Payee (VOP) checks across 30+ countries. Verify account status, name, and identity before initiating payments — reducing fraud and mis-direction risk in B2B and B2C payment flows.

Each request returns a structured result describing whether the account exists, whether the supplied beneficiary name matches the account holder, and (where supported) whether the supplied identity (national ID, company ID, etc.) matches the account.

A history of all verifications is persisted per user and can be retrieved later.

Verify Bank Account

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/bank-verification' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    {
  "query": {
    "types": [
      "NAME"
    ],
    "account": {
      "id": "04000316052184",
      "name": "global data intelligence",
      "type": "BUSINESS",
      "id_scheme": "SCAN"
    }
  }
}'

Request example (GB — SCAN)

{
  "query": {
    "types": [
      "NAME"
    ],
    "account": {
      "id": "04000316052184",
      "name": "global data intelligence",
      "type": "BUSINESS",
      "id_scheme": "SCAN"
    }
  }
}

Request example (EPC RO — IBAN)

{
  "query": {
    "types": [
      "NAME"
    ],
    "account": {
      "id": "RO00REVO0000000000000000",
      "name": "FirstName LastName",
      "id_scheme": "IBAN"
    }
  }
}

Success Response

{
    "id": "QUFW1061",
    "country": "RO",
    "account_id": "RO00REVO0000000000000000",
    "account_id_scheme": "IBAN",
    "bank_id": "REVOROBBXXX",
    "bank_id_scheme": "BICFI",
    "request_name": "FirstName LastName",
    "response_name": null,
    "request_sent": "2026-05-05T06:16:43.95031Z",
    "request_status": "SUCCESS",
    "request_source": "SINGLE",
    "account_status": "ACTIVE",
    "response_matched": true,
    "response_reason_code": "FULL_MATCH",
    "transaction_notes": []
}

POST https://api.globaldatabase.com/v2/bank-verification

Submit a Verification of Payee request and receive a structured verification result.

Common use cases:

• Confirm beneficiary account before initiating B2B payments
• Confirm legal-entity identity (LEI/TXID) before onboarding
• Reduce mis-direction and APP fraud risk

Parameters

The request body has two top-level objects: query (required, holds the verification target) and initiator (optional, identifies the requester). Per-country fields and required combinations are listed in the Country reference.

Top level

Field	Type	Required	Description
query	object	yes	Verification target.
initiator	object	no	Party requesting the verification.

query

Field	Type	Required	Description
types	string[]	no	Not used: the checks (STATUS, NAME, ID) are chosen by country, as listed in the Country reference. Accepted for backward compatibility.
country	string	no	Country code from the Country reference (GB, EPC, US, BR, …). Strongly recommended: it selects the verification types and the validation rules for the account. Without it the account is not validated and only a NAME check is run.
account	object	yes	Account being verified — see below.

query.account

Field	Type	Required	Description
id_scheme	string	yes	Account scheme: SCAN, IBAN, ACNR, CBU, CVU, CLABE, CCI, or a proxy identifier: EMAL (email), MBNO (mobile number), FPSID (FPS ID), NRIC.
id	string	yes	Account identifier. For SCAN, concatenate sort code + account number. For proxy schemes (EMAL, MBNO, FPSID, NRIC) send the email, phone number, FPS ID or NRIC itself (up to 150 chars). For other schemes use IBAN or account number directly. Length limits per scheme are in the Country reference.
name	string	conditional	Beneficiary name. Format: LastName,FirstName (structured) or ,,,Full Name (unstructured). Required for NAME checks.
type	string	no	BUSINESS or PERSONAL. Used by GB/SCAN only.
secondary_id	string	no	Secondary reference. Used by GB/SCAN only.
holding_entity	object	conditional	Bank holding entity — see below. Required whenever the scheme lists a bank_id field in the Country reference (every ACNR scheme, e.g. BICFI_ACNR, CNAPS_ACNR, USABA_ACNR): the bank is identified by it, so an ACNR account without it is rejected with 400. Not needed for IBAN.
identities	object[]	conditional	Account-holder identities — see below. Required for ID checks: NIDN for Brazil; COID or NIDN for South Africa.

query.account.holding_entity

Field	Type	Required	Description
type	string	yes	Holding entity type: BICFI, GBDSC, USABA, CACPA, CNAPS, INFSC, BRBKBR, ZANCC.
value	string	yes	Holding entity value (BIC/SWIFT, sort code, routing number, …).

query.account.identities[]

Field	Type	Required	Description
type	string	yes	Identity type: LEI, TXID, DUNS, COID, CCPT, …. Full list under Identity types.
value	string	yes	Identity value.

initiator

Field	Type	Required	Description
id_type	string	no	Initiator identity type.
id_value	string	no	Initiator identity value.
reference	string	no	Free-form client reference.

Country reference

Each country exposes one or more account schemes. Pick the scheme matching the account format you have, populate the listed fields under query.account, and request only the verification types allowed for that country.

Country index

Code	Country	Schemes	Allowed types
AR	Argentina	CBU, CVU	NAME, STATUS
AU	Australia	EMAL	NAME, STATUS
BD	Bangladesh	BICFI_ACNR	NAME, STATUS
BR	Brazil	IBAN, IBAN_BICFI, BRBKBR_ACNR	NAME, STATUS, ID
CA	Canada	BICFI_ACNR, CACPA_ACNR	NAME, STATUS
CN	China	BICFI_ACNR, CNAPS_ACNR	NAME, STATUS
CO	Colombia	BICFI_ACNR	NAME, STATUS, ID
ET	Ethiopia	BICFI_ACNR	NAME, STATUS
GH	Ghana	BICFI_ACNR	NAME, STATUS
HK	Hong Kong	FPSID	NAME, STATUS
IN	India	INFSC_ACNR, BICFI_ACNR	NAME, STATUS
ID	Indonesia	BICFI_ACNR	NAME, STATUS
KE	Kenya	BICFI_ACNR	NAME, STATUS
MY	Malaysia	BICFI_ACNR, NRIC	NAME, STATUS
MX	Mexico	CLABE, CLABE_BICFI	NAME, STATUS
NP	Nepal	BICFI_ACNR	NAME, STATUS
NG	Nigeria	BICFI_ACNR	NAME, STATUS
PK	Pakistan	BICFI_ACNR	NAME, STATUS
PE	Peru	CCI	NAME, STATUS
SA	Saudi Arabia	BICFI_ACNR	NAME, STATUS
SG	Singapore	MBNO	NAME, STATUS
KR	South Korea	BICFI_ACNR	NAME, STATUS
TW	Taiwan	BICFI_ACNR	NAME, STATUS
TZ	Tanzania	BICFI_ACNR	NAME, STATUS
TH	Thailand	BICFI_ACNR	NAME, STATUS
UG	Uganda	BICFI_ACNR	NAME, STATUS
AE	UAE	IBAN	NAME, STATUS
UY	Uruguay	BICFI_ACNR	NAME, STATUS
US	United States	USABA_ACNR	NAME, STATUS
VN	Vietnam	BICFI_ACNR	NAME, STATUS
ZM	Zambia	BICFI_ACNR	NAME, STATUS
EPC	European Payments Council	IBAN_BICFI	NAME
GB	United Kingdom	SCAN, IBAN	NAME
ZA	South Africa	ZANCC_ACNR	NAME, STATUS, ID

Argentina (AR)

Allowed verification types: NAME, STATUS

Schemes: CBU, CVU

Scheme CBU — CBU

• id_scheme: CBU
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	exactly 22 chars; pattern ^[0-9]{22}$
name	text	yes	—

Scheme CVU — CVU

• id_scheme: CVU
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	exactly 22 chars; pattern ^[0-9]{22}$
name	text	yes	—

Australia (AU)

Allowed verification types: NAME, STATUS

Schemes: EMAL

Scheme EMAL — Email

• id_scheme: EMAL
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	up to 150 chars
name	text	yes	—

Bangladesh (BD)

Status: Coming soon — endpoint not yet active for this country.

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Brazil (BR)

Allowed verification types: NAME, STATUS, ID

Schemes: IBAN, IBAN_BICFI, BRBKBR_ACNR

Scheme IBAN — IBAN

• id_scheme: IBAN
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	5–34 chars; pattern ^[A-Za-z0-9]{5,34}$
name	text	no	—
identity	identity	yes	11–14 chars; pattern ^[0-9]{11,14}$; identity type NIDN

Scheme IBAN_BICFI — IBAN and BICFI

• id_scheme: IBAN
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	5–34 chars; pattern ^[A-Za-z0-9]{5,34}$
name	text	no	—
identity	identity	yes	11–14 chars; pattern ^[0-9]{11,14}$; identity type NIDN

Scheme BRBKBR_ACNR — Account Number and BRBKBR

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	7–9 chars; holding entity BRBKBR
account_id	text	yes	up to 34 chars
identity	identity	yes	11–14 chars; pattern ^[0-9]{11,14}$; identity type NIDN
name	text	yes	—

Canada (CA)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR, CACPA_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Scheme CACPA_ACNR — Account Number and CACPA

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	exactly 9 chars; holding entity CACPA
account_id	text	yes	7–12 chars
name	text	yes	—

China (CN)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR, CNAPS_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Scheme CNAPS_ACNR — Account Number and CNAPS

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	exactly 12 chars; holding entity CNAPS
account_id	text	yes	up to 34 chars
name	text	yes	—

Colombia (CO)

Allowed verification types: NAME, STATUS, ID

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Ethiopia (ET)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Ghana (GH)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Hong Kong (HK)

Allowed verification types: NAME, STATUS

Schemes: FPSID

Scheme FPSID — FPS ID

• id_scheme: FPSID
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	up to 150 chars
name	text	yes	—

India (IN)

Allowed verification types: NAME, STATUS

Schemes: INFSC_ACNR, BICFI_ACNR

Scheme INFSC_ACNR — Account Number and INFSC

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	exactly 11 chars; holding entity INFSC
account_id	text	yes	up to 34 chars
name	text	yes	—

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Indonesia (ID)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Kenya (KE)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Malaysia (MY)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR, NRIC

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Scheme NRIC — NRIC

• id_scheme: NRIC
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	up to 150 chars
name	text	yes	—

Mexico (MX)

Allowed verification types: NAME, STATUS

Schemes: CLABE, CLABE_BICFI

Scheme CLABE — CLABE

• id_scheme: CLABE
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	exactly 18 chars; pattern ^[A-Za-z0-9]{18}$
name	text	no	—

Scheme CLABE_BICFI — CLABE and BICFI

• id_scheme: CLABE
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	exactly 18 chars; pattern ^[A-Za-z0-9]{18}$
name	text	no	—

Nepal (NP)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Nigeria (NG)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Pakistan (PK)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Peru (PE)

Allowed verification types: NAME, STATUS

Schemes: CCI

Scheme CCI — CCI

• id_scheme: CCI
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	exactly 20 chars
name	text	yes	—

Saudi Arabia (SA)

Status: Coming soon — endpoint not yet active for this country.

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Singapore (SG)

Allowed verification types: NAME, STATUS

Schemes: MBNO

Scheme MBNO — Mobile Number

• id_scheme: MBNO
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	up to 150 chars
name	text	yes	—

South Korea (KR)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Taiwan (TW)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Tanzania (TZ)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Thailand (TH)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: structured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Uganda (UG)

Status: Coming soon — endpoint not yet active for this country.

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

UAE (AE)

Allowed verification types: NAME, STATUS

Schemes: IBAN

Scheme IBAN — IBAN

• id_scheme: IBAN
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	5–34 chars; pattern ^[A-Za-z0-9]{5,34}$
name	text	yes	—

Uruguay (UY)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

United States (US)

Allowed verification types: NAME, STATUS

Schemes: USABA_ACNR

Scheme USABA_ACNR — Account Number and USABA

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	exactly 9 chars; holding entity USABA
account_id	text	yes	up to 34 chars
name	text	yes	—

Vietnam (VN)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

Zambia (ZM)

Allowed verification types: NAME, STATUS

Schemes: BICFI_ACNR

Scheme BICFI_ACNR — Account Number and BICFI

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
bank_id	text	yes	8–11 chars; holding entity BICFI
account_id	text	yes	up to 34 chars
name	text	yes	—

European Payments Council (EPC)

Allowed verification types: NAME

Schemes: IBAN_BICFI

Scheme IBAN_BICFI — IBAN

• id_scheme: IBAN
• name_format: both

Field	Type	Required	Validation
account_id	text	yes	5–34 chars; pattern ^[A-Za-z0-9]{5,34}$
name	text	yes	—

United Kingdom (GB)

Allowed verification types: NAME

Schemes: SCAN, IBAN

Scheme SCAN — Sort Code and Account Number

• id_scheme: SCAN
• name_format: both

Field	Type	Required	Validation
sort_code	sort_code	yes	exactly 6 chars
account_id	text	yes	exactly 8 chars
account_type	radio	yes	one of BUSINESS, PERSONAL
name	text	yes	—
secondary_id	text	no	—

Scheme IBAN — IBAN

• id_scheme: IBAN
• name_format: both

Field	Type	Required	Validation
account_id	text	yes	5–34 chars; pattern ^[A-Za-z0-9]{5,34}$
account_type	radio	yes	one of BUSINESS, PERSONAL
name	text	yes	—

South Africa (ZA)

Allowed verification types: NAME, STATUS, ID

Schemes: ZANCC_ACNR

Scheme ZANCC_ACNR — Account Number and ZANCC

• id_scheme: ACNR
• name_format: unstructured

Field	Type	Required	Validation
account_id	text	yes	up to 34 chars
identity	identity	yes	exactly 12 chars; identity type COID
bank_id	text	yes	exactly 6 chars; holding entity ZANCC
name	text	yes	—

Identity types

Business

• LEI — Legal Entity Identification
• TXID — Tax Identification Number
• SREN — SIREN
• SRET — SIRET
• BOID — Business Other Identification
• BDID — Business Domain Identifier
• DUNS — DUNS Number
• BIC — Business Identification Code
• BANK — Bank Party Identification
• CBID — Central Bank Identification Number
• CHID — Clearing Identification Number
• CINC — Certificate Of Incorporation Number
• COID — Country Identification Code
• CUST — Customer Number
• EMPL — Employer Identification Number
• GS1G — Global Location Number

Personal

• NIDN — National ID
• CCPT — Passport
• DRLC — Driver License
• SOSE — Social Security Number
• TXID — Tax Identification Number
• ARNU — Alien Registration Number
• CUST — Customer Number
• EMPL — Employee Identification Number

Name format

• structured — LastName,FirstName
• unstructured — ,,,Full Name

Bank Verification Config

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/bank-verification/config' \
  -H 'Authorization: Token YOUR_API_KEY'

Success Response

{
    "countries": [
        {
            "code": "GB",
            "name": "United Kingdom",
            "active": true,
            "schemes": [
                {
                    "value": "SCAN",
                    "label": "Sort Code and Account Number",
                    "id_scheme": "SCAN",
                    "name_format": "both",
                    "fields": [
                        {"id": "sort_code", "label": "Sort Code", "type": "sort_code", "required": true},
                        {"id": "account_id", "label": "Account Number", "type": "text", "required": true},
                        {"id": "account_type", "label": "Type of Account", "type": "radio", "required": true,
                         "options": [{"value": "BUSINESS", "label": "Business"}, {"value": "PERSONAL", "label": "Personal"}]},
                        {"id": "name", "label": "Name", "type": "text", "required": true},
                        {"id": "secondary_id", "label": "Secondary Reference", "type": "text", "required": false}
                    ]
                }
            ],
            "types": ["NAME"]
        }
        // ... AR, BR, CA, CN, CO, IN, ID, MX, NP, NG, PK, PE, KR, TW, TH, AE, UY, US, VN, ZA, EPC
    ],
    "identity_types": {
        "business": [{"value": "LEI", "label": "Legal Entity Identification"}],
        "personal": [{"value": "NIDN", "label": "National ID"}]
    },
    "verification_types": [
        {"value": "STATUS", "label": "Account Status", "default": true},
        {"value": "NAME", "label": "Name Verification", "default": false},
        {"value": "ID", "label": "Identity Verification", "default": false}
    ],
    "name_format": {
        "structured": "LastName,FirstName",
        "unstructured": ",,,Full Name"
    }
}

GET https://api.globaldatabase.com/v2/bank-verification/config

Returns the form configuration: supported countries, account schemes, required fields, identity types, and verification types.

Use this endpoint to dynamically build verification forms client-side and to discover which schemes and check types are valid for each country.

Bank Verification History

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/bank-verification/history?page=1&per_page=20' \
  -H 'Authorization: Token YOUR_API_KEY'

Success Response

{
    "data": [
        {
            "id": 142,
            "country": "GB",
            "account_scheme": "SCAN",
            "account_id": "12345678",
            "account_name": "Global Database Management Limited",
            "verification_types": ["NAME"],
            "status": "success",
            "account_status": "ACTIVE",
            "name_check_status": "FULL_MATCH",
            "date_created": "2026-05-05T10:15:30Z",
            "has_kyp_report": true
        }
    ],
    "total_results": 1,
    "total_pages": 1,
    "page": 1
}

GET https://api.globaldatabase.com/v2/bank-verification/history

List previously executed bank verifications for the authenticated user, most recent first.

has_kyp_report tells whether a Know Your Payee report was run on the verification — read it with Get Know Your Payee Report.

Parameters

Parameter	In	Type	Required	Description
page	query	int	false	Page number (default 1)
per_page	query	int	false	Items per page (default 20)

Bank Verification Detail

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/bank-verification/history/142' \
  -H 'Authorization: Token YOUR_API_KEY'

Success Response

{
    "id": "QUFW1061",
    "country": "RO",
    "account_id": "RO00REVO0000000000000000",
    "account_id_scheme": "IBAN",
    "bank_id": "REVOROBBXXX",
    "bank_id_scheme": "BICFI",
    "request_name": "FirstName LastName",
    "response_name": null,
    "request_sent": "2026-05-05T06:16:43.95031Z",
    "request_status": "SUCCESS",
    "request_source": "SINGLE",
    "account_status": "ACTIVE",
    "response_matched": true,
    "response_reason_code": "FULL_MATCH",
    "transaction_notes": []
}

GET https://api.globaldatabase.com/v2/bank-verification/history/{id}

Fetch the full provider response payload for a previously executed verification.

Returns an empty object {} if the original request did not produce a result payload (e.g. error responses).

Parameters

Parameter	In	Type	Required	Description
id	path	int	true	Bank verification history record id

KYP API

Know Your Payee answers one question before a payment leaves: is this account held by the company I think I am paying, and is that company sound?

One call runs three steps:

1. Account — the payee's own bank confirms the account and the name it is held under (a Bank Verification check).
2. Company — the name the bank confirmed is matched to a company in the official register. The name on the invoice is never searched: it is the one a fraudster controls.
3. Verdict — the company's KYB records are read and assessed. The report returns a decision (OK_TO_PAY, REVIEW_BEFORE_PAYING, DO_NOT_PAY), the assessments behind it and every signal that produced them.

Every run is saved on its bank verification with its own report_id. Get Know Your Payee Report returns the latest one; Run from History creates a new one.

Usage. A new run counts as one Bank Verification plus one call for each KYB section included in the report. A run from history does not call the bank again, so it counts only the KYB sections. Reading a saved report is free. KYB sections your subscription does not include are not requested and not charged — they are simply missing from the report. A request that fails (any 4xx or 5xx) is not charged.

Run Know Your Payee

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/know-your-payee' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "query": {
    "types": ["NAME"],
    "country": "GB",
    "account": {
      "id_scheme": "SCAN",
      "id": "04000316052184",
      "name": "global data intelligence",
      "type": "BUSINESS"
    }
  }
}'

Request example (US — state required)

{
  "query": {
    "types": ["NAME"],
    "country": "US",
    "account": {
      "id_scheme": "ACNR",
      "id": "000123456789",
      "name": "Acme Supplies Inc",
      "holding_entity": {"type": "USABA", "value": "021000021"}
    }
  },
  "state": "NY"
}

Success Response

{
    "bank_verification": {
        "id": "IAVI7756",
        "country": "GB",
        "account_id": "04000316052184",
        "account_id_scheme": "SCAN",
        "request_name": "global data intelligence",
        "response_name": "GLOBAL DATA INTELLIGENCE LIMITED",
        "request_status": "SUCCESS",
        "account_status": "ACTIVE",
        "response_matched": true,
        "response_reason_code": "FULL_MATCH"
    },
    "lite": {
        "id": "29707645",
        "name": "GLOBAL DATA INTELLIGENCE LIMITED",
        "registration_number": "09410808",
        "vat_number": "GB260423730",
        "incorporation_date": "2015-01-28",
        "status": "Active",
        "country_code": "GB",
        "source": {
            "category": "Government Registry",
            "comment": "Offical registry data",
            "id": 197,
            "name": "Companies House",
            "url": "https://find-and-update.company-information.service.gov.uk"
        }
    },
    "officers": { /* same shape as Officers KYB */ },
    "shareholders": {
        "access": {
            "reason": "limited",
            "message": "This account is over its usage limit for the Ownership module. Re-run once the limit resets, or upgrade the plan."
        }
    },
    "group_structures_full": [ /* same shape as Group Structures Full KYB */ ],
    "financial": { /* same shape as Financial KYB */ },
    "result": {
        "decision": "REVIEW_BEFORE_PAYING",
        "action": "review",
        "assessments": [
            {
                "key": "payment_link",
                "label": "Payment link",
                "outcome": "good",
                "result": "Full account-name match",
                "detail": "The payee's bank confirmed the name against the account (full match). The bank holds the account under “GLOBAL DATA INTELLIGENCE LIMITED”. Account status returned by the bank: ACTIVE."
            },
            {
                "key": "company_identity",
                "label": "Company identity",
                "outcome": "good",
                "result": "Verified and active",
                "detail": "Matched to registration 09410808 · United Kingdom, at 100% name confidence. Registry status is Active. The account is held in GB, where the company is registered. “GLOBAL DATA INTELLIGENCE LIMITED” matches the name on the account at 100%. VAT GB260423730 on record. Published contact points: https://www.globaldatabase.com/ · linkedin.com/company/global-database."
            },
            {
                "key": "corporate_continuity",
                "label": "Corporate continuity",
                "outcome": "good",
                "result": "Stable — no material changes detected",
                "detail": "2015 incorporation — 11.6 years of registry history. 11 consecutive years of accounts, 2016 to 2026, with no gaps. Long unbroken filing is the cheapest evidence of a real operating company. The 2026 accounts show trading activity: Employee Numbers, Trade Debtors, Turnover. No appointments or resignations in the last 12 months. This covers the board only: the shareholder register carries no acquisition date, so a share transfer in the same period would not show here. 1 board change(s) in the last 5 years. No director appointed in the last six months. 1 active director(s) with plausible dates of birth on record. Parent of 1: GLOBAL DATABASE, SRL. A payee inside a documented corporate group is harder to fabricate than a standalone shell. No group entity is registered in a low-disclosure jurisdiction."
            },
            {
                "key": "financial_resilience",
                "label": "Financial resilience",
                "outcome": "good",
                "result": "No material warning indicators",
                "detail": "11 year(s) of filed accounts available. Latest accounts cover the year to 2026-01-31, inside the 9-month filing window, nothing outstanding. Trading recorded in 11 of 11 filed year(s), most recently 2026. Revenue published in the 2026 accounts: GBP 900,000. Net assets GBP 1,000 in 2026."
            },
            {
                "key": "evidence_coverage",
                "label": "Evidence coverage",
                "outcome": "warn",
                "result": "Incomplete",
                "detail": "This account is over its usage limit for shareholders. Re-run once the limit resets, or upgrade the plan."
            }
        ],
        "coverage": {
            "signals": 24,
            "met": 22,
            "raised": 0,
            "blocked": 0,
            "not_applicable": 2
        }
    },
    "signals": [
        {
            "key": "bank_name_check",
            "name": "Bank name check",
            "topic": "payment_link",
            "outcome": "good",
            "detail": "The payee's bank confirmed the name against the account (full match). The bank holds the account under “GLOBAL DATA INTELLIGENCE LIMITED”.",
            "reason": null
        },
        {
            "key": "registry_match",
            "name": "Matched in the official register",
            "topic": "company_identity",
            "outcome": "good",
            "detail": "Matched to registration 09410808 · United Kingdom, at 100% name confidence.",
            "reason": null
        },
        {
            "key": "filing_history",
            "name": "Filing history",
            "topic": "corporate_continuity",
            "outcome": "good",
            "detail": "11 consecutive years of accounts, 2016 to 2026, with no gaps. Long unbroken filing is the cheapest evidence of a real operating company.",
            "reason": null
        },
        {
            "key": "owner_tenure",
            "name": "Controlling owner tenure",
            "topic": "corporate_continuity",
            "outcome": "none",
            "detail": "Not assessed — shareholders is over its usage limit for this period.",
            "reason": "limited"
        },
        // ... 20 more signals
    ],
    "report_id": 311
}

POST https://api.globaldatabase.com/v2/know-your-payee

Verify the payee's bank account, match it to a registered company and return the report.

Common use cases:

• Check a new supplier's bank details before the first payment
• Re-check a supplier whose bank details changed (invoice redirection fraud)
• Gate payment runs on the decision

Parameters

The body is the Verify Bank Account body — the same query and optional initiator — plus one optional field. The countries, account schemes and required fields are listed in the Country reference.

Parameter	In	Type	Required	Description
query	body	object	true	Verification target, exactly as for Verify Bank Account.
initiator	body	object	false	Party requesting the verification, exactly as for Verify Bank Account.
state	body	string	false	State or province code. Required when the company is registered in US, CA or CN (e.g. NY, ON, BJ).

The country to search is taken, in order, from the bank's answer, then the IBAN prefix, then query.country.

Get Know Your Payee Report

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/know-your-payee/142' \
  -H 'Authorization: Token YOUR_API_KEY'

Success Response

{
    "bank_verification": { "...": "..." },
    "lite": { "...": "..." },
    "result": { "decision": "OK_TO_PAY", "...": "..." },
    "signals": [ "..." ],
    "report_id": 312
}

No report yet

{}

GET https://api.globaldatabase.com/v2/know-your-payee/{id}

Fetch the latest Know Your Payee report saved on a bank verification, exactly as it was when it ran.

Returns an empty object {} when no report was run on the verification yet. Use has_kyp_report in Bank Verification History to know which verifications have one. To check the company again, use Run from History.

Parameters

Parameter	In	Type	Required	Description
id	path	int	true	Bank verification history record id (id in Bank Verification History).

Run from History

Code samples

curl -X POST 'https://api.globaldatabase.com/v2/know-your-payee/142' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'

Success Response

{
    "bank_verification": { "...": "..." },
    "lite": { "...": "..." },
    "result": { "decision": "OK_TO_PAY", "...": "..." },
    "signals": [ "..." ],
    "report_id": 312
}

POST https://api.globaldatabase.com/v2/know-your-payee/{id}

Run the company and verdict steps again on a bank verification you already have. The bank is not asked again.

Use it to:

• retry after a state or location error, without asking the bank again
• refresh the verdict after the company's registry records changed

Only verifications with status success can be used. Every call saves a new report, which is the one Get Know Your Payee Report returns from then on. The response has the same shape as Run Know Your Payee.

Parameters

Parameter	In	Type	Required	Description
id	path	int	true	Bank verification history record id (id in Bank Verification History).
state	body	string	false	State or province code. Required when the company is registered in US, CA or CN.

Logo API

The Logo API returns a company's logo image as raw binary data, looked up by its website domain.

Get Company Logo

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/logo/globaldatabase.com' \
  -H 'Authorization: Token YOUR_API_KEY'

Success Response

HTTP/1.1 200 OK
Content-Type: image/png

Error Response

{
    "detail": "Logo not found"
}

GET https://api.globaldatabase.com/v2/logo/{domain}

Fetch a company's logo image by domain.

The response body is the raw image (image/png) — not JSON. Returns 404 with {"detail": "Logo not found"} when no logo exists for the domain.

Parameters

Parameter	In	Type	Required	Description
domain	path	string	true	Company website domain, e.g. globaldatabase.com

Regis API

AI-powered access to global company and registry intelligence.

Query companies, ownership, directors, financials and corporate structures using natural language or structured requests. The assistant reads your question, decides which GlobalDatabase data tools to call, runs them, and streams the result back — you never pick endpoints or chain calls yourself. One request like "Find VICAT in France and show its financials" triggers the right lookups automatically.

Key facts

• Streaming only. The response is a live Server-Sent Events stream (text/event-stream). Read it incrementally — with an EventSource, or any HTTP client that consumes the body as it arrives (e.g. curl -N). Never wait for the full body.
• Stateless. One question per call — send query each time; nothing is stored.
• Authenticated with your API key, exactly like every other endpoint.

Choosing a mode

The mode parameter decides what you get back:

Mode	Returns	Use when
ai (default)	A written answer (streamed prose) plus the underlying data.	You want a ready-to-show, human-readable response.
data	Only the raw tool results — no prose.	You just need the structured JSON. Faster and cheaper.

AI Query

Code samples

curl -N -X POST 'https://api.globaldatabase.com/v2/ai/query' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: text/event-stream' \
  -d '{
    "query": "Find company VICAT in FR and show its financials",
    "mode": "ai"
}'

Request example — single question

{
  "query": "Find company VICAT in FR",
  "mode": "ai"
}

Request example — data mode (raw tool JSON only)

{
  "query": "Find company VICAT in FR",
  "mode": "data"
}

Success Response — mode: "ai" (SSE stream)

event: status
data: {"type": "status", "message": "Getting ready..."}

event: status
data: {"type": "status", "message": "Looking up company by identifier..."}

event: tool_call
data: {"type": "tool_call", "tool": "get_company_by_identifiers"}

event: tool_result
data: {"type": "tool_result", "tool": "get_company_by_identifiers", "data": {"id": 101992009, "basic": {"name": "VICAT", "vat_number": "FR92057505539"}}, "duration": 0.86, "is_error": false}

event: generating
data: {"type": "generating"}

event: text
data: {"type": "text", "content": "VICAT SA is an active company in France"}

event: text
data: {"type": "text", "content": " (VAT FR92057505539)."}

event: suggested_actions
data: {"type": "suggested_actions", "actions": ["Show financials for VICAT", "Show shareholders of VICAT"]}

event: done
data: {"type": "done", "tools_used": ["get_company_by_identifiers"], "usage": {"prompt_tokens": 25703, "completion_tokens": 180, "total_tokens": 25883}, "message_id": null}

Success Response — mode: "data" (SSE stream)

event: status
data: {"type": "status", "message": "Looking up company by identifier..."}

event: tool_call
data: {"type": "tool_call", "tool": "get_company_by_identifiers"}

event: tool_result
data: {"type": "tool_result", "tool": "get_company_by_identifiers", "data": {"id": 101992009, "basic": {"name": "VICAT"}}, "duration": 0.86, "is_error": false}

event: done
data: {"type": "done", "data": [{"tool": "get_company_by_identifiers", "data": {"id": 101992009, "basic": {"name": "VICAT"}}}], "tools_used": ["get_company_by_identifiers"], "usage": {"prompt_tokens": 25703, "completion_tokens": 12, "total_tokens": 25715}, "message_id": null}

POST https://api.globaldatabase.com/v2/ai/query

Ask a natural-language question and receive the matching company data, streamed as Server-Sent Events.

Common use cases

• A conversational "ask anything" box over GlobalDatabase data inside your product.
• Pulling one data category — profile, financials, ownership, KYB — with a single natural-language request.
• Programmatic extraction without hard-coding which endpoint to call: send mode: "data" and read the JSON from the done event.

Parameters

Both parameters go in the JSON request body.

Parameter	Type	Required	Limits	Description
query	string	yes	≤ 4000 chars	The natural-language question to answer, e.g. "Find company VICAT in FR and show its financials". The assistant reads it, decides which data tools to call, calls them, and streams back the result. Plain language — you don't reference tools or endpoints. The endpoint is stateless: one self-contained question per call (no conversation history).
mode	string	optional	ai (default) or data	Controls what is returned. ai — the assistant streams a written, human-readable conclusion (text events) plus the underlying tool data; best for a ready-to-show answer. data — returns only the raw tool results as JSON in the final done event, with no prose; faster and cheaper when you only need the structured data. Any other value is rejected with a 400.

Field details

• query — A single natural-language question (required). The endpoint is stateless: one question per call.
• mode — What to return:
  • ai (default) — a written conclusion (streamed as text events) plus the underlying data.
  • data — only the raw tool results, delivered in the final done event. No prose.

SSE Events

Each frame is sent as event: followed by data: . The type is repeated inside the JSON, so both EventSource.addEventListener("", …) and the default onmessage handler work. Comment lines starting with : are keepalives — ignore them.

Typical sequence

status → tool_call → tool_result (these repeat while the assistant gathers data) → in ai mode: generating → text … text → suggested_actions → done. In data mode the prose events are skipped: … → tool_result → done (carrying the collected data).

Event	Payload	Description
status	{ type, message }	Human-readable progress step.
tool_call	{ type, tool }	A data tool is about to be called.
tool_result	{ type, tool, data, duration, is_error }	The full tool result (one frame, complete JSON).
generating	{ type }	The written answer has started (mode ai only).
text	{ type, content }	A chunk of the streamed answer — concatenate in order (mode ai only).
suggested_actions	{ type, actions }	Suggested follow-up questions (mode ai only).
done	{ type, tools_used, usage, message_id } — plus data in mode data	Terminal frame. usage reports token counts; in data mode data is the array of { tool, data } results.
error	{ type, detail, code }	An error that occurred after streaming began (see codes below).

Errors

Errors that occur before the stream starts are returned as a normal JSON HTTP error with the appropriate status code:

Status	Body	When
400	{ detail, code }	Invalid input, or no_api_key (no API key is configured on the account).
401	—	Missing or invalid token.
403	{ detail, code }	No AI-query entitlement on the account, or mcp_auth_error.
429	{ detail }	Quota or rate limit reached — see the X-Quota-* headers and Retry-After.
502	{ detail, code }	mcp_connection_error — the data service could not be reached.

Errors that occur after streaming has begun are delivered as an SSE error event ({ type: "error", detail, code }) with one of these codes: rate_limit, llm_unavailable, mcp_connection_error, mcp_auth_error, timeout, internal_error.

Consuming the stream in JavaScript

Because this endpoint is a POST, the browser EventSource API (which is GET-only) cannot be used. Read the stream with fetch and a body reader instead — the same code runs in the browser and in Node 18+.

Browser / Node — read frames as they arrive

const res = await fetch("https://api.globaldatabase.com/v2/ai/query", {
  method: "POST",
  headers: {
    "Authorization": "Token YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "text/event-stream",
  },
  body: JSON.stringify({ query: "Find company VICAT in FR", mode: "ai" }),
});

const reader = res.body.getReader();
const decoder = new TextDecoder();
let buffer = "";
let answer = "";

while (true) {
  const { value, done } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });

  // SSE frames are separated by a blank line.
  let i;
  while ((i = buffer.indexOf("\n\n")) !== -1) {
    const frame = buffer.slice(0, i);
    buffer = buffer.slice(i + 2);
    if (frame.startsWith(":")) continue;                 // keepalive comment

    const line = frame.split("\n").find((l) => l.startsWith("data:"));
    if (!line) continue;
    const event = JSON.parse(line.slice(5).trim());

    switch (event.type) {
      case "status":      console.log("…", event.message); break;
      case "tool_result": console.log("data:", event.tool, event.data); break;
      case "text":        answer += event.content; render(answer); break;  // stream the answer live
      case "suggested_actions": console.log("suggestions:", event.actions); break;
      case "done":        console.log("done", event.usage); break;
      case "error":       console.error("error", event.code, event.detail); break;
    }
  }
}

Good to know

• Always read the stream incrementally (curl -N, the fetch reader above, or a chunked HTTP reader). The endpoint never returns a single JSON body.
• Quota: each successful call consumes one AI-query request; the live counters are returned in the X-Quota-* response headers.
• Data limits still apply: the data the underlying tools fetch is metered by its own product limits, on top of the AI-query request count.

Demo

Try the endpoint interactively — no code. Paste your API key, ask a question, and watch it work: the tools and status stream live on the left, while the returned data renders as the actual dashboard components on the right (company profile, financials, ownership graph, and more). The AI-written answer appears in its own tab.

▶  Open the live demo

Opens the interactive Regis playground. Your API key is stored only in your browser.

MCP Server

The GlobalDatabase MCP Server brings company intelligence directly into the AI tools you already use. Built on the Model Context Protocol (MCP) open standard, it lets AI assistants look up companies, pull financial reports, check official registries, find people and build prospect lists — all through natural language.

MCP Server URL: https://mcp.globaldatabase.com/mcp

Find us in

Install Global Database straight from these directories, or add the server URL yourself — see Setup.

What you can do:

• Look up any company by website, LinkedIn, name, registration number, VAT number, ticker or email
• Get financial reports — turnover, profit, EBITDA, ratios and 100+ indicators
• Explore shareholders, group structures and ultimate owners
• Check official registry records: officers, share register, filed accounts (KYB)
• Find people at a company and their contact details
• Search companies by country, industry, size and revenue
• Chain all of the above in a single conversation — no code required

Prerequisites

Requirement	Details
Global Database account with API access	You sign in with it when you connect. No account yet? Start a free trial during the connection — no separate sign-up.
AI client with remote MCP connectors	Claude, ChatGPT, Mistral Le Chat, Cursor, VS Code (GitHub Copilot), Windsurf, Claude Code, Microsoft Copilot Studio, or any client that supports remote MCP servers with sign-in (OAuth).

You never paste an API key. When you connect, a browser window opens: you sign in with your Global Database account and approve the connection on a screen that names the AI client and the account being connected. The connector then uses that account's API access. The key itself is never shown to the AI client.

Setup

Every client follows the same pattern: add the server URL, then sign in when the browser opens. Each setup takes under 2 minutes.

Quick start

Step 1. Navigate to the Connectors page in your AI client and click Add Connector.

Step 2. Select Custom MCP Connector, enter the server URL https://mcp.globaldatabase.com/mcp and click Connect.

Step 3. A browser window opens — see How sign-in works. Sign in with your Global Database account, then click Allow on the screen that names the AI client and the account being connected. No account yet? Start a free trial on the same screen — you get a 6-digit code by email and stay in the flow.

Step 4. The GlobalDatabase connector appears in your connectors list with a green status.

Step 5. Start a new conversation and ask any question about a company — the AI will use GlobalDatabase tools automatically.

How sign-in works

1. Your AI client opens a Global Database sign-in page in the browser.
2. Sign in with your Global Database account. No account yet? Choose Start a free trial, enter your email and type the 6-digit code we send you — you stay in the same flow.
3. Review the consent screen — it names the AI client asking for access and the account being connected — and click Allow. Deny cancels the connection.
4. The browser hands you back to your AI client and the GlobalDatabase tools become available.

Claude

Works in claude.ai and in the Claude Desktop app.

Fastest: open Global Database in the Claude Connectors Directory, click Connect and sign in. Or add it by hand:

Step 1. Open Settings → Connectors and click Add custom connector.

Step 2. Enter:

Field	Value
Name	GlobalDatabase
Remote MCP server URL	https://mcp.globaldatabase.com/mcp

Step 3. Click Add, then Connect, and sign in.

Step 4. Verify — start a new conversation and ask: "Use GlobalDatabase to look up tesco.com"

ChatGPT

Fastest: open Global Database in the ChatGPT App Directory, install it and sign in.

Or add it by hand — ChatGPT supports remote MCP servers through Connectors in Developer Mode:

Step 1. Go to Settings → Apps & Connectors → Advanced settings and turn on Developer Mode.

Step 2. Go to Settings → Connectors → Create.

Step 3. Fill in the connector details:

Field	Value
Connector name	GlobalDatabase
Description	Company data, financials, ownership, registry (KYB) and people data from GlobalDatabase
Connector URL	https://mcp.globaldatabase.com/mcp
Authentication	OAuth

Step 4. Click Create and sign in. ChatGPT lists the available tools when the connection succeeds.

Step 5. In a new conversation, click + near the message box, then More, and select GlobalDatabase.

Step 6. Verify — ask: "Use GlobalDatabase to look up tesco.com"

Mistral Le Chat

Step 1. Open the side panel and go to Intelligence → Connectors.

Step 2. Click + Add Connector and select the Custom MCP Connector tab.

Step 3. Fill in the connector details:

Field	Value
Connector Name	globaldatabase
Connection Server	https://mcp.globaldatabase.com/mcp
Description	Company data, financials, ownership, registry (KYB) and people data from GlobalDatabase

Step 4. Click Connect and sign in.

Step 5. Verify — ask: "Use GlobalDatabase to look up tesco.com"

Cursor

Fastest: install from Global Database in the Cursor Directory. Or add it by hand:

Step 1. Open Cursor Settings → MCP → Add new MCP server, or edit ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "globaldatabase": {
      "url": "https://mcp.globaldatabase.com/mcp"
    }
  }
}

Step 2. Cursor shows the server as needing sign-in — click Login and sign in.

Step 3. Verify — in Agent mode, ask: "Use GlobalDatabase to look up tesco.com"

VS Code (GitHub Copilot)

Step 1. Create or edit .vscode/mcp.json in your workspace:

{
  "servers": {
    "globaldatabase": {
      "type": "http",
      "url": "https://mcp.globaldatabase.com/mcp"
    }
  }
}

Step 2. Click Start above the server entry. VS Code asks to sign in — allow it and sign in.

Step 3. Open Copilot Chat in Agent mode and ask: "Use GlobalDatabase to look up tesco.com"

Windsurf

Step 1. Open Windsurf Settings → Cascade → MCP Servers → Add Server, or edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "globaldatabase": {
      "serverUrl": "https://mcp.globaldatabase.com/mcp"
    }
  }
}

Step 2. Refresh the server list and sign in when the browser opens.

Step 3. Verify — ask Cascade: "Use GlobalDatabase to look up tesco.com"

Claude Code (CLI)

Step 1. Add the server:

claude mcp add --transport http globaldatabase https://mcp.globaldatabase.com/mcp

Step 2. In Claude Code, run /mcp, select globaldatabase and choose Authenticate, then sign in.

Step 3. Verify — ask: "Use GlobalDatabase to look up tesco.com"

Microsoft Copilot Studio

Copilot Studio's MCP wizard can add the server directly — it supports the sign-in flow the server uses, so no custom connector is needed.

Step 1. In your agent, go to Tools → Add a tool → Model Context Protocol.

Step 2. Enter the server URL https://mcp.globaldatabase.com/mcp and choose OAuth sign-in.

Step 3. Sign in when prompted.

Copilot Studio does not pass the server's built-in instructions to the agent. For the best answers, contact us for the agent instructions to paste into your agent's Instructions box.

Available Tools

You don't call tools yourself — the AI chooses them from your question. This list helps you know what to ask for. Tools spend the same API credits as the matching REST endpoints.

Company Lookup

All four return the same full company profile, including the company id the other tools use.

Tool	What it does
get_company_by_website	Find a company by its website domain or URL (e.g. tesco.com).
get_company_by_linkedin	Find a company by its LinkedIn company URL.
get_company_by_identifiers	Find a company by name (with country), registration number, VAT number, ticker, website, email or LinkedIn.
get_company_details	Get the full profile of a company by its Global Database id.

Company Data

Tool	What it does
get_company_financials	Balance sheet, profit and loss, ratios and year-over-year changes, per year.
get_company_ownership	Shareholders and group structure: parents, subsidiaries, ultimate owners.
get_digital_insights	Web traffic, ranks, traffic sources, technology stack and domain (WHOIS) data.

People

Tool	What it does
search_employees	List the people on file at a company, by name, job title, department or seniority.
get_employee_details	Department, seniority, email, phone and social profiles of one person.
enrich_employee_contacts	Email and phone for one named person — by email, LinkedIn, or name plus company.
find_people_by_domain	People at a company given by its web domain.

Prospecting

Tool	What it does
prospecting	Search and filter companies by country, industry, size, revenue and more. Each call spends credits.
get_nomenclature	Look up filter values — industries, NACE / ISIC / SIC codes, countries, regions.

KYB / Compliance

Official government registry data. They take the same company id as the tools above.

Tool	What it does
kyb_search	Search official registries by company name, registration number or VAT.
kyb_company_details	Official registry profile.
kyb_officers	Officers and directors of a company.
kyb_officers_search	Find the companies a person is an officer of.
kyb_shareholders	Share register of a company.
kyb_shareholders_search	Find the companies a person or company holds shares in.
kyb_group_structure	Corporate family tree (lite or full).
kyb_financial	Officially filed financial statements.

Account and Reference

Tool	What it does
check_api_key	Check the connection and show the connected account.
read_reference	Read the server's reference notes (tool usage, prospecting filters, answer format). Costs no credits.

Prompts

The server also offers ready-made prompts. Clients that support MCP prompts show them in their prompt or slash-command menu.

Prompt	Inputs	What it does
company_research	company name	Full company profile: identity, financials, ownership, digital presence.
due_diligence	company name, country (default GB)	Registry checks: official record, officers, shareholders, group, filed accounts.
lead_generation	industry, country, employee range (default 50–500)	Companies in a target segment and their decision-makers.
competitor_analysis	company name, competitor names	Compare a company with its competitors on financials, size, industry and digital presence.
market_research	industry, country	Top players, size distribution, financial trends and technology adoption in a market.

Example Workflows

Lead Enrichment

"Look up hubspot.com, then get their latest financials and the decision-makers in sales."

The AI finds the company by website, reads its financials, and searches its people by department and seniority.

Due Diligence

"Check Tesco PLC in the UK registry: officers, shareholders and the last filed accounts."

The AI finds the company in the official registry and reads its officers, share register and filed financial statements.

Company Verification

"Is the company with VAT number GB260423730 active, and who are its directors?"

The AI resolves the company by VAT number and checks its registry status and officers.

Prospect Search

"Find software companies in Germany with 50–200 employees and revenue over €10M."

The AI looks up the industry and country codes, then searches companies with those filters.

Competitive Analysis

"Compare the financials of Tesco, Sainsbury's and Asda for the last three years."

The AI looks up each company and puts their financial data side by side.

Best Practices

Write Better Prompts

• Name the company precisely, or give its website — a domain is the most reliable way to find a company.
• Add the country for common names: "Acme Ltd in the UK".
• Say what you need: financials, ownership, officers, contacts — the AI only fetches what you ask for.

Understand Company IDs

Every lookup returns a Global Database company id. The AI reuses it for follow-up questions, so "now show me their shareholders" works without searching again. The same id works for both the company data tools and the KYB registry tools.

Watch Your Usage

Tools spend the API credits of the account you signed in with, like the matching REST endpoints. Prospecting searches spend credits on every call — for a count only, ask for the number of matching companies. Check your balance with the Usage Metrics endpoint or in the platform.

Disconnecting

Remove the connector in your AI client to disconnect it. To connect a different Global Database account, remove the connector and add it again.

Troubleshooting

Connection Issues

Problem	Solution
The sign-in window does not open	Allow pop-ups for your AI client, then click Connect again.
The consent screen says the account has no API access	Your Global Database plan does not include API access. Book a demo to add it, or start a free trial with another email.
The connection was lost after it worked	Reconnect the connector in your AI client and sign in again.
Tools don't appear	Make sure the connector is enabled for the conversation (ChatGPT: + → More; Cursor and VS Code: Agent mode).
Server URL rejected	Use exactly https://mcp.globaldatabase.com/mcp, including /mcp.

Error Responses

Message	Meaning
Usage limit reached	Your account used its credits or daily limit for that data. The message links to upgrade options or support.
Too many requests (429)	More than 120 requests per minute. Wait a moment and ask again.
Company not found	No match for that identifier. Try the website, add the country, or check the registration number.

Nomenclatures API

Everything about nomenclatures

Seniority

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/seniority' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 1377,
        "name": "CXO",
        "has_children": false,
        "active": true
    },
    {
        "id": 1379,
        "name": "Director",
        "has_children": false,
        "active": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/seniority

Get GlobalDatabase Seniority

Department

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/department' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 1385,
        "parents": "1385",
        "name": "Arts and Design",
        "has_children": false,
        "active": true
    },
    {
        "id": 1386,
        "parents": "1386",
        "name": "Construction and Real Estate",
        "has_children": false,
        "active": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/department

Get GlobalDatabase Department

Activity Type

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/activity-type' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 4591902,
        "parents": "4591902",
        "name": "Distributor",
        "has_children": false,
        "active": true
    },
    {
        "id": 4591903,
        "parents": "4591903",
        "name": "Producer",
        "has_children": false,
        "active": true
    },
    {
        "id": 4591904,
        "parents": "4591904",
        "name": "Service Provider",
        "has_children": false,
        "active": true
    }
]

GET https://api.globaldatabase.com/v2/nomenclatures/activity-type

Get GlobalDatabase Activity Type

Company Type

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/company-type' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 1501926,
        "parents": "1501926",
        "name": "Branch",
        "has_children": false,
        "active": true
    },
    {
        "id": 1501925,
        "parents": "1501925",
        "name": "Head Office",
        "has_children": false,
        "active": true
    }
]

GET https://api.globaldatabase.com/v2/nomenclatures/company-type

Get GlobalDatabase Company Type

Company Status

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/company-status' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 106,
        "parents": "106",
        "name": "Active",
        "has_children": false,
        "active": true
    },
    {
        "id": 108,
        "parents": "108",
        "name": "Inactive",
        "has_children": false,
        "active": true
    },
    {
        "id": 1615,
        "parents": "1615",
        "name": "Intermediate",
        "has_children": false,
        "active": true
    }
]

GET https://api.globaldatabase.com/v2/nomenclatures/company-status

Get GlobalDatabase Company Status

Legal Form

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/legal-form' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 4024357,
        "parents": "4024357",
        "name": "Charitable Incorporated Organisation",
        "has_children": false,
        "active": true
    },
    {
        "id": 4024362,
        "parents": "4024362",
        "name": "Co-operative Society",
        "has_children": false,
        "active": true
    },
    {
        "id": 4024359,
        "parents": "4024359",
        "name": "Community Benefit Society",
        "has_children": false,
        "active": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/legal-form

Get GlobalDatabase Legal Form

Industry Focus

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/industry-focus' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 4564019,
        "parents": "4564019",
        "name": "Agriculture",
        "has_children": true,
        "active": true
    },
    {
        "id": 4564002,
        "parents": "4564002",
        "name": "Automotive",
        "has_children": true,
        "active": true
    },
    {
        "id": 4563183,
        "parents": "4563183",
        "name": "Beverages",
        "has_children": true,
        "active": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/industry-focus

Get GlobalDatabase Industry Focus

Parameters

Parameter	In	Type	Required	Description
parent	params	int	false	Parent Id

International SIC Code

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/isic' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 4591135,
        "parents": "4591135",
        "name": "A - Agriculture",
        "has_children": true,
        "active": true
    },
    {
        "id": 4591190,
        "parents": "4591190",
        "name": "B - Mining and quarrying",
        "has_children": true,
        "active": true
    },
    {
        "id": 4591220,
        "parents": "4591220",
        "name": "C - Manufacturing",
        "has_children": true,
        "active": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/isic

Get GlobalDatabase International SIC Code

Parameters

Parameter	In	Type	Required	Description
parent	params	int	false	Parent Id

NACE Rev. 2

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/nace' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 4583537,
        "parents": "4583537",
        "name": "A - AGRICULTURE, FORESTRY AND FISHING",
        "has_children": true,
        "active": true
    },
    {
        "id": 4583593,
        "parents": "4583593",
        "name": "B - MINING AND QUARRYING",
        "has_children": true,
        "active": true
    },
    {
        "id": 4583624,
        "parents": "4583624",
        "name": "C - MANUFACTURING",
        "has_children": true,
        "active": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/nace

Get GlobalDatabase NACE Rev. 2

Parameters

Parameter	In	Type	Required	Description
parent	params	int	false	Parent Id

Country SIC Codes

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/sic/gb' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 3968625,
        "parents": "3968625",
        "name": "A - Agriculture, forestry and fishing",
        "has_children": true,
        "active": true
    },
    {
        "id": 3968690,
        "parents": "3968690",
        "name": "B - Mining and quarrying",
        "has_children": true,
        "active": true
    },
    {
        "id": 3968721,
        "parents": "3968721",
        "name": "C - Manufacturing",
        "has_children": true,
        "active": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/sic/{country_code}

Get GlobalDatabase Country SIC Codes

Parameters

Parameter	In	Type	Required	Description
country_code	url	string	true	Country Code
parent	params	int	false	Parent Id

Countries SIC Codes

Country Code	Name
no	Norway SIC Code
de	Germany SIC Code
fr	France SIC Code
se	Sweden SIC Code
lu	Luxembourg SIC Code
it	Italy SIC Code
dk	Denmark SIC Code
gb	United Kingdom SIC Code
be	Belgium SIC Code
ie	Ireland SIC Code
nl	Netherlands SIC Code
sg	Singapore SIC Code
us	United States of America SIC Code
ca	Canada SIC Code
mx	Mexico SIC Code
anz	ANZ SIC Code

Countries

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/country' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 4004115,
        "parents": "1463712_4004115",
        "name": "Afghanistan",
        "has_children": true,
        "active": true
    },
    {
        "id": 1547645,
        "parents": "1219916_1547645",
        "name": "Albania",
        "has_children": true,
        "active": true
    },
    {
        "id": 4367081,
        "parents": "4292987_4367081",
        "name": "Algeria",
        "has_children": true,
        "active": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/country

Get GlobalDatabase Countries

Parameters

Parameter	In	Type	Required	Description
parent	params	int	false	Parent Id

Regions

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/region' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": 4292987,
        "parents": "4292987",
        "name": "Africa",
        "has_children": true,
        "active": true
    },
    {
        "id": 1463712,
        "parents": "1463712",
        "name": "Asia",
        "has_children": true,
        "active": true
    },
    {
        "id": 4249245,
        "parents": "4249245",
        "name": "Central America",
        "has_children": true,
        "active": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/region

Get GlobalDatabase Regions

Parameters

Parameter	In	Type	Required	Description
parent	params	int	false	Parent Id

States US & CA

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/states?country=US' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

{
    "AL": "Alabama",
    "AK": "Alaska",
    "AS": "American Samoa",
    "AZ": "Arizona",
    "AR": "Arkansas",
    "CA": "California",
    "CO": "Colorado",
    "CT": "Connecticut",
    "DE": "Delaware",
    "DC": "District Of Columbia",
    "FL": "Florida",
    "GA": "Georgia",
    "GU": "Guam",
    "HI": "Hawaii",
    "ID": "Idaho",
    "IL": "Illinois",
    "IN": "Indiana",
    "IA": "Iowa",
    "KS": "Kansas",
    "KY": "Kentucky",
    "LA": "Louisiana",
    "ME": "Maine",
    "MD": "Maryland",
    //...
}

GET https://api.globaldatabase.com/v2/nomenclatures/states

Get GlobalDatabase States

Parameters

Parameter	In	Type	Required	Description
country	params	string	True	Country Code US or CA

Technologies

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/technology' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": "c-36",
        "name": "Advertisement",
        "has_children": false
    },
    {
        "id": "c-134",
        "name": "Advertising",
        "has_children": true
    },
    {
        "id": "c-94",
        "name": "Advertising Solutions",
        "has_children": true
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/technology

Get GlobalDatabase Technologies

Parameters

Parameter	In	Type	Required	Description
parent	params	int	false	Parent Id

Currency

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/currency' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": "GBP",
        "name": "GBP"
    },
    {
        "id": "EUR",
        "name": "EUR"
    },
    {
        "id": "USD",
        "name": "USD"
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/currency

Get GlobalDatabase Currency

KYB Countries

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/kyb/countries' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": "1463712_4004115",
        "name": "Afghanistan"
    },
    {
        "id": "1219916_1547645",
        "name": "Albania"
    },
    {
        "id": "4292987_4367081",
        "name": "Algeria"
    },
    {
        "id": "1219916_1365832",
        "name": "Andorra"
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/kyb/countries

Get GlobalDatabase KYB Countries

KYB Regions

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/kyb/country/us/regions' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "id": "1869197_1869198_3196394",
        "name": "Alabama"
    },
    {
        "id": "1869197_1869198_3202547",
        "name": "Alaska"
    },
    {
        "id": "1869197_1869198_3204387",
        "name": "Arizona"
    },
    {
        "id": "1869197_1869198_3206209",
        "name": "Arkansas"
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/kyb/country/{country_code_iso2}/regions

Get GlobalDatabase KYB Regions

Parameters

Parameter	In	Type	Required	Description
country_code_iso2	url	string	true	Country ISO2 for United States, Canada and China [US, CA, CN]

KYB Jurisdictions

Code samples

curl -X GET 'https://api.globaldatabase.com/v2/nomenclatures/kyb/country/ca/jurisdictions' \
  -H 'Authorization: Token YOUR_API_KEY' \
  -H 'Content-Type: application/json'

Success Response

[
    {
        "code": "AB",
        "name": "Alberta"
    },
    {
        "code": "BC",
        "name": "British Columbia"
    },
    {
        "code": "MB",
        "name": "Manitoba"
    },
    {
        "code": "NB",
        "name": "New Brunswick"
    },
    //...
]

GET https://api.globaldatabase.com/v2/nomenclatures/kyb/country/{country_code_iso2}/jurisdictions

Get GlobalDatabase KYB Jurisdictions — the values accepted by the jurisdiction filter of Search KYB.

Parameters

Parameter	In	Type	Required	Description
country_code_iso2	url	string	true	Country ISO2 for United States, Canada and China [US, CA, CN]

- Advance contacts

Name
"have_email_address"
"have_telephone"

- Trading Activity

Name
"import"
"export"

- Ownership Parents

Name
"has_parents"
"has_no_parents"

- Website monthly visits

Name
"0-10000"
"1000-100000"
"100000-500000"
"500000-1000000"
"5000000"
"1000000-5000000"

- Alexa ranking

Name
"0-10000"
"1000-100000"
"100000-500000"
"500000-1000000"
"5000000"
"1000000-5000000"

- Only Select Companies That

Name
"have_email_address"
"have_telephone"
"have_fax"
"have_website"
"have_vat_number"
"have_registration_number"
"have_business_address"
"have_lat_and_long"

- Foreign Parent

Name
"has_a_foreign_parent"
"has_no_foreign_parent"

- Consolidated Accounts

Name
"consolidated"
"not_consolidated"