---
title: "List Organizations"
method: GET
path: "/v3/organizations"
tags: ["Organizações"]
---

# List Organizations

`GET /v3/organizations`

Listar organizações paginadas, com busca por nome, razão social, CNPJ ou ID

## Query parameters

- `search` string
- `operatorId` string
- `segment` string
- `ids` string
- `deleted` boolean

## Response `200`

- object
  - `totalCount` number — Total de registros
  - `data` Organization[]
    - `id` string, required
    - `workspaceId` string, required
    - `name` string, required — Nome da organização / nome fantasia
    - `legalName` string, nullable — Razão social
    - `avatar` string, nullable — Logo da organização (arquivo enviado pelo upload do Kinbox)
    - `cnpj` string, nullable — CNPJ (salvo sem pontuação)
    - `website` string, nullable — Site da organização
    - `domain` string, nullable — Domínio normalizado, derivado automaticamente do site
    - `phone` string, nullable — Telefone da organização
    - `email` string, nullable — E-mail da organização
    - `address` OrganizationAddress
      - `street` string
      - `number` string
      - `complement` string
      - `district` string
      - `city` string
      - `state` string
      - `zip` string
      - `country` string
    - `segment` string, nullable — Segmento / setor de atuação
    - `operatorId` string — ID do usuário responsável pela organização
    - `description` string, nullable — Descrição / observações
    - `customFields` object, nullable — Campos personalizados no formato { placeholder: { value } }
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `deletedAt` string, date-time, nullable — Preenchido quando a organização foi excluída (exclusão lógica)
    - `contactsCount` number — Quantidade de contatos vinculados

## Changes

- **2026-10-01** `c083bbfe8973` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kinbox/apis/kinbox-api/changes/v3/organizations/get.md)

---

[API](https://skmtc.dev/kinbox/apis/kinbox-api.md) · [All operations](https://skmtc.dev/kinbox/apis/kinbox-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kinbox/apis/kinbox-api/revisions/c083bbfe8973?raw)