---
title: "Retrieve a company"
method: GET
path: "/v1/companies/{id}"
tags: ["Company"]
---

# Retrieve a company

`GET /v1/companies/{id}`

Returns a single company by id, including its members, related people,
custom columns and collector account. The company must be one the
authenticated user belongs to (Cardda staff can read any).

The `balance_cents` and `wallets` attributes (and the computed `balance` /
`total_allocated_funds`) are returned only to users with the balance
permission; other members receive the company without them. User attachment
URLs are included only for users allowed to view them (admins or
`companies_manage`).

## Path parameters

- `id` string, required

## Parameters

- `#/paths/~1v1~1users/get/parameters/0` — unresolved $ref

## Response `200`

The requested company.

- Company — A company (tenant / organization). Companies are Single-Table-Inheritance subclasses of `Person`, so the payload carries generic Person columns plus company-specific attributes. Internal financial and commission columns (`balance_cents`, `wallets`, `credit`, `commission*`, `amount_per_*`, `max_amount_commission_*`, `balance_threshold`, `cost_center`, `stp_name`, ...) and computed methods such as `balance` / `total_allocated_funds` are **not part of the documented public contract** and are intentionally omitted here. The fields documented below are the supported company shape.
  - `id` string, uuid, required
  - `type` string — STI subclass. Always `Company` for this resource.
  - `identifier` string, required — Tax id (RUT in Chile) of the company. Digits plus verification digit.
  - `name` string, nullable
  - `fantasy_name` string, nullable
  - `country` string, nullable
  - `commercial_business` string, nullable
  - `commercial_type` integer, nullable
  - `address` string, nullable
  - `contact_phone` string, nullable
  - `contact_email` string, nullable
  - `constitution_date` string, date-time, nullable
  - `purpose_to_use_cards` string, nullable
  - `legal_address` object, nullable — Structured legal address (`street`, `number`, `municipality_id`, `complement`, `city`).
  - `economic_activities` object[], nullable
  - `interests` string[]
  - `notification_emails` string[]
  - `ruts` object, nullable — Additional RUTs associated with the company.
  - `referral_code` string
  - `referrer_id` string, uuid, nullable
  - `referral_approved` boolean, nullable
  - `collector_account_id` string, uuid, nullable
  - `preferred_currency` string
  - `verification_status` 'pending' | 'awaiting_review' | 'approved' | 'rejected' — KYC verification status.
  - `kyc_completed` boolean
  - `plh_enabled` boolean — Whether the company is enrolled in the PLH card program.
  - `contracts_verified` boolean
  - `activated` boolean
  - `active` boolean
  - `can_delegate_payables` boolean
  - `n_users` integer — Number of member users (computed method).
  - `n_cards` integer — Number of cards (computed method).
  - `n_virtual_cards` integer — Number of virtual cards (computed method).
  - `owner_id` string, uuid, nullable — User id of the owner membership (present on the index listing).
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized
- `404` — Company not found

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) · [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cardda/banking-api/revisions/ff1aeb3fda8b/schema)