Listar empresas de um cliente

GET

/api/v2/cliente-empresas/by-cliente/{idCliente}

Devolve os vínculos do cliente, principal primeiro, depois por data de
criação. Inclui vínculos inativos (ativo: false); vínculos excluídos não
aparecem. Cada item já traz principal calculado e os dados básicos da
empresa.

Requisição

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200OK

application/json

Vínculos do cliente (lista vazia se não houver).

Bodyapplication/json

🟠400Pedido Inválido

🟠401Não Autorizado

🟠404Registo Não Encontrado

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v2/cliente-empresas/by-cliente/4520' \
--header 'api-key: {{api-key}}'

Response Example

200 - Cliente com principal e uma secundária

{
    "ok": true,
    "data": [
        {
            "id": 31,
            "id_cliente": 4520,
            "id_empresa": 12,
            "tipo_de_relacionamento": "consultor",
            "ativo": true,
            "principal": true,
            "empresa_razao_social": "Beta Consultoria SA",
            "empresa_nome_fantasia": "Beta Consult",
            "empresa_cnpj": "44555666000102",
            "empresa_ativo": true,
            "created_by": 9800,
            "updated_by": null,
            "criado_em": "2026-10-27T10:12:00-03:00",
            "alterado_em": null,
            "deleted_at": null
        },
        {
            "id": 7,
            "id_cliente": 4520,
            "id_empresa": 3,
            "tipo_de_relacionamento": "nao_informado",
            "ativo": true,
            "principal": false,
            "empresa_razao_social": "Zeta Tecnologia Ltda",
            "empresa_nome_fantasia": "Zeta Tech",
            "empresa_cnpj": "11222333000101",
            "empresa_ativo": true,
            "created_by": null,
            "updated_by": null,
            "criado_em": "2026-03-02T09:00:00-03:00",
            "alterado_em": null,
            "deleted_at": null
        }
    ]
}

Modificado em 2026-11-04 02:31:07

Página anterior

Listar tipos de relacionamento

Próxima página

Vincular empresa ao cliente