- Developer newsUpdates to the API
- IntroductionAbout the Companies V1 API
- Company searchSearch for a company by name or number
- Cache searchSearch for a company globally
- Lite ProfileBasic company verification details
- Enhanced ProfileCompany profiles with representatives and shareholders
- Filing searchOrder registry extracts and filings
- UBO VerifyFind the ultimate beneficial owners via corporate ownership structure
- About testingInformation about the Kyckr test environment
- Supported jurisdictionsJurisdictions and regional codes
- Response codesExtra information in the responseCodeField
- FAQsFrequently asked questions about the V1 API
company-v1
Order documents
Order a document for a company
The product order call allows ordering filings from the registry. This POST call requires details to be provided in the body.
To order a filing from the registry, the following variables are needed:
Required fields
- 2 digit ISO code https://www.iso.org/iso-3166-country-codes.html
- productKey(the- idFieldfrom the search)
Optional
- companyName
- orderRef
[ Product order API reference ]
Order Reference
To help organise all orders, provide a reference for each order placed. This order reference appears in the response when the order is placed and can be used to retrieve the document at a later date.
Example
The below example uses a an order reference.
curl --location 'https://rest.kyckr.com/core/filing/order' \
--header 'Authorization:{{apiKey}}' \
--header 'Content-Type: application/json' \
--data '{
    "countryISO": "GB",
    "productKey": "CHON_Q0hfQ29tcGFueU1vcnRnYWdlc18x_MTE2NTUyOTA=", 
    "companyName": "Kyckr UK LTD", 
    "orderRef": "Example 1"  
}'| Field | Description | 
|---|---|
| countryIso | ISO of jurisdiction for document required | 
| productKey | idFieldfrom Filing Search | 
| companyName | Name of company | 
| orderRef | Your reference for this order (can be used to retrieve order details) | 
Response
Requesting the document using this POST returns a response confirming the order was successful.
{
    "Result": true,
    "Message": "Order Successful",
    "orderRef": "Example 1"
}