---
title: "Documents"
method: GET
path: "/companies/{kyckrId}/documents"
tags: ["Companies"]
---

# Documents

`GET /companies/{kyckrId}/documents`

## Request

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

Retrieve a list of available documents for a company.  After finding a document of interest, use the Create Order API to order a copy of the document.

## Query parameters

- `continuationKey` 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` DocumentDescription[]
    - `id` string: Product ID
    - `cost` Cost: Cost of an item
      - `type` 'credit' | 'lite'
      - `value` number
    - `name` string: Name of document
    - `documentDate` string, date: The date associated with the document, usually the filing date
    - `category` string: Type of document
    - `deliveryTimeMinutes` integer: Target delivery time in minutes
    - `documentFormat` string[]: A list of mime-types for files that will be returned for an order
    - `documentDatapoints` object
      - `companyDetails` boolean
      - `directors` boolean
      - `shareholders` boolean
      - `declaredBeneficialOwners` boolean
  - `continuationKey` string, nullable: When present, pass this value as the continuationKey query parameter on the next request to retrieve the next page of documents. When absent, there are no more pages.

## Other responses

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

## Changes

- **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/documents/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)