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

# Documents

`GET /companies/{kyckrId}/documents`

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` number — 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

---

[API](https://skmtc.net/kyckr/apis/kyckr-companies-v2-api.md) · [All operations](https://skmtc.net/kyckr/apis/kyckr-companies-v2-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kyckr/kyckr-companies-v2-api/revisions/ed17e149d3c8/schema)