Enhanced Profile
curl --request GET \
--url https://api.kyckr.com/v2/companies/{kyckrId}/enhanced \
--header 'Authorization: Bearer <token>'{
"orderId": 12345,
"correlationId": "string",
"customerReference": "string",
"timeStamp": "2019-08-24T14:15:22Z",
"details": "string",
"cost": {
"type": "credit",
"value": 1
},
"links": {
"self": "../dictionary"
},
"data": {
"activities": [
{
"code": "string",
"description": "string",
"classificationScheme": "NACE",
"type": "Primary"
}
],
"activityDeclarations": [
{
"declaration": "string",
"declarationDescription": "string",
"language": "string"
}
],
"addresses": [
{
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
}
],
"capital": [
{
"type": "string",
"description": "string",
"classCode": "string",
"classDescription": "string",
"quantity": 0,
"unitNominalValue": 0,
"totalNominalValue": 0,
"currency": "string",
"shareholdings": [
{
"percentage": "string",
"count": 0,
"totalNominalValue": 0,
"shareholders": {
"corporations": [
{
"type": "Corporation",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"registrationNumber": "string",
"registrationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"registrationAuthority": "string",
"registeredAddress": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
}
}
],
"individuals": [
{
"type": "Person",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"birthdate": {
"original": "string",
"normalized": "2019-08-24"
},
"nationality": "string",
"placeOfBirth": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"placeOfResidence": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
}
}
]
}
}
]
}
],
"representatives": {
"corporations": [
{
"type": "Corporation",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"registrationNumber": "string",
"registrationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"registrationAuthority": "string",
"registeredAddress": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"role": {
"original": "string",
"normalized": "string"
},
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
},
"isActive": true,
"directorships": [
{
"companyNumber": "string",
"companyName": "string",
"role": "string",
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
},
"isActive": true
}
],
"powers": [
"string"
]
}
],
"individuals": [
{
"type": "Person",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"birthdate": {
"original": "string",
"normalized": "2019-08-24"
},
"nationality": "string",
"placeOfBirth": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"placeOfResidence": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"role": {
"original": "string",
"normalized": "string"
},
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
},
"isActive": true,
"directorships": [
{
"companyNumber": "string",
"companyName": "string",
"role": "string",
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
},
"isActive": true
}
],
"powers": [
"string"
]
}
]
},
"ultimateBeneficialOwners": {
"individuals": [
{
"natureOfControl": [
"string"
],
"type": "Person",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"birthdate": {
"original": "string",
"normalized": "2019-08-24"
},
"nationality": "string",
"placeOfBirth": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"placeOfResidence": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
}
}
]
},
"contactDetails": {
"email": "string",
"fax": "string",
"telNumber": "string",
"website": "string"
},
"identifiers": {
"primaryRegistrationNumber": "string",
"taxNumber": "string",
"secondaryRegistrationNumber": "string",
"otherIdentifiers": [
{
"type": "array",
"description": "Additional identifiers with their standardized type codes",
"items": {
"$ref": "#/components/schemas/Identifier"
}
}
]
},
"companyName": "string",
"tradingName": "string",
"englishName": "string",
"aliases": [
{
"name": "string",
"type": "string"
}
],
"previousNames": [
{
"name": "string",
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
}
}
],
"registrationAuthority": "string",
"lastUpdated": "2019-08-24T14:15:22Z",
"foundationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"registrationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"incorporationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"dissolutionDate": {
"original": "string",
"normalized": "2019-08-24"
},
"status": {
"original": "string",
"normalized": "Active"
},
"legalForm": {
"original": "string",
"normalized": "string"
}
}
}Companies
Enhanced Profile
A company profile, including information about directors and shareholders, is retrieved using the Enhanced Profile API. This profile contains all information from the Lite Profile and adds details of associated persons or entities filed at the company registry. The profile includes (where filed in structured form at the registry):
- Registration Information (Lite Profile + expanded details where available)
- Share capital structure
- Company Officials (incl. Directors) – including function, date of birth and address.
- Shareholders (Beneficial owners) – including share count, share percentage and ID information.
- Ultimate Beneficial Owners – where filed in structured form.
GET
/
companies
/
{kyckrId}
/
enhanced
Enhanced Profile
curl --request GET \
--url https://api.kyckr.com/v2/companies/{kyckrId}/enhanced \
--header 'Authorization: Bearer <token>'{
"orderId": 12345,
"correlationId": "string",
"customerReference": "string",
"timeStamp": "2019-08-24T14:15:22Z",
"details": "string",
"cost": {
"type": "credit",
"value": 1
},
"links": {
"self": "../dictionary"
},
"data": {
"activities": [
{
"code": "string",
"description": "string",
"classificationScheme": "NACE",
"type": "Primary"
}
],
"activityDeclarations": [
{
"declaration": "string",
"declarationDescription": "string",
"language": "string"
}
],
"addresses": [
{
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
}
],
"capital": [
{
"type": "string",
"description": "string",
"classCode": "string",
"classDescription": "string",
"quantity": 0,
"unitNominalValue": 0,
"totalNominalValue": 0,
"currency": "string",
"shareholdings": [
{
"percentage": "string",
"count": 0,
"totalNominalValue": 0,
"shareholders": {
"corporations": [
{
"type": "Corporation",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"registrationNumber": "string",
"registrationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"registrationAuthority": "string",
"registeredAddress": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
}
}
],
"individuals": [
{
"type": "Person",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"birthdate": {
"original": "string",
"normalized": "2019-08-24"
},
"nationality": "string",
"placeOfBirth": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"placeOfResidence": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
}
}
]
}
}
]
}
],
"representatives": {
"corporations": [
{
"type": "Corporation",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"registrationNumber": "string",
"registrationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"registrationAuthority": "string",
"registeredAddress": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"role": {
"original": "string",
"normalized": "string"
},
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
},
"isActive": true,
"directorships": [
{
"companyNumber": "string",
"companyName": "string",
"role": "string",
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
},
"isActive": true
}
],
"powers": [
"string"
]
}
],
"individuals": [
{
"type": "Person",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"birthdate": {
"original": "string",
"normalized": "2019-08-24"
},
"nationality": "string",
"placeOfBirth": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"placeOfResidence": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"role": {
"original": "string",
"normalized": "string"
},
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
},
"isActive": true,
"directorships": [
{
"companyNumber": "string",
"companyName": "string",
"role": "string",
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
},
"isActive": true
}
],
"powers": [
"string"
]
}
]
},
"ultimateBeneficialOwners": {
"individuals": [
{
"natureOfControl": [
"string"
],
"type": "Person",
"idNumber": "string",
"name": "string",
"address": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"birthdate": {
"original": "string",
"normalized": "2019-08-24"
},
"nationality": "string",
"placeOfBirth": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
},
"placeOfResidence": {
"type": "string",
"fullAddress": "string",
"rawAddressLines": [
"string"
],
"buildingName": "string",
"streetNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"municipality": "string",
"region": "string",
"country": "string",
"secondaryPostalCode": "string"
}
}
]
},
"contactDetails": {
"email": "string",
"fax": "string",
"telNumber": "string",
"website": "string"
},
"identifiers": {
"primaryRegistrationNumber": "string",
"taxNumber": "string",
"secondaryRegistrationNumber": "string",
"otherIdentifiers": [
{
"type": "array",
"description": "Additional identifiers with their standardized type codes",
"items": {
"$ref": "#/components/schemas/Identifier"
}
}
]
},
"companyName": "string",
"tradingName": "string",
"englishName": "string",
"aliases": [
{
"name": "string",
"type": "string"
}
],
"previousNames": [
{
"name": "string",
"startDate": {
"original": "string",
"normalized": "2019-08-24"
},
"endDate": {
"original": "string",
"normalized": "2019-08-24"
}
}
],
"registrationAuthority": "string",
"lastUpdated": "2019-08-24T14:15:22Z",
"foundationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"registrationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"incorporationDate": {
"original": "string",
"normalized": "2019-08-24"
},
"dissolutionDate": {
"original": "string",
"normalized": "2019-08-24"
},
"status": {
"original": "string",
"normalized": "Active"
},
"legalForm": {
"original": "string",
"normalized": "string"
}
}
}Documentation Index
Fetch the complete documentation index at: https://developer.kyckr.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Kyckr company reference, a shared format, usable across our V2 APIs
Query Parameters
Where supported (currently GB/UK only), includes additional directorship information for each director, showing other companies where the director holds positions. When set to true, the directorships array will be populated for each representative.
Optional reference supplied by customer for tracking purposes
Comma-separated list of profile extension types to include in the response. Extension data is returned in the additionalInformation object on the EnhancedProfile. Each extension type may be subject to per-account entitlements and additional cost. Unrecognised or unauthorised values are silently ignored. Additional extension types will be added as they become available. This parameter and its extension types are currently in beta trial and subject to change.
Available extension types:
geocoding— PopulatesadditionalInformation.addressInformationwith parsed and geocoded address variants for all addresses in the profile. Each entry inaddressInformation.addresses[]is linked to its source address via theAddress.identifierfield. Contact your account manager to enable.
Example:
"geocoding"
Response
OK
The related orderId.
Example:
12345
The related correlationId to this request, for support purposes.
A customer provided reference, which appears in the order list.
The UTC time at which the request occurred.
The response status details for the current request.
Cost of an item
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Basic company information
Show child attributes
Show child attributes
⌘I