> ## 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.

# Workflow

> Working with the Kyckr Company V2 API - search, profile retrieval, and document ordering workflow.

## Searching for a company

[Guide](../search)  [API reference](/api-reference/companies/search-for-companies)

A search by company name or number must be performed in order to find a valid, registered legal entity using the API  (`GET /companies`).

A KyckrId will be returned in the JSON response. Any additional API calls will use the KyckrId as the identifier for the company.

KyckrIds follow the format:
`{jurisdiction}|{base64-encoded-reference}`

For example:
`GB|MTE2NTUyOTA`

The `kyckrId` format may be subject to change in a future release and should not be used for persistent storage.

## Retrieving company information

Once the correct entity is located, several options are available for retrieving company information:

| Lite Profile [API reference](/api-reference/companies/lite-profile) [Guide](../lite-profile) | Enhanced Profile [API reference](/api-reference/companies/enhanced-profile) [Guide](../enhanced-profile) |
| -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| `GET /companies/{kyckrId}/lite`                                                              | `GET /companies/{kyckrId}/enhanced`                                                                      |
| Company name and registration number                                                         | Company name and registration number                                                                     |
| Registered address or locality                                                               | Registered address or locality                                                                           |
| Legal form and status                                                                        | Legal form and status                                                                                    |
| Foundation date                                                                              | Foundation date                                                                                          |
| Primary business activity                                                                    | Primary business activity                                                                                |
|                                                                                              | Corporate structure                                                                                      |
|                                                                                              | Legal form and status                                                                                    |
|                                                                                              | Company officials                                                                                        |
|                                                                                              | Shareholding information (where available)                                                               |

The information is retrieved directly from the registry at the point of request — synchronously for most jurisdictions. (An async order pattern is in development \[preview] for cases where upstream fulfilment exceeds the connection-hold window — see the developer news for rollout details.) The response is returned in a standard JSON format, allowing easy mapping into your platform regardless of the targeted registry.

## Ordering original registry documents

If additional information is required, original registry documents are available:

1. List available documents (`GET /companies/{kyckrId}/documents`)
   * Shows document types, costs, and delivery times
   * Indicates what information each document contains (company details, directors, shareholders, UBOs)

2. Track orders (`GET /orders`)
   * Monitor the status of document orders
   * Download documents when ready
   * Access both structured data and original registry formats

All responses include standardized fields for tracking (`correlationId`, `customerReference`).