---
title: "List businesses"
method: GET
path: "/v1/platform/businesses/"
tags: ["Business Management"]
---

# List businesses

`GET /v1/platform/businesses/`

## Request

- Base URL: `https://docs.thredfi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.thredfi.com/v1/platform/businesses/`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP basic
  - HTTP bearer
  - HTTP bearer

Returns a list of all active businesses registered in our platform by the partner with standardized pagination.

        **Supported Countries**: EU/UK, Nordic, and APAC markets
        - EU/UK/Nordic: GB, DE, FR, NL, ES, IT, IE, BE, AT, PT, SE, NO, DK, FI, IS
        - APAC: MY, SG

        **Supported Currencies**: GBP, EUR, USD, SEK, NOK, DKK, ISK, MYR, SGD

## Query parameters

- `country` string
- `entity_type` string
- `is_archived` boolean
- `legal_name` string
- `page` integer
- `page_size` integer
- `search` string

## Response `200`

- PaginatedBusinessListList
  - `count` integer, required: Total number of items
  - `page_info` object, required
    - `total_count` integer, required: Total number of items (same as count)
    - `current_page` integer, required: Current page number (1-indexed)
    - `total_pages` integer, required: Total number of pages
    - `page_size` integer, required: Number of items per page
  - `results` BusinessList[], required
    - `id` string, uuid, required: Unique identifier for the business
    - `external_id` string, required: Your unique identifier for this business
    - `name` string, required: Display name for the business
    - `legal_name` string, required: Legal registered name of the business
    - `entity_type` string, required: Business entity type (e.g., 'limited', 'gmbh', 'bv')
    - `country` string, required: ISO 3166-1 alpha-2 country code
    - `province` string, required: Province or state within the country
    - `eu_nace_industry_code` string, required: European NACE industry classification code
    - `is_active` boolean, required: Whether the business is active (false if archived)
    - `activation_at` string, date-time, required: Date and time when the business was activated
    - `created_at` string, date-time, required: Date and time when the business was created
    - `updated_at` string, date-time, required: Date and time when the business was last updated
    - `vat_number` string, required: EU VAT registration number
    - `company_number` string, required: Company registration number (e.g., Companies House number for UK)
    - `tax_id` string, required: Tax identification number (other than VAT)
    - `base_currency` string, required: Base currency for accounting (ISO 4217 code)

---

[API](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api.md) - [All operations](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thredfi/apis/thredfi-accounting-platform-api/revisions/0c1918254db3?raw)