- 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
(theidField
from 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 |
idField from 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"
}