---
title: "List Companies"
method: GET
path: "/v1/companies/company"
tags: ["API / Company", "Use case / Master data sync"]
---

# List Companies

`GET /v1/companies/company`

## Request

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

## Query parameters

- `cursor` string, nullable
- `updated_after` string, date-time, nullable
- `code` string, nullable
- `code:in` string, nullable
- `accounting_customer_code` string, nullable
- `accounting_customer_code:in` string, nullable

## Response `200`

Successful Response

- ListCompanyOutput
  - `next_cursor` string, nullable
  - `items` CompanyDetailOutput[], required
    - `id` string, uuid, required: The unique identifier of the company.
    - `code` string, nullable: External reference to this company record
    - `currency` string, required: Currency of the company (ISO 4217, 3 letter code)
    - `custom_fields` object, nullable: Custom fields of the company
    - `is_customer` boolean: Indicate that this company is a customer
    - `is_subcontractor` boolean: Indicate that this company is a subcontractor (supplier)
    - `is_buyer_or_seller` boolean, nullable: Indicates that this company is a buyer or seller of a consignment
    - `name` string, required: Name of the company.
    - `legal_name` string, nullable: Legal name of the company.
    - `vat_number` string, nullable: VAT number of the company.
    - `note` string, nullable: Additional notes about the company
    - `tax_type` 'VAT' | 'REVERSE_CHARGE' | 'UK_REVERSE_CHARGE' | 'TRANSIT' | 'NO_VAT' | 'CO_CONTRACTING' | 'OTHER'
    - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED'
    - `accounting_code` string, nullable: Default customer accounting code linked to the accounting system. Please use the accounting codes on the billing entities, as these are split per billing entity and between sales/purchase sides.
    - `billing_location` LocationOutput
      - `code` string, nullable: Technical code for integrations/mapping logic; should be treated as stable once set.
      - `display_name` string, nullable: Human-readable label for a location in operational views.
      - `external_id` string, nullable: Identifier from an external (master data) system.
      - `address` string, nullable: First address line of the location
      - `address_second_line` string, nullable: Second address line of the location
      - `city` string, nullable: City of the location
      - `state` string, nullable: State of the location
      - `country` string, nullable: Country code (ISO 3166-1 alpha-2) of the location
      - `postal_code` string, nullable: Postal code of the location
      - `name` string, nullable: Name of the location
      - `id` string, uuid, nullable: Unique identifier of the location
      - `latitude` number, nullable: Latitude of the location
      - `longitude` number, nullable: Longitude of the location
    - `payment_term` BasePaymentTerm
      - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required
    - `locale` string, required: Locale of the company. Format: ISO 639-1 language code, optionally followed by a dash and ISO 3166-1 alpha-2 country code.
    - `archived_customer` boolean, required: Indicate that this company is archived as a customer
    - `archived_subcontractor` boolean, required: Indicate that this company is archived as a subcontractor
    - `archived_buyer_or_seller` boolean, required: Indicates that this company is archived as buyer/seller of a consignment
    - `credit_policy` CreditPolicyOutput
      - `limit` number, nullable: The limit for total amount that has been invoiced but not paid.
    - `default_invoice_customer` ApiAccountingModelsCompanyCompanyReferenceOutput
      - `id` string, uuid, required: The unique identifier of the company.
      - `name` string, required: Name of the company.
      - `code` string, nullable: External reference to this company record
    - `reference_numbers` CompanyReferenceNumbers
      - `eori_number` string, nullable: Economic Operator Registration and Identification
      - `duns_number` string, nullable: D-U-N-S Number
      - `scac_code` string, nullable: Standard Carrier Alpha Code
      - `company_registration_number` string, nullable: Company Registration Number
      - `tss_registration_number` string, nullable: TSS registration number
    - `bank_accounts` BankAccount[]: List of associated bank accounts.
      - `bic_code` string, nullable
      - `iban_code` string, nullable
    - `contacts` CompanyContactOutput[], nullable: List of contacts associated with the company
      - `id` string, uuid, nullable: Unique identifier of the contact
      - `roles` ContactType[]: List of roles associated with the contact.
      - `name` string, nullable: Name of the contact person associated with the company.
      - `note` string, nullable: Additional notes about the contact person.
      - `email` string, nullable: Email address of the contact person.
      - `phone_number` string, nullable: Phone number of the contact person.
    - `sales` SalesCompanyFieldsOutput
      - `payment_term` BasePaymentTerm
        - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required
      - `billing_entities` CompanyBillingEntity[], nullable: List of billing entities associated with the company
        - `id` string, uuid, nullable: Unique identifier of the billing entity associated with the company.
        - `code` string, nullable: Code of the billing entity associated with the company.
        - `accounting_code` string, nullable: Accounting code linked to the billing entity for the company.
      - `status` 'PROSPECT' | 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED'
    - `purchase` PurchaseCompanyFieldsOutput
      - `payment_term` BasePaymentTerm
        - `code` 'END_OF_MONTH_2' | 'END_OF_MONTH_1' | 'END_OF_MONTH_0_NET_90' | 'END_OF_MONTH_0_NET_75' | 'END_OF_MONTH_0_NET_70' | 'END_OF_MONTH_0_NET_65' | 'END_OF_MONTH_0_NET_60' | 'END_OF_MONTH_0_NET_50' | 'END_OF_MONTH_0_NET_45' | 'END_OF_MONTH_0_NET_35' | 'END_OF_MONTH_0_NET_31' | 'END_OF_MONTH_0_NET_30' | 'END_OF_MONTH_0_NET_25' | 'END_OF_MONTH_0_NET_21' | 'END_OF_MONTH_0_NET_20' | 'END_OF_MONTH_0_NET_14' | 'END_OF_MONTH_0_NET_7' | 'END_OF_MONTH_0_NET_1' | 'END_OF_MONTH_0' | 'PREPAID' | 'CUSTOM_DUE_DATE' | 'UPON_RECEIPT' | 'NET_1' | 'NET_2' | 'NET_3' | 'NET_5' | 'NET_7' | 'NET_8' | 'NET_10' | 'NET_12' | 'NET_14' | 'NET_15' | 'NET_20' | 'NET_21' | 'NET_28' | 'NET_30' | 'NET_35' | 'NET_40' | 'NET_42' | 'NET_45' | 'NET_48' | 'NET_49' | 'NET_50' | 'NET_52' | 'NET_55' | 'NET_56' | 'NET_60' | 'NET_63' | 'NET_70' | 'NET_75' | 'NET_77' | 'NET_80' | 'NET_84' | 'NET_90' | 'NET_91' | 'NET_98' | 'NET_120', required
      - `billing_entities` CompanyBillingEntity[], nullable: List of billing entities associated with the company
        - `id` string, uuid, nullable: Unique identifier of the billing entity associated with the company.
        - `code` string, nullable: Code of the billing entity associated with the company.
        - `accounting_code` string, nullable: Accounting code linked to the billing entity for the company.
      - `status` 'NOT_APPROVED' | 'APPROVED' | 'WARNING' | 'BLOCKED'
    - `timestamp_updated` string, date-time, required: The date and time when the company was last updated.
    - `is_blocked` boolean: Set to true to disallow new order creation for companies representing companies. **Note**: Deprecated in favor of `status`.
    - `credit_limit_total` number, nullable: The limit for total amount that has been invoiced but not paid. **Deprecated**: use `credit_policy.limit` instead.

## 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-28** `cf0a203f13f4`: 1 warning
  - added the new `UK_REVERSE_CHARGE` enum value to the `items/items/tax_type/anyOf[subschema #1: TaxTypeEnum]/` response property for the response status `200`
- **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/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)