---
title: "List all companies"
method: GET
path: "/v1/companies"
tags: ["Companies/Entities"]
---

# List all companies

`GET /v1/companies`

## Query parameters

- `id` union
  - string
  - string[]
- `type` 'INDIVIDUAL' | 'BUSINESS' | 'MANAGING_BUSINESS' | 'LP_INDIVIDUAL' | 'LP_BUSINESS'

## Response `200`

Get companies

- object
  - `data` Company[]
    - `id` string
    - `name` string
    - `type` 'INDIVIDUAL' | 'BUSINESS' | 'MANAGING_BUSINESS' | 'LP_INDIVIDUAL' | 'LP_BUSINESS'
    - `status` 'ACTIVE' | 'RESTRICTED' | 'DENIED'
    - `kyb_status` 'NOT_REQUIRED' | 'NOT_STARTED' | 'PENDING' | 'SUCCESS' | 'FAIL' | 'ERROR' | 'PROCESSING'
    - `legal_business_name` string, nullable
    - `business_tax_id` string, nullable
    - `website` string, nullable
    - `phone` string, nullable
    - `address_id` integer, nullable
    - `sandbox` boolean — Sandbox mode
    - `formation_date` string, nullable
    - `kyb_mode` 'FULL' | 'NONE' | 'LITE'
    - `duns` string, nullable
    - `stock_symbol` string, nullable
    - `country` string, nullable — Country where the company is based
    - `enabled` boolean
    - `credit_verification_status` 'FAIL' | 'PENDING' | 'SUCCESS'
    - `credit_limit` integer, nullable
    - `credit_rating` string, nullable
    - `invoice_reply_to_email` string, nullable
    - `po_reply_to_email` string, nullable
    - `birthday` string, date-time, nullable — Birthday of user. Only applies to individual type
    - `logo_url` string — URL of company logo
    - `invite_image_url` string
    - `header_image_url` string
    - `square_image_url` string
    - `terms_url` string
    - `privacy_url` string
    - `credit_used` integer

---

[API](https://skmtc.net/newmoneycompany/apis/new-money-company-api.md) · [All operations](https://skmtc.net/newmoneycompany/apis/new-money-company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/newmoneycompany/new-money-company-api/revisions/669cac9303c2/schema)