---
title: "List Companies"
method: GET
path: "/company/"
tags: ["Onboarding"]
---

# List Companies

`GET /company/`

Retrieve a list of companies and child companies.

## Query parameters

- `idempotency_key` string — Idempotency key
- `limit` integer
- `cursor` string

## Headers

- `x-company-id` integer — ID of a child company for authentication. If not provided, the parent company will be authenticated.

## Response `200`

Successful Response

- CompanyListResponse
  - `next_cursor` string
  - `has_more` boolean
  - `status` 'success'
  - `data` ShowableCompany[], required
    - `id` string, required — Company ID
    - `idempotency_key` string — A unique key that ensures a request is processed only once. If the same key is sent with multiple requests, the server returns the original response instead of performing the action again.
    - `created_at` string, date-time — Creation date of the company
    - `business_name` string — Business legal name
    - `friendly_name` string — Business friendly name (trading name)
    - `country_of_registration` string — Country of registration in ISO 3166-1 alpha-2 format, e.g. AR, BR, etc.
    - `registration_number` string — Registration number, e.g. CNPJ, VAT number, etc.
    - `entity_type` string — Entity type, e.g. LLC, INC, etc.
    - `acc_default_webhook_url` string — Account default webhook URL. All the accounts created for this company will have this webhook url by default
    - `parent_company_id` string — Parent company ID

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `500` — Internal Server Error

---

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