---
title: "Find companies"
method: GET
path: "/companies"
tags: ["Company"]
---

# Find companies

`GET /companies`

# Find companies by query filters.
>* Retrieve companies based on query parameters.
>>* Recuperar empresas com base em parâmetros de consulta.

## Query parameters

- `company_type` string
- `email` string
- `name` string
- `tax_number` string
- `phone` string
- `trade_name` string
- `created_greater_or_equal_than` string
- `created_less_or_equal_than` string
- `user_id` integer
- `limit` integer
- `page` integer

## Response `200`

List of users matching the filters | Lista de usuários que correspondem aos filtros

- DomainCompanyFindResponse
  - `limit` integer
  - `page` integer
  - `rows` DomainCompanyResponse[]
    - `bank` string, required
    - `bank_account` string, required
    - `bank_account_digit` string, required
    - `bank_account_type` string, required
    - `bank_branch` string, required
    - `business_type` string
    - `company_type` 'INVESTOR' | 'ACQUIRER' | 'MODERATOR', required
    - `created_at` string
    - `email` string, required
    - `id` integer
    - `legal_nature` string
    - `name` string, required
    - `phone` string, required
    - `receivables_expiration_days` integer
    - `tax_number` string, required
    - `trade_name` string
    - `updated_at` string
  - `sort` string
  - `total_pages` integer
  - `total_rows` integer

## Other responses

- `400` — Validation error in the query parameters | Erro de validação nos parâmetros de consulta
- `401` — Unauthorized | Não autorizado
- `500` — General errors, internal server error, etc... | Erros gerais, erro interno do servidor, etc...

---

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