NAV Navigation
Python Example PHP Example
Request an API key

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

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

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

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.get("https://api.globaldatabase.com/v2/metrics", headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/metrics');
curl_setopt($curl, CURLOPT_GET, true);

curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.get("https://api.globaldatabase.com/v2/metrics/contacts", params={
                "date_from": "2025-03-27 05:30:00",
                "date_to": "2025-04-27 05:30:00",
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/metrics/contacts');
curl_setopt($curl, CURLOPT_GET, true);

curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'date_from' => '2025-03-27 05:30:00',
    'date_to' => '2025-04-27 05:30:00'
]));
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.post("https://api.globaldatabase.com/v2/prospecting", json={
    "page": 1,
    "per_page": 50,
    "filters": {
        "company_status": [
            106
        ],
        "number_of_employees": {
            "gte": 1,
            "lte": 30000
        },
        "legal_form": [
            4024353
        ],
        "location_countries": [
            "1219916_1800795_1814321"
        ]
    }
}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/prospecting');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'page' => 1,
    'per_page' => 50,
    'filters' => [
        'company_status' => [106],
        'number_of_employees' => [
            'gte' => 10000,
            'lte' => 30000
        ],
        'trading_activity' => [import],
        'legal_form' => [4185023]
    ]
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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 string 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

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.post("https://api.globaldatabase.com/v2/overview", json={
    "name": "Global Database",
    "country_code": "UK",
    "page": 1
}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/overview');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'name' => 'Global Database',
    'country_code' => 'GB',
    'page' => 1
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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)
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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/companies/20581257',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/20581257');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.post('https://api.globaldatabase.com/v2/employees', json={
                "page": 1,
                "per_page": 5,
                "filters": {
                    "company_id": 20581257
                }
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/employees');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'page' => 1,
    'per_page' => 50,
    'filters' => [
        'company_id' => 20581257
    ]
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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 string 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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/employees/199328763',
    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/employees/199328763');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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 Company 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.

Start Watch Company

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.post('https://api.globaldatabase.com/v2/companies/20581257/watch/start', json={
                "fields": [
                    "company_fax",
                    "shareholder_name"
                ]}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/20581257/watch/start');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'fields' => array("company_fax", "shareholder_name")
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Request example

{
    "fields": [
        "company_fax",
        "shareholder_name"
    ]
}

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 Watch [company_fax, name, vat_number, company_address_street, company_website, company_phone, company_email]

Stop Watch Company

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.delete('https://api.globaldatabase.com/v2/companies/20581257/watch/stop',
                    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/20581257/watch/stop');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/companies/watch', params={
                "fields": ["company_fax"],
                "date": "2021-08-10",
                "page": 1,
                "per_page": 10
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/watch');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'fields' => array("company_fax"),
    'date' => '2021-08-10',
    'page' => 1,
    'per_page' => 10
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/companies/61862770/watch/events', params={
                "fields": ["company_name"],
                "from_date": "2020-08-10",
                "to_date": "2021-08-10",
                "page": 1,
                "per_page": 10
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/61862770/watch/events');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'fields' => array("company_name"),
    'from_date' => '2020-08-10',
    'to_date' => '2021-08-10',
    'page' => 1,
    'per_page' => 10
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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/61862770/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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/companies/20581257/watch/fields',
                    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/20581257/watch/fields');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.put('https://api.globaldatabase.com/v2/companies/20581257/watch/fields/add', json={
                "fields": [
                    "vat_number"
                ]}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/20581257/watch/fields/add');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'fields' => array("company_vat"")
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.put('https://api.globaldatabase.com/v2/companies/20581257/watch/fields/remove', json={
                "fields": [
                    "vat_number"
                ]}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/20581257/watch/fields/remove');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'fields' => array("vat_number"")
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.put('https://api.globaldatabase.com/v2/companies/watch/callback', json={
                "callback": "https://globaldatabase.com"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/watch/callback');
curl_setopt($curl, CURLOPT_PUT, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'callback' => 'https://globaldatabase.com'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Request example

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

Success Response

200

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

Get Callback URL

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/companies/watch/callback',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/companies/watch/callback');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Success Response

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

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"
}

POST https://your_callback_url

Webhook companies notifications

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

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.post("https://api.globaldatabase.com/v2/enrichment/url", json={
    "url": "http://www.tesco.com"
}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/enrichment/url');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'url' => 'http://www.tesco.com'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

Enrichment Company By Linkedin URL

Code samples

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.post("https://api.globaldatabase.com/v2/enrichment/company/linkedin", json={
    "linkedin": "https://www.linkedin.com/company/global-database/"
}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/enrichment/company/linkedin');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'linkedin' => 'https://www.linkedin.com/company/global-database/'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

Enrichment Company

Code samples

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.post("https://api.globaldatabase.com/v2/enrichment/company", json={
    "registration_number": "09410808",
    "country_code": "UK"
}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/enrichment/company');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'registration_number' => '09410808'
    'country_code' => 'UK'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.post("https://api.globaldatabase.com/v2/enrichment/email", json={
    "email": "thomas.vanmourik@culinalogistics.co.uk"
}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/enrichment/email');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'email' => 'thomas.vanmourik@culinalogistics.co.uk'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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)

Enrichment Contact By Linkedin URL

Code samples

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.post("https://api.globaldatabase.com/v2/enrichment/employee/linkedin", json={
    "linkedin": "https://www.linkedin.com/in/alex-price-991845116/"
}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/enrichment/employee/linkedin');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'linkedin' => 'https://www.linkedin.com/in/alex-price-991845116/'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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)

Enrichment Contact

Code samples

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.post("https://api.globaldatabase.com/v2/enrichment/employee/contacts", json={
    "first_name": "Alex",
    "last_name": "Price",
    "company_name": "BRITISH AIRWAYS PLC",
    "email": "alex.price@ba.com"
}, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/enrichment/employee/contacts');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'first_name' => 'Alex'
    'last_name' => 'Price'
    'company_name' => 'BRITISH AIRWAYS PLC'
    'email' => 'alex.price@ba.com'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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)

Search employees

Code samples

import requests

headers = {
  "Authorization": "Token 00000000-0000-0000-0000-000000000000"
}

r = requests.post("https://api.globaldatabase.com/v2/enrichment/employee/search", json={
    "domain_list": [
        "amazon.com"
    ],
    "company_locations": [
        "United States"
    ],
    "employee_locations": [
        "India"
    ],
    "employee_seniorities": [
        "director"
    ],
    "page": 1,
    "per_page": 100
}, headers = headers)

print(r.json())
$ch = curl_init('https://api.globaldatabase.com/v2/enrichment/employee/search');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Token 00000000-0000-0000-0000-000000000000',
        'Content-Type: application/json'
    ],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode([
        "domain_list" => ["amazon.com"],
        "company_locations" => ["United States"],
        "employee_locations" => ["India"],
        "employee_seniorities" => ["director"],
        "page" => 1,
        "per_page" => 100
    ])
]);

$response = curl_exec($ch);
curl_close($ch);
print_r(json_decode($response, true));

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:

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.post('https://api.globaldatabase.com/v2/autocomplete', json={
        "website": "http://www.tesco.com"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/autocomplete');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'website' => 'http://www.tesco.com'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/financial/20581257', params={
        "year": 2020
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/financial/20581257');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'year' => 2020
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.post('https://api.globaldatabase.com/v2/digital-insights', json={
            "name": "NOVATECH LIMITED"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/digital-insights');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'name' => 'NOVATECH LIMITED'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/digital-insights/20581257',
    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/digital-insights/20581257');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.post('https://api.globaldatabase.com/v2/ownership', json={
            "name": "BANDENIA GATEWAY LTD"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/ownership');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'name' => 'BANDENIA GATEWAY LTD'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/ownership/28672740',
    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/ownership/28672740');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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, 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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.post('https://api.globaldatabase.com/v2/kyb/search', json={
            "name": "Global Data",
            "location": "1219916_1800795"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/kyb/search');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'name' => 'Global Data'
    'location' => '1219916_1800795'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Request example

{
    "name": "Global Data",
    "location": "1219916_1800795"
}

Success Response

[
    {
        "id": "27540915",
        "name": "GLOBAL DATA PARTNERS LIMITED",
        "registration_number": "07698579",
        "vat_number": null,
        "country_code": "GB",
        "state": "Hertfordshire"
    },
    {
        "id": "29707645",
        "name": "GLOBAL DATA INTELLIGENCE LIMITED",
        "registration_number": "09410808",
        "vat_number": null,
        "country_code": "GB",
        "state": "Northamptonshire"
    },
    //...
]

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:

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, available in KYB Countries or KYB Regions

Validation Rules

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.

Lite KYB

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/kyb/29707645/lite',
    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/kyb/29707645/lite');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Request example

{
  "id": 29707645
}

Success Response

{
    "id": "29707645",
    "name": "GLOBAL DATA INTELLIGENCE LIMITED",
    "registration_number": "09410808",
    "vat_number": null,
    "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": "http://globaldatabase.com/",
    "linkedin": "linkedin.com/company/global-database"
}

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:

Parameters

Parameter In Type Required Description
id url int true Company ID

Officers KYB

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/kyb/29707645/officers', params={
            "page": 1,
            "per_page": 25
    },
    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/kyb/29707645/officers');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'page' => '1'
    'per_page' => '25'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Request example

{
  "id": 29707645
}

Success Response

{
    "data": [
        {
            "id": "48075764",
            "first_name": "Nicolae",
            "last_name": "Buldumac",
            "appointed_at": "2015-01-28",
            "date_of_birth_year": 1985,
            "date_of_birth_month": 12,
            "job_title": "Director",
            "address_country": "GB",
            "address_line_1": "24 Bertal Road",
            "address_locality": "London",
            "address_region": null,
            "address_postal_code": "SW17 0BX"
        },
        ...
    ],
    "total_results": 3,
    "total_pages": 1
}

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:

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

Shareholders KYB

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/kyb/29707645/shareholders', params={
            "page": 1,
            "per_page": 25
    },
    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/kyb/29707645/shareholders');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'page' => '1'
    'per_page' => '25'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Request example

{
  "id": 29707645
}

Success Response

{
    "data": [
        {
            "id": 684155200,
            "name": "NICOLAE BULDUMAC",
            "quantity": 5000,
            "currency": "GBP",
            "company_id": 29707645,
            "share_value": "5,000 ORDINARY GBP 0.01",
            "share_type": "ORDINARY",
            "share_price": 0.01,
            "total_value": 50.0
        },
        ...
    ],
    "total_results": 2,
    "total_pages": 1
}

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:

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

Group Structures Lite KYB

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/kyb/29707645/group-structures/lite',
    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/kyb/29707645/group-structures/lite');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Request example

{
  "id": 29707645
}

Success Response

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

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:

Parameters

Parameter In Type Required Description
id url int true Company ID

Group Structures Full KYB

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/kyb/29707645/group-structures/full',
    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/kyb/29707645/group-structures/full');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Request example

{
  "id": 29707645
}

Success Response

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

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:

Parameters

Parameter In Type Required Description
id url int true Company ID

Financial KYB

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/kyb/29707645/financial',
    headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/kyb/29707645/financial');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

Request example

{
  "id": 29707645
}

Success Response

{
    "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,
                        ...
                    ]
                },
                ...
            ]
        }
    ]
}

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:

Perfect for:

Parameters

Parameter In Type Required Description
id url int true Company ID

Credit Report API

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

Search Credit Report

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/credit-report', params={
        "company": "00445790",
        "country": "GB"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/credit-report');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'company' => '00445790'
    'country' => 'GB'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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 body string false Company Name
registration_number body string false Registration Number
vat_number body string false VAT Number
country body string true Country Code ISO
province body string false Province, available in nomenclatures
registered_city body string false City
post_code body string false Post Code

Generate Credit Report

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.post('https://api.globaldatabase.com/v2/credit-report/report/json', json={
        "source_id": "GB-0-00445790",
        "country": "GB"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/credit-report/report/json');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'source_id' => 'GB-0-00445790'
    'country' => 'GB'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/credit-report/568/check', headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/credit-report/568/check');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/credit-report/report/json/52/file',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/credit-report/report/json/52/file');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.post('https://platform.globaldatabase.com/v2/credit-report/report/json/file',  json={
        "source_id": "GB-0-00445790",
        "country": "GB"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/credit-report/report/json/file');
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'source_id' => 'GB-0-00445790'
    'country' => 'GB'
]));
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/credit-report/report/json/52',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/credit-report/report/json/52');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/credit-report/purchased', params={
        "page": 1,
        "per_page": 10,
        "search": "tesco"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/credit-report/purchased');
curl_setopt($curl, CURLOPT_GET, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'page' => 1
    'per_page' => 10
    'search' => 'tesco'
]));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

Nomenclatures API

Everything about nomenclatures

Seniority

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/seniority',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/seniority');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/department',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/department');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/activity-type',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/activity-type');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/company-type',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/company-type');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/company-status',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/company-status');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

Code samples

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/legal-form',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/legal-form');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/industry-focus',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/industry-focus');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/isic',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/isic');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/nace',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/nace');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/sic/gb',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/sic/gb');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/country',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/country');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/region',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/region');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/states', params={
        "country": "US"
    }, headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/states');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode([
    'country' => 'US'
]));
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/technology',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/technology');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/currency',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/currency');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/kyb/countries',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/kyb/countries');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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

import requests

headers = {
  'Authorization': 'Token 00000000-0000-0000-0000-000000000000'
}

r = requests.get('https://api.globaldatabase.com/v2/nomenclatures/kyb/country/us/regions',
                 headers = headers)

print(r.json())
$curl = curl_init('https://api.globaldatabase.com/v2/nomenclatures/kyb/country/us/regions');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Token 00000000-0000-0000-0000-000000000000'
]);
$response = curl_exec($curl);
curl_close($curl);

var_dump(json_decode($response));

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]

- 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"