Getting Started
Integration
API Reference
- GETAutocomplete Companies (indexed)
- POSTSearch Companies (real-time)
- POSTSearch Companies (indexed)
- POSTRetrieve Company Document
- POSTList Available Documents (real-time)
- POSTRetrieve Company Report (real-time)
- GETGet Company Report (indexed)
- POSTExtract Multi-Level Shareholder Graph (real-time)
- POSTExtract Ultimate Beneficial Owners (real-time)
- GET
curl --request GET \
--url https://api.kausate.com/v2/companies/{kausateId}/report/indexed \
--header 'X-API-Key: <api-key>'{
"companyReport": {
"sources": {},
"basicInformation": {
"type": "<string>",
"legalName": "<string>",
"alternativeNames": [
{
"type": "<string>",
"name": "<string>",
"source": "<string>"
}
],
"status": {
"original": "<string>",
"normalized": "active",
"isActive": true
},
"legalForm": {
"original": "<string>",
"normalized": "<string>",
"iso20275LegalFormCode": "<string>"
},
"signatoryRules": {
"original": "<string>",
"englishTranslation": "<string>"
},
"capital": {
"currency": {
"amount": "<string>",
"iso4217CurrencyCode": "<string>"
}
},
"identifiers": [
{
"value": "<string>",
"type": "<string>",
"source": "<string>",
"description": "<string>",
"extra": {}
}
],
"dates": {
"incorporationDate": {
"original": "<string>",
"normalized": "<string>"
},
"lastChanged": {
"original": "<string>",
"normalized": "<string>"
}
},
"addresses": [
{
"type": "arrival",
"source": "<string>",
"original": "<string>",
"normalized": {
"house": "<string>",
"category": "<string>",
"near": "<string>",
"houseNumber": "<string>",
"road": "<string>",
"unit": "<string>",
"level": "<string>",
"staircase": "<string>",
"entrance": "<string>",
"poBox": "<string>",
"postcode": "<string>",
"suburb": "<string>",
"cityDistrict": "<string>",
"city": "<string>",
"island": "<string>",
"stateDistrict": "<string>",
"state": "<string>",
"county": "<string>",
"countryRegion": "<string>",
"country": "<string>",
"countryCode": "<string>",
"worldRegion": "<string>"
}
}
],
"activities": [
{
"scheme": "nace_rev_2",
"code": "<string>",
"description": "<string>",
"source": "<string>",
"isPrimary": true
}
]
},
"relationships": {
"legalRepresentatives": [
{
"type": "<string>",
"person": {
"address": {
"type": "arrival",
"source": "<string>",
"original": "<string>",
"normalized": {
"house": "<string>",
"category": "<string>",
"near": "<string>",
"houseNumber": "<string>",
"road": "<string>",
"unit": "<string>",
"level": "<string>",
"staircase": "<string>",
"entrance": "<string>",
"poBox": "<string>",
"postcode": "<string>",
"suburb": "<string>",
"cityDistrict": "<string>",
"city": "<string>",
"island": "<string>",
"stateDistrict": "<string>",
"state": "<string>",
"county": "<string>",
"countryRegion": "<string>",
"country": "<string>",
"countryCode": "<string>",
"worldRegion": "<string>"
}
},
"contact": {},
"jurisdictionCode": "<string>",
"dateOfBirth": {
"original": "<string>",
"normalized": "<string>"
},
"gender": "<string>",
"identifiers": [
{
"value": "<string>",
"type": "<string>",
"source": "<string>",
"description": "<string>",
"extra": {}
}
],
"name": {
"firstName": "<string>",
"lastName": "<string>",
"fullName": "<string>"
},
"nationality": "<string>"
},
"role": {
"original": "<string>",
"englishTranslation": "<string>",
"iso5009RoleCode": "<string>"
},
"signatoryRule": {
"original": "<string>",
"englishTranslation": "<string>"
},
"startDate": {
"original": "<string>",
"normalized": "<string>"
},
"source": "<string>"
}
]
}
},
"type": "companyReport"
}Get Company Report (indexed)
Retrieve the latest indexed company report from our database.
This endpoint returns pre-processed company reports that have been previously retrieved and transformed from official registry sources. It provides instant access to company data without requiring a real-time retrieval operation.
Note: This endpoint is free to use - no credit cost.
Use Cases:
- Quick access to previously retrieved company information
- Displaying company details in applications
- Checking available data before ordering a real-time update
Parameters:
- kausateId: Company ID to get report for
Returns: Complete company report including basic information, relationships, and sources.
Note: If no indexed report is available, use POST /v2/companies/{kausateId}/report
to trigger a real-time retrieval.
curl --request GET \
--url https://api.kausate.com/v2/companies/{kausateId}/report/indexed \
--header 'X-API-Key: <api-key>'{
"companyReport": {
"sources": {},
"basicInformation": {
"type": "<string>",
"legalName": "<string>",
"alternativeNames": [
{
"type": "<string>",
"name": "<string>",
"source": "<string>"
}
],
"status": {
"original": "<string>",
"normalized": "active",
"isActive": true
},
"legalForm": {
"original": "<string>",
"normalized": "<string>",
"iso20275LegalFormCode": "<string>"
},
"signatoryRules": {
"original": "<string>",
"englishTranslation": "<string>"
},
"capital": {
"currency": {
"amount": "<string>",
"iso4217CurrencyCode": "<string>"
}
},
"identifiers": [
{
"value": "<string>",
"type": "<string>",
"source": "<string>",
"description": "<string>",
"extra": {}
}
],
"dates": {
"incorporationDate": {
"original": "<string>",
"normalized": "<string>"
},
"lastChanged": {
"original": "<string>",
"normalized": "<string>"
}
},
"addresses": [
{
"type": "arrival",
"source": "<string>",
"original": "<string>",
"normalized": {
"house": "<string>",
"category": "<string>",
"near": "<string>",
"houseNumber": "<string>",
"road": "<string>",
"unit": "<string>",
"level": "<string>",
"staircase": "<string>",
"entrance": "<string>",
"poBox": "<string>",
"postcode": "<string>",
"suburb": "<string>",
"cityDistrict": "<string>",
"city": "<string>",
"island": "<string>",
"stateDistrict": "<string>",
"state": "<string>",
"county": "<string>",
"countryRegion": "<string>",
"country": "<string>",
"countryCode": "<string>",
"worldRegion": "<string>"
}
}
],
"activities": [
{
"scheme": "nace_rev_2",
"code": "<string>",
"description": "<string>",
"source": "<string>",
"isPrimary": true
}
]
},
"relationships": {
"legalRepresentatives": [
{
"type": "<string>",
"person": {
"address": {
"type": "arrival",
"source": "<string>",
"original": "<string>",
"normalized": {
"house": "<string>",
"category": "<string>",
"near": "<string>",
"houseNumber": "<string>",
"road": "<string>",
"unit": "<string>",
"level": "<string>",
"staircase": "<string>",
"entrance": "<string>",
"poBox": "<string>",
"postcode": "<string>",
"suburb": "<string>",
"cityDistrict": "<string>",
"city": "<string>",
"island": "<string>",
"stateDistrict": "<string>",
"state": "<string>",
"county": "<string>",
"countryRegion": "<string>",
"country": "<string>",
"countryCode": "<string>",
"worldRegion": "<string>"
}
},
"contact": {},
"jurisdictionCode": "<string>",
"dateOfBirth": {
"original": "<string>",
"normalized": "<string>"
},
"gender": "<string>",
"identifiers": [
{
"value": "<string>",
"type": "<string>",
"source": "<string>",
"description": "<string>",
"extra": {}
}
],
"name": {
"firstName": "<string>",
"lastName": "<string>",
"fullName": "<string>"
},
"nationality": "<string>"
},
"role": {
"original": "<string>",
"englishTranslation": "<string>",
"iso5009RoleCode": "<string>"
},
"signatoryRule": {
"original": "<string>",
"englishTranslation": "<string>"
},
"startDate": {
"original": "<string>",
"normalized": "<string>"
},
"source": "<string>"
}
]
}
},
"type": "companyReport"
}Authorizations
Sign up at Kausate.com to get an API key
Path Parameters
Company ID
Response
Company report retrieved successfully
Response wrapper for company report extraction
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Source type for information origin.
selfDeclaration, officialRegister, thirdParty, primaryResearch, verified Show child attributes
Show child attributes
"organization"Show child attributes
Show child attributes
Company status type definitions with descriptions
active, closed, closing, dissolved, expanded, expired, inReceivership, inactive, incorporated, opening, registered, registrationRevoked, seized, terminated, underExternalControl Show child attributes
Show child attributes
The text/number value of the identifier
The type must include the jurisdiction in which it is issued
The source of this identifier (e.g., 'registrar', 'company', 'third_party')
Free-text description of the identifier when type is unknown or needs clarification
Additional metadata about the identifier
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Address type definitions with descriptions
arrival, business, departure, mailing, operations, physical, placeOfBirth, receiverAddress, registered, residential, shipperAddress, transit Normalized address fields with null values excluded from serialization.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Classification scheme (e.g., NACE, ISIC).
nace_rev_2, isic_rev_4, naics_2022, sic, wz_2008, free_text Activity code within the scheme.
Textual description of the activity.
Source of the information (e.g., 'registrar').
Indicates if this is the company's principal activity.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
"person"A natural person (human being)
Show child attributes
Show child attributes
Address of a company or person.
Show child attributes
Show child attributes
Address type definitions with descriptions
arrival, business, departure, mailing, operations, physical, placeOfBirth, receiverAddress, registered, residential, shipperAddress, transit Normalized address fields with null values excluded from serialization.
Show child attributes
Show child attributes
ISO 3166-1 alpha-2 country/jurisdiction code
Show child attributes
Show child attributes
The text/number value of the identifier
The type must include the jurisdiction in which it is issued
The source of this identifier (e.g., 'registrar', 'company', 'third_party')
Free-text description of the identifier when type is unknown or needs clarification
Additional metadata about the identifier
"companyReport"Was this page helpful?