Please wait

API

In order to gain access to the API, a premium tier of subscription must be purchased. Once purchased, your API key will be visible here.

Overview

Every call to the API must include the "apiKey" query string parameter, with the value being your assigned API key.

eg: https://api.identeco.co.uk/company/00002065?apiKey=[YOUR-API-KEY]

In order to maintain a quality of service, all api calls are restricted to 2 requests per second and each key is subject to a total number of requests (value determined by subscription) per 24 hours.
Exceeding these values will result in 429 "Too Many Requests" responses.

Error response

Any error responses will be returned as a successful HTTP call (ie. 200) but will give the reason for the error. For example, a lapsed subscription would return:

{"ok":0,"errCode":401,"errMsg":"Not an API subscription"}

Retrieve company details

GET Retrieve company details by company number.
Endpoint /company/{company_no}
Arguments {company_no} string
The company number you are looking up. Required.
Example: GET /company/00002065
{ "ok": 1, "data": { "type": "company", "id": "00002065", "attributes": { "regNo": "00002065", "name": "LLOYDS BANK PLC", "incorporationDate": "1865-04-20", "status": "Active", "registeredAddressLine1": "25", "registeredAddressLine2": "GRESHAM STREET", "registeredAddressLine3": "LONDON", "registeredAddressLine4": null, "registeredPostcode": "EC2V 7HN", "legalStatus": "Group Accounts Filed", "creditLimit": 20000000, "healthScore": "si", "healthDetails": "Companies will be stable overall. They will have healthy financials, and a normal history of filing compliance. Gearing will be within an acceptable range, with reasonable levels of liquidity. If the trend is not upward, any declines will be modest, with few if any significant or recent legal notices. Considered to be low risk and open credit is recommended.", "creditorDays": null, "sic2007": [ "64191" ], "numberOfEmployees": 65435, "numCcjs": 24, "turnover": 34343000000, "workingCapital": 25710000000, "netWorth": 33863000000, "accountMadeUp": "2024-12-31", "accountFiled": "2025-04-01", "mortgages": [ { "dateCreated": "2025-03-18", "type": "GENERAL CHARGE", "details": null, "holder": "THE BENEFICIARIES (AS DEFINED IN THE INSTRUMENT)", "form": "MR01", "satisfied": "No", "satisfiedDate": null }, { "dateCreated": "2025-03-11", "type": "GENERAL CHARGE", "details": null, "holder": "KFW AS ASSIGNEE", "form": "MR01", "satisfied": "No", "satisfiedDate": null }, { "dateCreated": "2025-03-11", "type": "GENERAL CHARGE", "details": null, "holder": "KFW AS ASSIGNEE", "form": "MR01", "satisfied": "No", "satisfiedDate": null }, { "dateCreated": "2025-03-11", "type": "GENERAL CHARGE", "details": null, "holder": "KFW AS ASSIGNEE", "form": "MR01", "satisfied": "No", "satisfiedDate": null }, { "dateCreated": "2025-03-11", "type": "GENERAL CHARGE", "details": null, "holder": "KFW AS ASSIGNEE", "form": "MR01", "satisfied": "No", "satisfiedDate": null }, { "dateCreated": "2024-05-29", "type": "GENERAL CHARGE", "details": null, "holder": "LLOYDS BANKING GROUP PENSIONS TRUSTEES LIMITED (IN ITS CAPACITY AS TRUSTEE OF LLOYDS BANK PENSI", "form": "MR01", "satisfied": "No", "satisfiedDate": null } ], "previousNames": [ { "from": "1989-10-19", "to": "1999-06-28", "name": "LLOYDS BANK PLC" }, { "from": "1999-06-28", "to": "2013-09-23", "name": "LLOYDS TSB BANK PLC" } ], "directors": [ { "title": "MR", "forename": "NATHAN MARK", "surname": "BOSTOCK", "suffix": null, "dateOfBirth": "1960-10-00", "nationality": "BRITISH", "occupation": "DIRECTOR", "appointedOn": "2024-08-01", "otherAppointments": null, "addr1": "25 GRESHAM STREET", "addr2": null, "addr3": "LONDON", "addr4": null, "postcode": "EC2V 7HN" }, { "title": "MR", "forename": "CHARLES ALAN", "surname": "NUNN", "suffix": null, "dateOfBirth": "1971-09-00", "nationality": "BRITISH", "occupation": "DIRECTOR", "appointedOn": "2021-08-16", "otherAppointments": null, "addr1": "25 GRESHAM STREET", "addr2": null, "addr3": "LONDON", "addr4": null, "postcode": "EC2V 7HN" }, { "title": "MS", "forename": "CATHERINE LUCY", "surname": "TURNER", "suffix": null, "dateOfBirth": "1963-06-00", "nationality": "BRITISH", "occupation": "COMPANY DIRECTOR", "appointedOn": "2022-11-01", "otherAppointments": null, "addr1": "25 GRESHAM STREET", "addr2": null, "addr3": "LONDON", "addr4": null, "postcode": "EC2V 7HN" }, { "title": "MR", "forename": "JONATHAN SCOTT", "surname": "WHEWAY", "suffix": null, "dateOfBirth": "1966-08-00", "nationality": "BRITISH", "occupation": "COMPANY DIRECTOR", "appointedOn": "2022-08-01", "otherAppointments": null, "addr1": "25 GRESHAM STREET", "addr2": null, "addr3": "LONDON", "addr4": null, "postcode": "EC2V 7HN" } ], "latestBalanceSheet": { "periodEnding": "2024-12-31", "numberOfWeeks": 52, "currency": "GBP", "tangibleFixedAssets": 10076000000, "intangibleAssets": 5804000000, "totalFixedAssets": 23693000000, "stocks": 0, "tradeDebtors": 541797000000, "cash": 42396000000, "miscCurrentAssets": 3327000000, "totalCurrentAssets": 587520000000, "creditorsDue": 561810000000, "totalAssetsLessCurrentLiabilities": 49403000000, "totalLongTermLiabilities": 9736000000, "totalLiabilities": 571546000000, "shareCapitalAndReserves": 10504000000, "profitAndLossAccountReserve": 29412000000, "revaluationReserve": -249000000, "sharefoldersFunds": 39667000000, "workingCapital": 25710000000, "netWorth": 33863000000, "totalAssets": 611213000000, "contingentLiabilities": 59143000000 } } } }