---
title: "Get Company 🌍"
method: GET
path: "/companies/{companyId}"
tags: ["Company"]
---

# Get Company 🌍

`GET /companies/{companyId}`

Returns the basic information of the company.
\
**Required scopes**: None

## Path parameters

- `companyId` string, required

## Response `200`

The fetched company

- object
  - `id` string, required — Id of the company.
  - `name` string, required — Name of the company.
  - `country` 'FR' | 'ES' | 'GB', required — Country of the company.
  - `identificationNumber` string, required — Identification number of the company (e.g. SIRET for France, CIF for Spain, ...).
  - `address` string, required — The company's address
  - `city` string, required — The city of the company
  - `postalCode` string, required — The postal code of the company
  - `nbActiveContracts` integer, required — Number of current active contracts within the company.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

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