---
title: "Get a company"
method: GET
path: "/rateplan/v0-nsfw/companies/{id}"
tags: ["Company"]
---

# Get a company

`GET /rateplan/v0-nsfw/companies/{id}`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/rateplan/v0-nsfw/companies/{id}`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `companies.read`, `companies.manage`, `admin`

Get a company by ID.<br>You must have at least one of these scopes: 'companies.read, companies.manage'.<br>For fine-grained clients, you must have this permission: 'core.companies.read'.

## Path parameters

- `id` string, required

## Query parameters

- `expand` string[]

## Response `200`

Success.

- CompanyModel: The unstable (v0-nsfw) variant of Apaleo.Api.Modules.RatePlan.Models.Companies.CompanyModel. It additionally exposes structured company identifiers.
  - `identifiers` CompanyIdentifierModel[], nullable: Structured company identifiers. Only returned when requested via expand=identifiers.
    - `scheme` string, required: The identifier scheme (must exist in the company identifier-scheme registry).
    - `value` string, required: The identifier value for the scheme.
  - `type` 'CorporateClient' | 'TravelAgency' | 'GovernmentBuyer', nullable: The company type.
  - `id` string, required: The ID of this company
  - `code` string, required: The code for the company
  - `propertyId` string, required: The ID of the property
  - `name` string, required: The name of the company
  - `invoicingEmail` string, nullable: The email address for invoicing purposes
  - `phone` string, nullable: The company's phone number
  - `taxId` string, nullable: The tax ID of the company
  - `additionalTaxId` string, nullable: The additional tax ID of the company (e.g. SIRET in France, Codice Destinatario in Italy, SST in Malaysia)
  - `additionalTaxId2` string, nullable: The additional tax ID of the company (e.g. Codice Fiscale in Italy, BRN in Malaysia)
  - `invoiceNetworkIdentity` InvoiceNetworkIdentityModel
    - `network` 'Peppol', required: The Network through which to send the Invoice e. g. Peppol
    - `id` string, required: The Id of the company at the network. e.g. "0208:123456789"
  - `address` CompanyAddressModel, required
    - `addressLine1` string, required
    - `addressLine2` string, nullable
    - `postalCode` string, required
    - `city` string, required
    - `regionCode` string, nullable
    - `countryCode` string, required
  - `canCheckOutOnAr` boolean, required: Whether or not the company is allowed to check out on AR / invoice
  - `ratePlans` RatePlanCompanyModel[], nullable: Rate plans that can be booked by this company
    - `id` string, required: Rate plan ID that is used by this company
    - `code` string, required: Rate plan code that is used by this company
    - `corporateCode` string, nullable: Company rate plan code, identifying the company + rate plan pair. Is used is offers.
    - `name` string, required: The name of the rate plan

## Other responses

- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

---

[API](https://skmtc.dev/apaleo/apis/apaleo-rate-plan-api-not-safe-for-work.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-rate-plan-api-not-safe-for-work/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-rate-plan-api-not-safe-for-work/revisions/97dec9512a17?raw)