---
title: "Show a company"
method: GET
path: "/v1/companies/{company_id}"
tags: ["Company Management"]
---

# Show a company

`GET /v1/companies/{company_id}`

Given an ID, shows a company.

If the used access token was issued by the OAuth 2.0 Authorization Code flow,
then only the associated company can be accessed through the endpoint.


## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage company resources (`company_admin`) | View companies (`company:read`) | Manage companies (`company:write`) |

## Path parameters

- `company_id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Success

- CompanyResponse — Shows a company
  - `data` object, required
    - `company` Company
      - `address_details` object, required — Fields can vary depending on the country. Please, check the required fields structure using the [Show form schema endpoint](#operation/get_show_form_country). Use the desired country and `address_details` as the form name for the placeholders. The response complies with the [JSON Schema](https://developer.remote.com/docs/how-json-schemas-work) specification.
      - `bank_account_details` object — Fields can vary depending on the country. Please, check the required fields structure using the [Show form schema endpoint](#operation/get_show_form_country). Use the desired country and `bank_account_details` as the form name for the placeholders. The response complies with the [JSON Schema](https://developer.remote.com/docs/how-json-schemas-work) specification.
      - `company_owner_email` string, email, required — The email address of the company owner who administers the Remote account.
      - `company_owner_name` string — The full name of the company owner. Cannot be changed after company creation.
      - `company_owner_user_id` string, required — The unique identifier (UUID) of the company owner's user account on Remote.
      - `country_code` string, required — The ISO 3166-1 3-letter country code where the company is registered.
      - `created_at` string, date-time, required — The timestamp when the company was created on Remote.
      - `default_legal_entity_credit_risk_status` 'not_started' | 'ready' | 'in_progress' | 'referred' | 'fail' | 'deposit_required' | 'no_deposit_required', required — The credit risk status of the company default legal entity. - `not_started`: The credit risk assessment has not started yet. - `ready`: The credit risk assessment is ready to be started. - `in_progress`: The automated credit risk assessment is in progress. - `referred`: The credit risk assessment has been referred to a human reviewer. - `fail`: The credit risk assessment has failed and the company will be archived. - `deposit_required`: The company default legal entity requires a deposit before onboarding new employees. - `no_deposit_required`: The company default legal entity does not require a deposit before onboarding new employees.
      - `desired_currency` string, required — The ISO 4217 currency code the company prefers for billing and invoicing (e.g., "USD", "EUR").
      - `external_id` string, nullable — A unique reference code for this company in a non-Remote system. Null if not set.
      - `id` string, required — The unique identifier (UUID) of the company.
      - `name` string, required — The company's registered name. Can only be changed while the company is in `pending` status.
      - `phone_number` string — The company's contact phone number.
      - `registration_number` string, nullable — The company's business registration number. Null if not provided. Can only be set while the company is in `pending` status.
      - `status` 'pending' | 'review' | 'active' | 'archived', required — The company status determines what a company is allowed to do: - `pending`: The company has been created and the company owner invited. Remote is waiting for the company owner to complete onboarding. - `review`: The company is under review. In rare occasions, a company may not automatically get created in `active` status because Remote needs to manually review the company that was created. The company will become `active` once the review is completed and no further action is necessary through the Remote API. - `active`: The company owner has completed onboarding and the company is ready to employ. - `archived`: The company is no longer active on the Remote platform and no changes can be made to the company.
      - `tax_number` string, nullable — The company's tax identification number. Null if not provided. Can only be set while the company is in `pending` status.
      - `terms_of_service_accepted_at` string, date-time, required — The timestamp when the company owner accepted Remote's Terms of Service.
      - `updated_at` string, date-time, required — The timestamp when the company record was last updated.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too many requests

---

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