---
title: "Lite Profile"
method: GET
path: "/companies/{kyckrId}/lite"
tags: ["Companies"]
---

# Lite Profile

`GET /companies/{kyckrId}/lite`

## Request

- Base URL: `https://api.kyckr.com/v2`
- URL: `https://api.kyckr.com/v2/companies/{kyckrId}/lite`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api/docs/companies/:kyckrId/lite/get.ts> (a function with typed inputs; its response is checked against the schema)

Basic company details are verified by ordering a Lite Profile. The Lite Profile includes (where present at the registry):

- Company Name
- Company Number
- Registered Address
- Registration or Foundation Date
- Registration Status
- Legal Form
- Company Activity
- Registration Authority

## Query parameters

- `customerReference` string

## Response `200`

OK

- object
  - `orderId` string: The related orderId.
  - `correlationId` string: The related correlationId to this request, for support purposes.
  - `customerReference` string: A customer provided reference, which appears in the order list.
  - `timeStamp` string, date-time: The UTC time at which the request occurred.
  - `details` string: The response status details for the current request.
  - `cost` Cost: Cost of an item
    - `type` 'credit' | 'lite'
    - `value` number
  - `links` object
    - `self` string, uri-reference
  - `data` LiteProfile
    - `activity` Activity[]
      - `code` string: Activity code
      - `description` string: Description of activity
      - `classificationScheme` 'NACE' | 'NACErev2' | 'NACErev2.1' | 'SIC' | 'SIC07' | 'NAICS': Classification scheme, for example NAICS or NACErev2
      - `type` 'Primary' | 'Secondary': Primary or secondary activity
    - `address` Address: Standardised shared model for addresses
      - `identifier` string, nullable: Stable identifier for this address instance within the profile. Use to cross-reference into the additionalInformation.addressInformation array.
      - `type` string: Type of address, for example "Head Office" or "Registered Address"
      - `fullAddress` string: The full address as a single string
      - `rawAddressLines` string[]: An array of address lines as retrieved from the registry
      - `buildingName` string: Name of building, e.g. "The Chrysler Building"
      - `streetNumber` string: Number portion of street address, e.g. "18", "21A"
      - `streetName` string: Street name
      - `city` string: City or town
      - `postcode` string: Primary postal code
      - `municipality` string: Administrative sub-region, for example a French commune or US county
      - `region` string: Administrative region for example a US state or UK county
      - `country` string: Country
      - `isoCode` string: Jurisdiction code in ISO 3166 alpha-2
      - `secondaryPostalCode` string: A secondary postal code, for example a CEDEX
    - `companyNumber` string: Company registration number issued by the registrationAuthority
    - `registrationAuthority` string: Name of registration authority
    - `registrationAuthorityCode` string: The registration authority code for the company
    - `registrationType` string: If present, indicates that the original foundational legal entity registration is at another register (the source register).
    - `registrationTypeDetails` object: Additional details in relation to the registration type, if registrationType is set.
      - `originalCode` string: Non standard code for the source registry.
      - `originalDescription` string: Description text for the source registry.
      - `normalizedCode` string: ISO code for the country, province or state of the source registry.
      - `normalizedDescription` string: Country and state description of the foreign registry.
    - `companyName` string: Company name as at registry
    - `englishName` string: Company name in english, if available
    - `aliases` AlternativeNames[]: Alternative company names
      - `name` string: Alternative company names
      - `type` string: Type of name, e.g. Trading Name, Business Name
    - `previousNames` PreviousNames[]: Previous company names
      - `name` string: Previous company name
      - `startDate` NormalizedDate
        - `original` string: Date as formatted at registry source
        - `normalized` string, date: Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available.
      - `endDate` NormalizedDate
        - `original` string: Date as formatted at registry source
        - `normalized` string, date: Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available.
    - `otherIdentifiers` Identifier[]: Additional identifiers with their standardized type codes
      - `value` string: The identifier value
      - `type` string: The standardized type code for this identifier
    - `taxNumber` string: Deprecated, use otherIdentifiers instead
    - `foundationDate` NormalizedDate
      - `original` string: Date as formatted at registry source
      - `normalized` string, date: Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available.
    - `registrationDate` NormalizedDate
      - `original` string: Date as formatted at registry source
      - `normalized` string, date: Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available.
    - `lastAnnualAccountDate` NormalizedDate
      - `original` string: Date as formatted at registry source
      - `normalized` string, date: Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available.
    - `legalForm` NormalizedLegalForm
      - `original` string: Legal form as described at source
      - `normalized` 'Private Limited Company' | 'Public Limited Company' | 'Limited Partnership' | 'Limited Liability Partnership' | 'General Partnership' | 'Cooperative' | 'Collective Investment Vehicle' | 'Association' | 'Sole Proprietor' | 'Branch' | 'Foreign Registered Body' | 'Government or Public Body' | 'Foundation' | 'Trust' | 'Other': Standard value mapped from the registry's legal form. See [Normalised values](/documentation/useful-information/normalised-values) for the 15 possible values and what they mean. **Beta** — first populated for HK, CN, and JP in an upcoming release; other jurisdictions will follow. Where populated, `Other` is used when no specific value fits; the original registry label remains in `original`.
    - `legalStatus` NormalizedStatus
      - `original` string: Legal status as described at source
      - `normalized` 'Active' | 'Inactive' | 'Distressed' | 'Other': Legal status mapped to a standard Kyckr value (see Normalised values guide)
    - `stateOfIncorporation` string: State of incorporation (US Only)
    - `updatedDate` NormalizedDate
      - `original` string: Date as formatted at registry source
      - `normalized` string, date: Date in ISO-8601 format. The precision matches what is available at the registry source. Supports both full dates (YYYY-MM-DD) and partial dates (YYYY-MM) when only month and year are available.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

## Changes

- **2026-11-06** `f7cb3dcbfb13`: 2 warning
  - added the new `NACErev2` enum value to the `allOf[subschema #2]/data/activity/items/classificationScheme` response property for the response status `200`
  - added the new `NACErev2.1` enum value to the `allOf[subschema #2]/data/activity/items/classificationScheme` response property for the response status `200`
- **2026-11-03** `43819cfabfed`: 6 breaking
  - the `allOf[subschema #1: BaseResponse]/orderId` response's property type changed from `number` to `string` for status `200`
  - the `allOf[subschema #1: BaseResponse]/orderId` response's property type changed from `number` to `string` for status `400`
  - the `allOf[subschema #1: BaseResponse]/orderId` response's property type changed from `number` to `string` for status `401`
  - the `allOf[subschema #1: BaseResponse]/orderId` response's property type changed from `number` to `string` for status `403`
  - …2 more

[Operation history](https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api/changes/companies/:kyckrId/lite/get.md)

---

[API](https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api.md) - [All operations](https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kyckr/apis/kyckr-companies-v2-api/revisions/b5008b331ed7?raw)