DataGardener API Docs
  1. Companies
DataGardener API Docs
  • Getting Started
    • Introduction
    • Guide
  • DataGardener API
    • Companies
      • Get company details.
        GET
      • Get company trading address.
        GET
      • Get company summary.
        GET
      • Get company previous name.
        GET
      • Get company industries.
        GET
      • Get company info by IS-8 industries
        GET
    • Financials
      • Get company statutory accounts.
      • Get company simplified accounts .
      • Get financial ratios details for a company.
    • Share Details
      • Get share details for a company.
    • Officers
      • Get officers details for a company.
    • Group Structures
      • Get group structure for a company.
    • Documents
      • Get document list for a company.
    • Directors
      • Get directors data for a company.
      • Get active directors data for a company.
    • Commentaries
      • Get Company Commentary .
    • Acquisition Merger
      • Get acquisition merger information for a company.
    • Lending
      • Get Charges Details
      • Get Outstanding Charges
      • Get Unsecured Charges
      • Get Secured Charges
      • Get Registered Charges Details
    • Persons with Significant Control(PSC)
      • Get psc details
    • County Court Judgment (CCJ)
      • Get ccj details by company number and status
    • WriteOff
      • Get WriteOff details
    • Property Register
      • Get property register details by title number
      • Get property register details
    • Government Procurement
      • Get government procurement details
    • International Trade
      • Get international trade details
    • Responsible Procurement
      • Get responsible procurement ownership details
      • Get responsible procurement mission spectrum details
    • Accounts and Bank Details
      • Get accounts and bank details
  1. Companies

Get company details.

GET
/companies/{company-registration-number}
Companies
Retrieve a comprehensive company profile by registration number. This endpoint returns detailed information covering legal data, financials, addresses, directors, ownership structure, industry classifications, and more.

Request

Path Params

Header Params

Responses

🟢200OK
application/json
Success|OK
Body

🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.datagardener.com/companies/12559329' \
--header 'x-api-key;'
Response Response Example
200 - Success
{
  "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",
  "accountsDueDate": "string",
  "accountsMadeUpDate": "string",
  "accountsReferenceDate": "string",
  "documents": {
    "startIndex": "string",
    "itemsPerPage": "string",
    "totalCount": 0,
    "filingHistoryStatus": "string",
    "items": [
      {
        "category": "string",
        "date": "string",
        "description": "string",
        "description_values": {
          "description": "string",
          "appointment_date": "string",
          "officer_name": "string",
          "termination_date": "string"
        },
        "paper_filed": "string",
        "resolutions": [
          {
            "category": "string",
            "description": "string",
            "subCategory": "string",
            "type": "string",
            "barCode": "string",
            "transactionId": "string",
            "description_values": {
              "description": "string",
              "appointment_date": "string",
              "officer_name": "string",
              "termination_date": "string"
            }
          }
        ],
        "links": {
          "self": "string",
          "document_metadata": "string"
        }
      }
    ]
  },
  "bankDetails": [
    {}
  ],
  "charityNumber": "string",
  "ftsea": "string",
  "ftset": "string",
  "sicCode2": {
    "sicNumber1": "string",
    "sicText1": "string"
  },
  "sicCode3": {
    "sicNumber1": 0,
    "sicText1": "string"
  },
  "sicCode4": {
    "sicNumber1": 0,
    "sicText1": "string"
  },
  "sicCode07": {
    "SicNumber_1": "string",
    "SicText_1": "string",
    "SicNumber_2": [
      {}
    ],
    "SicText_2": [
      {}
    ],
    "SicNumber_3": [
      {}
    ],
    "SicText_3": [
      {}
    ],
    "sicNumber_1": "string",
    "sicText_1": "string",
    "sicNumber_2": [
      {}
    ],
    "sicText_2": [
      {}
    ],
    "sicNumber_3": [
      {}
    ],
    "sicText_3": [
      {}
    ]
  },
  "companyDescription": {
    "aboutUs": "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"
  },
  "previousNames": [
    {
      "alphaName": "string",
      "previousName": "string",
      "registrationNumber": "string",
      "changedDate": "string"
    }
  ],
  "principalActivityDetails": [
    {
      "description": "string"
    }
  ],
  "mortgages": [
    {
      "regDate": "string",
      "createdDate": "string",
      "satisfiedDate": "string",
      "lastChangeDate": "string",
      "memorandumNature": "string",
      "chargeCode": "string",
      "createdMonth": "string",
      "regMonth": "string",
      "mortgageDetails": [
        {
          "recordType": "string",
          "description": "string",
          "chargeCode": "string",
          "groupName": "string",
          "sector": "string"
        }
      ]
    }
  ],
  "statutoryAccounts": [
    {
      "companyRegistrationNumber": "string",
      "businessName": "string",
      "yearStartDate": "string",
      "yearEndDate": "string",
      "numberOfWeeks": "string",
      "numberOfMonths": "string",
      "currency": "string",
      "consolidatedAccount": "string",
      "turnover": 0,
      "export": 0,
      "costOfSales": 0,
      "grossProfit": 0,
      "wagesAndSalaries": 0,
      "directorsRemuneration": 0,
      "operatingProfit": 0,
      "depreciation": 0,
      "auditFees": 0,
      "interestExpense": 0,
      "profitBeforeTax": 0,
      "taxation": 0,
      "profitAfterTax": 0,
      "dividends": 0,
      "retainedProfit": 0,
      "tangibleAssets": 0,
      "intangibleAssets": 0,
      "totalFixedAssets": 0,
      "totalCurrentAssets": 0,
      "tradeDebtors": 0,
      "stock": 0,
      "cash": 0,
      "otherCurrentAssets": 0,
      "increaseInCash": 0,
      "miscCurrentAssets": 0,
      "totalAssets": 0,
      "totalCurrentLiabilities": 0,
      "tradeCreditors": 0,
      "bankBorrowingsCurrent": 0,
      "otherShortTermFinance": 0,
      "miscCurrentLiabilities": 0,
      "otherLongTermFinance": 0,
      "totalLongTermLiabilities": 0,
      "bankOverdraftAndLTL": 0,
      "totalLiabilities": 0,
      "netAssets": 0,
      "workingCapital": 0,
      "issuedShareCapital": 0,
      "revenueReserves": 0,
      "otherReserves": 0,
      "revaluationReserve": 0,
      "totalShareholdersEquity": 0,
      "netWorth": 0,
      "netCashFlowFromOperations": 0,
      "netCashFlowBeforeFinancing": 0,
      "netCashFlowFromFinancing": 0,
      "contingentLiabilities": 0,
      "capitalEmployed": 0,
      "numberOfEmployees": 0,
      "estimated_turnover": 0,
      "accountType": "string",
      "EBITDA": 0
    }
  ],
  "pscData": [
    {
      "companyRegistrationNumber": "string",
      "dataOfBirth": "string",
      "title": "string",
      "pscName": "string",
      "premisesNumber": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "locality": "string",
      "postalCode": "string",
      "county": "string",
      "region": "string",
      "etagRef": "string",
      "controlType": "string",
      "notifiedDate": "string",
      "ceasedDate": "string",
      "insertDate": "string",
      "countryOfResidence": "string",
      "nationality": "string",
      "natureOfControl": "string",
      "links": "string",
      "legalAuthority": "string",
      "legalForm": "string",
      "regCountry": "string",
      "regPlace": "string",
      "regNumber": "string",
      "linkedPscName": "string",
      "stat": "string"
    }
  ],
  "financialRatios": [
    {
      "companyRegistrationNumber": "string",
      "yearStartDate": "string",
      "yearEndDate": "string",
      "preTaxProfitPercentage": "string",
      "currentRatio": "string",
      "salesPerNetworkingCapital": "string",
      "gearingPercentage": "string",
      "equityInPercentage": "string",
      "creditorDays": "string",
      "debtorDays": "string",
      "liquidityPerAcidTest": "string",
      "returnOnCapitalEmployedPercentage": "string",
      "returnOnTotalAssetsEmployedPercentage": "string",
      "currentDebtRatio": "string",
      "totalDebtRatio": "string",
      "stockTurnoverRatio": "string",
      "returnNetAssetsEmployedPercentage": "string",
      "latestYearBoolean": true,
      "startYear": "string",
      "startMonth": "string",
      "startDate": "string"
    }
  ],
  "companyCommentary": [
    {
      "companyRegistrationNumber": "string",
      "commentaryCode": "string",
      "dateLogged": "string",
      "commentaryText": "string",
      "commentaryPriority": "string",
      "commentaryImpact": "string"
    }
  ],
  "accountsType": "string",
  "companyType": "string",
  "companyAge": -9007199254740991,
  "hasContactInfo": true,
  "hasWebsite": true,
  "hasCAGR": true,
  "cagr": [
    {
      "latestYearBoolean": "string",
      "YEAR": 0,
      "cagrRating": "string",
      "cagr": 0,
      "iStarCagr": 0,
      "year": 0,
      "istarCagr": 0
    }
  ],
  "hasZScore": true,
  "hasIScore": true,
  "hasContactNumber": true,
  "activeDirectorsCount": -9007199254740991,
  "resignedDirectorsCount": -9007199254740991,
  "totalDirectorsCount": -9007199254740991,
  "totalSecretary": -9007199254740991,
  "activeSecretary": -9007199254740991,
  "pin": {
    "companyGeoLocation": {
      "lat": 0,
      "lon": 0
    }
  },
  "auditorsQualificationCodes": [
    {
      "accountantsName": "string",
      "auditors": "string",
      "accountsDate": "string"
    }
  ],
  "numtradingAddress": -9007199254740991,
  "hasCompanyGenericMail": true,
  "hasCompanyWebsite": true,
  "hasCompanyLinkedinUrl": true,
  "hasCompanyTwitterUrl": true,
  "hasCompanyFacebookUrl": true,
  "companyConatctsEmailPattern": true,
  "companyContactInformation": {
    "website": "string",
    "linkedin_url": "string",
    "facebook_url": "string",
    "ctps": "string"
  },
  "companyConatctsIndustry": "string",
  "companyEvents": [
    {
      "statusCode": "string",
      "statusCodeDesc": "string",
      "statusFiledDate": "2019-08-24T14:15:22Z",
      "registeredDate": "2019-08-24T14:15:22Z"
    }
  ],
  "isDebtor": true,
  "hasCreditor": true,
  "isCreditor": true,
  "hasDebtor": true,
  "hasHNW1": true,
  "numberOfHnwiPerson": -9007199254740991,
  "contactDetails": {
    "addressLine1": "string",
    "addressLine2": "string",
    "addressLine3": "string",
    "addressLine4": "string",
    "postalCode": "string",
    "telephone": "string",
    "ctps": "string",
    "website": "string",
    "regPOBox": "string",
    "regCareOfAddress": "string",
    "regOfficeAreaCode": "string"
  },
  "directorsData": [
    {
      "directorPnr": 0,
      "fromDate": "string",
      "toDate": "string",
      "appointment": "string",
      "position": "string",
      "directorTitle": "string",
      "directorRole": "string",
      "directorQualifications": "string",
      "directorJobRole": "string",
      "directorOccupation": "string",
      "directorshipCountUpdated": {
        "active_count": 0,
        "non_active_count": 0,
        "resined_count": 0,
        "total": 0
      },
      "directorshipCount": 0,
      "detailedInformation": {
        "forename": "string",
        "middleName": "string",
        "surname": "string",
        "fullName": "string",
        "postalCode": "string",
        "country": "string",
        "birthDate": "string",
        "nationalityName": "string",
        "nationality": "string",
        "directorAge": "string"
      },
      "hasPersonalEmailPattern": true,
      "hasPersonalDecisionMaker": true,
      "hasPersonalFacebookUrl": true,
      "hasPersonalTwitterUrl": true,
      "hasPersonalLinkedinUrl": true,
      "hasPersonalGenericMail": true,
      "email": "string",
      "linkedin_url": "string",
      "email_pattern": "string"
    }
  ],
  "groupStructures": {
    "ultimateParentCompanyRegistrationNumber": "string",
    "parentCompanyRegistrationNumber": "string",
    "companyRegistrationNumber": "string",
    "businessName": "string",
    "country": "string",
    "companyLevelGroup": "string",
    "holdingType": "string",
    "ultimateParentBusinessName": "string",
    "parentBusinessName": "string"
  },
  "shareDetails": [
    {
      "shareholderPNRNumber": "string",
      "companyRegistrationNumber": "string",
      "numberOfSharesIssued": 0,
      "shareType": "string",
      "shareClasses": "string",
      "value": 0,
      "currency": "string",
      "shareholdersDetails": {
        "shareholderTitle": "string",
        "shareholderForename": "string",
        "shareholderSurname": "string",
        "shareholderAddress1": "string",
        "shareholderAddress2": "string",
        "shareholderAddress3": "string",
        "shareholderAddress4": "string",
        "shareholderAddress5": "string",
        "shareholderPostcode": "string"
      }
    }
  ],
  "hasCharges": true,
  "chargesCount": -9007199254740991,
  "outstandingCount": -9007199254740991,
  "satisfiedCount": -9007199254740991,
  "oneYearGrowth": {
    "audit_fees": 0,
    "bank_overdraft": 0,
    "bank_overdraft_ltl": 0,
    "capital_employed": 0,
    "cash": 0,
    "companyRegistrationNumber": "string",
    "contingent_liability": 0,
    "cost_of_sales": 0,
    "depreciation": 0,
    "directors_emoluments": 0,
    "dividends_payable": 0,
    "export": 0,
    "gross_profit": 0,
    "increase_in_cash": 0,
    "intangible_assets": 0,
    "interest_payments": 0,
    "miscellaneous_current_assets": 0,
    "miscellaneous_current_liabilities": 0,
    "net_cashflow_before_financing": 0,
    "net_cashflow_from_financing": 0,
    "net_cashflow_from_operations": 0,
    "net_worth": 0,
    "operating_profits": 0,
    "other_current_assets": 0,
    "other_long_term_fin": 0,
    "other_short_term_fin": 0,
    "paid_up_equity": 0,
    "pl_account_reserve": 0,
    "pre_tax_profit": 0,
    "profit_after_tax": 0,
    "retained_profits": 0,
    "revaluation_reserve": 0,
    "shareholder_funds": 0,
    "stock": 0,
    "sundry_reserves": 0,
    "tangible_assets": 0,
    "taxation": 0,
    "total_assets": 0,
    "total_current_assets": 0,
    "total_current_liabilities": 0,
    "total_fix_assets": 0,
    "total_long_term_liabilities": 0,
    "trade_creditors": 0,
    "trade_debtors": 0,
    "turnover": 0,
    "wages_salaries": 0,
    "working_capital": 0,
    "year_end_date": "string",
    "year_start_date": "string"
  },
  "partialSatisfiedCount": -9007199254740991,
  "hasLandCorporate": true,
  "numLanCorporate": -9007199254740991,
  "hasCCJInfo": true,
  "ccjDetails": [
    {
      "caseNumber": "string",
      "ccjDate": "string",
      "ccjAmount": 0,
      "court": "string",
      "ccjPaidDate": "string",
      "splitFlag": "string",
      "businessName": "string",
      "incomingRecordDetails": "string",
      "plaintiffName": "string",
      "plaintiffForeName": "string",
      "plaintiffSurName": "string",
      "plaintiffAddressLine1": "string",
      "plaintiffAddressLine2": "string",
      "plaintiffAddressLine3": "string",
      "plaintiffAddressLine4": "string",
      "plaintiffAddressLine5": "string",
      "plaintiffPostCode": 0,
      "plaintiffTelephone": 0,
      "manualUpdateFlag": "string",
      "amendFlag": "string",
      "ccjStatus": "string",
      "type": "string"
    }
  ],
  "hasPossibleCCJInfo": true,
  "possibleCCJDetails": [
    {
      "ccjDate": "2019-08-24T14:15:22Z",
      "ccjAmount": 0,
      "court": "string",
      "ccjStatus": "string",
      "type": "string"
    }
  ],
  "hasTradingAddress": true,
  "hasFinances": true,
  "hasSafeAlerts": true,
  "safealertsinformation": [
    {
      "alertCode": "string",
      "alertCodeTitle": "string",
      "alertDate": "string",
      "alertDetail1": "string",
      "alertDetail2": "string",
      "alertDetail3": "string",
      "alertDetail4": "string",
      "alertDetail5": "string",
      "alertDetail6": "string",
      "alertDetail7": "string",
      "alertDetail8": "string",
      "alertDetail9": "string",
      "alertDetail10": "string",
      "alertDetail11": "string"
    }
  ],
  "hasShareHoldings": true,
  "hasShareHolders": true,
  "numShareHolder": -9007199254740991,
  "shareHoldingsCountLive": -9007199254740991,
  "shareHoldingsCount": -9007199254740991,
  "voScore_updated": -9007199254740991,
  "hasPscData": true,
  "hasPersonalLinkedinUrl": true,
  "hasPersonalGenericMail": true,
  "hasPersonalFacebookUrl": true,
  "hasPersonalTwitterUrl": true,
  "hasPersonalTelephone": true,
  "hasPersonalJobTitle": true,
  "otherEmails": true,
  "hasOtherPersonEmail": true,
  "person_contact_details": [
    {
      "personLinkedin": "string",
      "linkedin_url": "string",
      "person_email": "string",
      "email": "string",
      "first_name": "string",
      "last_name": "string",
      "full_name": "string",
      "emailStatus": "string"
    }
  ],
  "hasPersonalPNR": true,
  "hasPersonalEmailPattern": true,
  "hasGroupStructure": true,
  "hasAcquiringCompany": true,
  "hasAcquiredCompany": true,
  "hasImportData": true,
  "importData": [
    {
      "month": "string",
      "period": "string",
      "importCommodityCodes": [
        {}
      ],
      "importCommodityCodesComplete": [
        {}
      ]
    }
  ],
  "twelve_month_import_count": -9007199254740991,
  "twelve_month_export_count": -9007199254740991,
  "exportData": [
    {
      "month": "string",
      "period": "string",
      "exportCommodityCodes": [
        {}
      ],
      "exportCommodityCodesComplete": [
        {}
      ]
    }
  ],
  "hasExportData": true,
  "disqualifiedDirectors": true,
  "hasInvestment": true,
  "internationalScoreCode": "string",
  "internationalScoreDescription": "string",
  "internationalScoreDate": "2019-08-24T14:15:22Z",
  "hasFurloughData": true,
  "hasInnovateData": true,
  "innovate_uk_funded_updated": [
    {
      "competitionReference": "string",
      "competitionTitle": "string",
      "programmeTitle": "string",
      "sector": "string",
      "applicationNumber": "string",
      "projectNumber": "string",
      "projectTitle": "string",
      "publicDescription": "string",
      "competitionYear": "string",
      "innovateUKProductType": "string",
      "participantName": "string",
      "isLeadParticipant": "string",
      "crn": "string",
      "participantWithdrawnFromProject": "string",
      "addressRegion": "string",
      "projectStatus": "string",
      "postcode": "string",
      "addressLEP": "string",
      "addressLocalAuthority": "string",
      "inMultipleLEPs": "string"
    }
  ],
  "hasPatentData": true,
  "patentData": [
    {
      "dateFiled": "string",
      "caseStatus": "string"
    }
  ],
  "patentCount": -9007199254740991,
  "five_year_import_count": "string",
  "voScoreUpdated": -9007199254740991,
  "avgPBT": -9007199254740991,
  "avgCE_updated": -9007199254740991,
  "avgCEUpdated": -9007199254740991,
  "roe": -9007199254740991,
  "roePercent": -9007199254740991,
  "hasCompanyCommentary": true,
  "hasIndustryTag": true,
  "industryTagList": [
    {}
  ],
  "hasEcsData": true,
  "hasEnforcementActions": true,
  "hasEndOfLifeVehicles": true,
  "hasFloodRiskExemptions": true,
  "hasIndustrialInstallation": true,
  "hasRadioactiveSubstance": true,
  "hasScrapMetalDealers": true,
  "hasWastExemptions": true,
  "hasWasteOperations": true,
  "hasWaterDischarges": true,
  "hasWasteCarriersBrokers": true,
  "industryTag": "string",
  "industries": {
    "sicText1": "string",
    "sicIndustry1": "string"
  },
  "tradingAddres": [
    {
      "postcode": "string",
      "county": "string",
      "district": "string",
      "ward": "string",
      "country": "string",
      "constituency": "string",
      "region": "string",
      "postcode_area": "string",
      "postcode_district": "string",
      "police_force": "string",
      "pin": {
        "companyGeoLocation": {
          "lat": 0,
          "lon": 0
        }
      }
    }
  ],
  "ccjcount": -9007199254740991,
  "zscore": [
    {
      "latestYearBoolean": true,
      "YEAR": 0,
      "zScore": 0,
      "zScoreDescription": "string",
      "zscoreDescription": "string",
      "year": 0,
      "zscore": 0
    }
  ],
  "iscore": [
    {
      "latestYearBoolean": true,
      "YEAR": 0,
      "iScoreAll": 0,
      "iRatingIScoreAll": 0,
      "iRatingCategory": "string",
      "iratingIScoreAll": 0,
      "iratingCategory": "string",
      "year": 0,
      "iscoreAll": 0
    }
  ]
}
Previous
Companies
Next
Get company trading address.
Built with