# API de Clientes

> Referência dos 16 endpoints de Clientes na API pública do Comando1: método, caminho, o que faz e os escopos exigidos.

Fonte: https://comando.one/docs/clientes · Atualizado em 2026-09-12 · Comando.One (ORBITAL TECNOLOGIA E DESENVOLVIMENTO LTDA, CNPJ 29.383.276/0001-88)

---

[Documentação da API](https://comando.one/docs)

# API de Clientes

Gerenciamento de clientes e contatos

16 endpoints · base `https://api.comando.one/v1` · autenticação por chave `cmd_live_…`

GET `/customers`

Listar clientes

`customers:read`

POST `/customers`

Criar cliente

`customers:write`

DELETE `/customers/{id}`

Excluir cliente

`customers:delete`

GET `/customers/{id}`

Obter cliente

`customers:read`

PATCH `/customers/{id}`

Atualizar cliente

`customers:write`

GET `/customers/{id}/addresses`

Listar endereços do cliente

`customers:read`

POST `/customers/{id}/addresses`

Adicionar endereço

`customers:write`

DELETE `/customers/{id}/addresses/{addressId}`

Excluir endereço

`customers:delete`

PATCH `/customers/{id}/addresses/{addressId}`

Atualizar endereço

`customers:write`

GET `/customers/{id}/contacts`

Listar contatos do cliente

`customers:read`

POST `/customers/{id}/contacts`

Adicionar contato

`customers:write`

DELETE `/customers/{id}/contacts/{contactId}`

Excluir contato

`customers:delete`

PATCH `/customers/{id}/contacts/{contactId}`

Atualizar contato

`customers:write`

GET `/customers/{id}/contracts`

Contratos do cliente

`customers:read``contracts:read`

GET `/customers/{id}/invoices`

Faturas do cliente

`customers:read``invoices:read`

GET `/customers/{id}/proposals`

Propostas do cliente

`customers:read``proposals:read`

Início rápido, autenticação, SDK, servidor MCP e o playground para testar sem escrever código estão na [documentação completa](https://comando.one/docs). A especificação em OpenAPI está em [api.comando.one/openapi.json](https://api.comando.one/openapi.json).

## Outros recursos da API

[Contratos (13)](https://comando.one/docs/contratos)[Faturas (12)](https://comando.one/docs/faturas)[Webhooks (12)](https://comando.one/docs/webhooks)[Serviços (9)](https://comando.one/docs/servicos)[Split de Pagamentos (9)](https://comando.one/docs/split-de-pagamentos)[Catálogos (7)](https://comando.one/docs/catalogos)[Propostas (6)](https://comando.one/docs/propostas)[NFS-e (6)](https://comando.one/docs/nfs-e)

Ou deixe a IA usar a API por você

O servidor MCP expõe estes mesmos recursos ao ChatGPT, Claude ou Gemini — com OAuth, sem chave de API.

[Conectar um assistente](https://comando.one/conectar-ia)