---
title: "Get Company Documents"
method: GET
path: "/v1/companies/company/{company_id}/documents"
tags: ["API / Company", "Use case / Master data sync"]
---

# Get Company Documents

`GET /v1/companies/company/{company_id}/documents`

## Request

- Base URL: `https://api.qargo.com`
- URL: `https://api.qargo.com/v1/companies/company/{company_id}/documents`
- Auth: OAuth 2 (client credentials, token URL `/v1/auth/token`)

Fetch all documents for a specific company.

## Path parameters

- `company_id` string, uuid, required

## Query parameters

- `cursor` string, nullable

## Response `200`

Successful Response

- ListCompanyDocumentOutput
  - `next_cursor` string, nullable
  - `items` CompanyDocumentOutput[], required
    - `id` string, uuid, required: Unique identifier of the document
    - `name` string, required: Name of the document
    - `type` union, required: Type of the document.
      - 'ATA_CARNET' | 'BANK_DETAILS' | 'CMR_INSURANCE' | 'COMMON_HEALTH_ENTRY_DOCUMENT' | 'COMMUNICATION' | 'COMMUNICATION_SUBCONTRACTOR' | 'SUBCONTRACTOR_CONTRACT' | 'CREDIT_REPORT' | 'DGSA_CERTIFICATE' | 'ECMT_TRANSPORT_LICENSE' | 'EU_TRANSPORT_LICENSE' | 'EXPORT_HEALTH_CERTIFICATE' | 'FINE' | 'FREIGHT_FORWARDER_LICENSE' | 'SUBCONTRACTOR_LICENSE' | 'NATIONAL_TRANSPORT_LICENSE' | 'OTHER' | 'SUBCONTRACTOR_PERMIT' | 'POWER_OF_ATTORNEY' | 'QUESTIONNAIRE_CUSTOMER' | 'QUESTIONNAIRE_SUBCONTRACTOR' | 'SERVICE_LEVEL_AGREEMENT' | 'SQAS_CERTIFICATE' | 'COMPANY_TDS' | 'TRAILER_CLEANING_CERTIFICATE' | 'VAT_VIES_VALIDATION' | 'SUBCONTRACTOR_WASTE_LICENSE' | 'WASTE_PERMIT_GREEN_EU' | 'WASTE_PERMIT_ORANGE_EU' | 'WASTE_PERMIT_ORANGE_GREEN_EU' | 'XL_CERTIFICATE'
      - 'DOMESTIC_CARGO_INSURANCE' | 'SUBCONTRACTOR_INSURANCE' | 'INSURANCE_3RD_PARTY_TRAILER' | 'CARGO_INSURANCE' | 'SUBCONTRACTOR_LIABILITY_INSURANCE' | 'SUBCONTRACTOR_MOTOR_INSURANCE'
      - 'AUTHORIZATION_PREFERENTIAL_ORIGIN' | 'BANK_DETAILS' | 'CMR_INSURANCE' | 'COMMUNICATION' | 'COMPANY_TDS' | 'CREDIT_REPORT' | 'DGSA_CERTIFICATE' | 'ECMT_TRANSPORT_LICENSE' | 'EU_TRANSPORT_LICENSE' | 'FREIGHT_FORWARDER_LICENSE' | 'INSURANCE_3RD_PARTY_TRAILER' | 'MEETING_SUMMARY' | 'NATIONAL_TRANSPORT_LICENSE' | 'OTHER' | 'QUESTIONNAIRE_CUSTOMER' | 'QUESTIONNAIRE_SUBCONTRACTOR' | 'SERVICE_LEVEL_AGREEMENT' | 'SQAS_CERTIFICATE' | 'TRAILER_CLEANING_CERTIFICATE' | 'VAT_VIES_VALIDATION' | 'WASTE_PERMIT_GREEN_EU' | 'WASTE_PERMIT_ORANGE_EU' | 'WASTE_PERMIT_ORANGE_GREEN_EU'
      - 'ATA_CARNET' | 'BANK_DETAILS' | 'CARGO_INSURANCE' | 'CMR_INSURANCE' | 'COMMON_HEALTH_ENTRY_DOCUMENT' | 'COMMUNICATION_SUBCONTRACTOR' | 'COMMUNICATION' | 'COMPANY_TDS' | 'CREDIT_REPORT' | 'DGSA_CERTIFICATE' | 'DOMESTIC_CARGO_INSURANCE' | 'ECMT_TRANSPORT_LICENSE' | 'EU_TRANSPORT_LICENSE' | 'EXPORT_HEALTH_CERTIFICATE' | 'FINE' | 'FREIGHT_FORWARDER_LICENSE' | 'INSURANCE_3RD_PARTY_TRAILER' | 'NATIONAL_TRANSPORT_LICENSE' | 'OTHER' | 'POWER_OF_ATTORNEY' | 'QUESTIONNAIRE_CUSTOMER' | 'QUESTIONNAIRE_SUBCONTRACTOR' | 'SERVICE_LEVEL_AGREEMENT' | 'SQAS_CERTIFICATE' | 'SUBCONTRACTOR_CONTRACT' | 'SUBCONTRACTOR_INSURANCE' | 'SUBCONTRACTOR_LIABILITY_INSURANCE' | 'SUBCONTRACTOR_LICENSE' | 'SUBCONTRACTOR_MOTOR_INSURANCE' | 'SUBCONTRACTOR_PERMIT' | 'SUBCONTRACTOR_WASTE_LICENSE' | 'TRAILER_CLEANING_CERTIFICATE' | 'VAT_VIES_VALIDATION' | 'WASTE_PERMIT_GREEN_EU' | 'WASTE_PERMIT_ORANGE_EU' | 'WASTE_PERMIT_ORANGE_GREEN_EU' | 'XL_CERTIFICATE'
    - `download_url` string: Relative URL from the base URL to download the document
    - `subject_type` string, required: Linked subject of the document
    - `content_type` string, nullable: Content type of the document
    - `validity` CompanyValidityOutput
      - `start_time` string, date-time, required: Start time of the validity
      - `end_time` string, date-time, nullable: End time of the validity from a planning perspective
      - `legal_end_time` string, date-time, nullable: End time of the validity from a legal perspective
      - `generate_unavailability` boolean: Generate a planning unavailability once the validity end time has passed
      - `type` 'ATA_CARNET' | 'BANK_DETAILS' | 'CMR_INSURANCE' | 'COMMON_HEALTH_ENTRY_DOCUMENT' | 'COMMUNICATION' | 'COMMUNICATION_SUBCONTRACTOR' | 'SUBCONTRACTOR_CONTRACT' | 'CREDIT_REPORT' | 'DGSA_CERTIFICATE' | 'ECMT_TRANSPORT_LICENSE' | 'EU_TRANSPORT_LICENSE' | 'EXPORT_HEALTH_CERTIFICATE' | 'FINE' | 'FREIGHT_FORWARDER_LICENSE' | 'SUBCONTRACTOR_LICENSE' | 'NATIONAL_TRANSPORT_LICENSE' | 'SUBCONTRACTOR_OTHER' | 'SUBCONTRACTOR_PERMIT' | 'POWER_OF_ATTORNEY' | 'QUESTIONNAIRE_CUSTOMER' | 'QUESTIONNAIRE_SUBCONTRACTOR' | 'SERVICE_LEVEL_AGREEMENT' | 'SQAS_CERTIFICATE' | 'COMPANY_TDS' | 'TRAILER_CLEANING_CERTIFICATE' | 'VAT_VIES_VALIDATION' | 'SUBCONTRACTOR_WASTE_LICENSE' | 'WASTE_PERMIT_GREEN_EU' | 'WASTE_PERMIT_ORANGE_EU' | 'WASTE_PERMIT_ORANGE_GREEN_EU' | 'XL_CERTIFICATE' | 'DOMESTIC_CARGO_INSURANCE' | 'SUBCONTRACTOR_INSURANCE' | 'INSURANCE_3RD_PARTY_TRAILER' | 'CARGO_INSURANCE' | 'SUBCONTRACTOR_LIABILITY_INSURANCE' | 'SUBCONTRACTOR_MOTOR_INSURANCE', required
      - `external_id` string, nullable: ID of the validity in the external master data system
      - `description` string, nullable
      - `id` string, uuid, required: Unique identifier of the validity

## Other responses

- `400`: Bad Request — invalid input or malformed request
- `401`: Unauthorized — missing or invalid authentication credentials
- `403`: Forbidden — insufficient permissions for this operation
- `422`: Validation Error
- `429`: Too Many Requests — rate limit exceeded. See the `Retry-After` header
- `500`: Internal Server Error
- `503`: Service Unavailable — temporarily unable to handle the request

## Changes

- **2026-09-25** `6abdfcd1a541`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/qargo/apis/qargo-tms-api/changes/v1/companies/company/:company_id/documents/get.md)

---

[API](https://skmtc.dev/qargo/apis/qargo-tms-api.md) · [All operations](https://skmtc.dev/qargo/apis/qargo-tms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qargo/apis/qargo-tms-api/revisions/46db2c329351?raw)