Guide

Welcome to the DataGardener API. Our API provides instant access to UK company intelligence including company profiles, directors, shareholders, financials, group structures, and more.

Steps to get started:

1. Obtain Your API Key

Contact sales

Reach out to our sales team by booking a demo to access DataGardener's API.

Request API access for your environment (sandbox or production).

Receive your key

You’ll be issued a secure API key (e.g., dg_test_xxxxxx).

Keep this key safe — treat it like a password.

2. Configure Your API Key

There are multiple ways to set your key depending on your environment:

Option A: Environment Variable (Recommended)

# Linux / macOS
export x-api-key = "your_api_key_here"

# Windows (PowerShell)
setx x-api-key "your_api_key_here"

Option B: Store in a Configuration File
Example .env file:

x-api-key = your_api_key_here

3. Set the Authorisation Token

Every request must include the Authorisation header:

x-api-key :  YOUR_API_KEY

Example (cURL)

bash

You can put other components inside Accordions.

Example (JavaScript / Node.js)

javascript

You can put other components inside Accordions.

  const axios = require("axios");

const x-api-key = process.env.DG_API_KEY;

axios.get("https://api.datagardener.com/companies/01234567", {
headers: { x-api-key: `${API_KEY}` }
})
.then(res => console.log(res.data))
.catch(err => console.error(err));

Example (Python)

python

You can put other components inside Accordions.

  import requests
import os

API_KEY = os.getenv("DG_API_KEY")

url = "https://api.datagardener.com/companies/01234567"
headers = {"x-api-key": f"{API_KEY}"}

response = requests.get(url, headers=headers)
print(response.json())

4. Verify Your Setup

A successful call returns a 200 OK response with company data:

Example Response

{
   "companyRegistrationNumber": "string",
   "businessName": "string",
   "companyRegistrationDate": "string",
   "businessAlphaName": "string",
   "companyStatus": "string",
   "companyLiquidationStatus": "string",
   "administrationOrderFlag": "string",
   "voluntaryAgreementFlag": "string",
   "inAdministrationFlag": "string",
   "receiveManagerFlag": "string",
   "latestAnnualReturnDate": "string",
   "nextAnnualReturnDate": "string",
   "accountsFilingDate": "string",
   "latestDateOfAccounts": "string",
    "bankDetails": [
        {}
          ],
    "charityNumber": "string",
    
     "sicCode2": {
     "sicNumber1": "string",
     "sicText1": "string"
         },
  "regAddress": {
  "addressLine1": "string",
  "addressLine2": "string",
  "addressLine3": "string",
  "addressLine4": "string",
  "postalCode": "string",
  "telephone": "string",
  "ctps": "string",
  "website": "string",
  "regPOBox": "string",
  "county": "string",
  "regCareOfAddress": "string",
  "regOfficeAreaCode": "string",
  "country": "string",
  "ward": "string",
  "constituency": "string",
  "region": "string",
  "postcode_area": "string",
  "postcode_district": "string",
  "district": "string",
  "police_force": "string",
  "linkedin_url": "string",
  "facebook_url": "string"
},
       
   .
   .
   . and more 
               }

5. Next Steps

Try other endpoints like Financials or Directors to enrich your workflows.

Integrate the API into your CRM, loan decision engine, or procurement system.

Steps to get started:#

1. Obtain Your API Key#

2. Configure Your API Key#

3. Set the Authorisation Token#

4. Verify Your Setup#

5. Next Steps#

Steps to get started:

1. Obtain Your API Key

2. Configure Your API Key

3. Set the Authorisation Token

4. Verify Your Setup

5. Next Steps