---
title: "List companies"
method: GET
path: "/api/external/firm/v1/companies"
tags: ["Companies"]
---

# List companies

`GET /api/external/firm/v1/companies`

This endpoint returns a list of companies related to the firm.

> ℹ️
> This endpoint requires the following scope: `companies:readonly`

## Query parameters

- `page` integer
- `per_page` integer
- `filter` string

## Response `200`

Returns a list of companies related to the firm the access token is associated with.

- object
  - `items` object[], required
    - `id` integer, required — Company's unique identifier
    - `name` string, required — Company's legal name.
    - `billing_company_name` string, required — Company's trade name.
    - `siren` string, required — Company's SIREN
    - `address` string, required — The number and street address of the company.
    - `city` string, required — The city the company is in.
    - `postal_code` string, required — The postal/zip code of the company.
    - `activity_nomenclature` string, required — The activity nomenclature code, e.g. "code NAF" in France.
    - `activity_code` string, required — The activity code.
    - `external_id` string, required — The external identifier of the company.
    - `client_code` string, required — Client code of the company
  - `total_pages` integer, required — The total number of pages available
  - `current_page` integer, required — The current page returned
  - `total_items` integer, required — The total number of items available
  - `per_page` integer, required — The number of items per page

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `403` — Access to this resource forbidden
- `404` — The resource was not found

---

[API](https://skmtc.net/pennylane/apis/referentials.md) · [All operations](https://skmtc.net/pennylane/apis/referentials/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pennylane/referentials/revisions/b1a25027650f/schema)