# Controle Clinic API > Documentação da API do Controle Clinic: conecte n8n, CRMs, ERPs e chatbots à sua clínica para agendar pacientes, cadastrar pacientes e ler o financeiro. - [Introdução](https://docs.controleclinic.com.br/index.md): Conecte n8n, CRMs, ERPs e chatbots à sua clínica pela API do Controle Clinic. - [Autenticação](https://docs.controleclinic.com.br/guias/autenticacao.md): Como criar a chave de API e enviá-la em cada chamada. - [Limites e erros](https://docs.controleclinic.com.br/guias/limites-e-erros.md): Limite de chamadas por minuto e os erros comuns a todas as rotas. - [Agendar um paciente](https://docs.controleclinic.com.br/guias/agendar-paciente.md): Do cadastro do paciente à consulta na agenda, em quatro chamadas. - [Ler o financeiro](https://docs.controleclinic.com.br/guias/financeiro.md): Vendas, recebíveis, caixa, despesas e saldos da clínica, só para leitura. - [Trazer o histórico](https://docs.controleclinic.com.br/guias/migracao.md): Quando usar a API e quando usar a Central de Migração. - [Verificação de conectividade](https://docs.controleclinic.com.br/api-reference/sistema/verificação-de-conectividade.md): Retorna o status atual da API. Não requer autenticação. - [Sua chave](https://docs.controleclinic.com.br/api-reference/sistema/sua-chave.md): Mostra a chave em uso: prefixo, nome, escopos, validade e a clínica dona. O saldo de chamadas do minuto vem nos cabeçalhos `X-RateLimit-*`. Não precisa de escopo. - [Agendamento em lote atômico](https://docs.controleclinic.com.br/api-reference/agendamentos/agendamento-em-lote-atômico.md): Cria até **50** agendamentos do **mesmo paciente** de uma vez. É tudo ou nada: se uma linha conflitar ou for inválida, nenhum agendamento é criado. - [Atualização de status em massa](https://docs.controleclinic.com.br/api-reference/agendamentos/atualização-de-status-em-massa.md): Muda o status de até **200** agendamentos de uma vez. Status aceitos: `scheduled`, `confirmed`, `completed`, `cancelled`, `no_show`. - [Listar agendamentos](https://docs.controleclinic.com.br/api-reference/agendamentos/listar-agendamentos.md): Agendamentos da clínica da chave, paginados (`limit` até 100). Filtros opcionais: `date_from`/`date_to` (sobre o início, `start_at`, em ISO 8601 com fuso), `status` e `professional_id`. Escopo: `scheduling:read`. - [Criar agendamento](https://docs.controleclinic.com.br/api-reference/agendamentos/criar-agendamento.md): Cria um agendamento. `status` padrão: `scheduled`. Datas em ISO 8601 **com fuso** (`2026-11-10T14:00:00-03:00`); sem fuso o horário é lido como UTC e aparece 3 horas adiantado na agenda. `end_at` precisa ser depois de `start_at`. - [Obter agendamento por ID](https://docs.controleclinic.com.br/api-reference/agendamentos/obter-agendamento-por-id.md): Um agendamento da clínica da chave. Id de outra clínica responde `404`, como se não existisse. Escopo: `scheduling:read`. - [Cancelar agendamento (soft-delete)](https://docs.controleclinic.com.br/api-reference/agendamentos/cancelar-agendamento-soft-delete.md): Não apaga: marca o agendamento como `cancelled` e mantém o histórico. Escopo: `scheduling:delete`. - [Atualizar agendamento](https://docs.controleclinic.com.br/api-reference/agendamentos/atualizar-agendamento.md): Atualiza só os campos enviados: remarcar (`start_at`/`end_at`), trocar profissional, procedimento, sala ou tecnologia, ou mudar o status (`scheduled`, `confirmed`, `completed`, `cancelled`, `no_show`). - [Listar pacientes (paginado, LGPD aplicada)](https://docs.controleclinic.com.br/api-reference/pacientes/listar-pacientes-paginado-lgpd-aplicada.md): Pacientes da clínica da chave, paginados (`limit` até 100). Sem o escopo `sensitive:read`, CPF, telefone, e-mail e nascimento saem mascarados. Escopo: `scheduling:read`. - [Criar paciente](https://docs.controleclinic.com.br/api-reference/pacientes/criar-paciente.md): Cria um paciente. Antes de gravar, compara com os cadastros da clínica — **inclusive arquivados** — por CPF, telefone e nome. - [Obter paciente por ID (LGPD aplicada)](https://docs.controleclinic.com.br/api-reference/pacientes/obter-paciente-por-id-lgpd-aplicada.md): Um paciente da clínica da chave. Id de outra clínica responde `404`. Sem `sensitive:read`, os dados pessoais saem mascarados. Escopo: `scheduling:read`. - [Atualizar paciente (patch parcial)](https://docs.controleclinic.com.br/api-reference/pacientes/atualizar-paciente-patch-parcial.md): Atualiza só os campos enviados. Não existe exclusão de paciente pela API: cadastro de paciente nunca é apagado (prontuário — CFM 1.821/2007). Escopo: `scheduling:write`. - [Listar profissionais ativos](https://docs.controleclinic.com.br/api-reference/lookup/listar-profissionais-ativos.md): Profissionais ativos da clínica da chave. O `id` vai em `professional_id` ao criar agendamento; ele não muda, então pode ser guardado no seu sistema. Escopo: `scheduling:read`. - [Listar procedimentos](https://docs.controleclinic.com.br/api-reference/lookup/listar-procedimentos.md): Procedimentos ativos da clínica da chave, com duração e preço. O `id` vai em `procedure_id` ao criar agendamento. Escopo: `scheduling:read`. - [Listar salas ativas](https://docs.controleclinic.com.br/api-reference/lookup/listar-salas-ativas.md): Salas ativas da clínica da chave. O `id` vai em `room_id` ao criar agendamento. Escopo: `scheduling:read`. - [Listar tecnologias ativas](https://docs.controleclinic.com.br/api-reference/lookup/listar-tecnologias-ativas.md): Tecnologias (equipamentos) ativas da clínica da chave, com a sala onde ficam. O `id` vai em `technology_id` ao criar agendamento. Escopo: `scheduling:read`. - [Vendas (regime competência)](https://docs.controleclinic.com.br/api-reference/financeiro/vendas-regime-competência.md): Vendas com data de competência no período, paginadas, da mais recente para a mais antiga. - [Títulos a receber (regime vencimento)](https://docs.controleclinic.com.br/api-reference/financeiro/títulos-a-receber-regime-vencimento.md): Títulos com vencimento no período, do mais antigo para o mais novo. - [Entradas de caixa (regime caixa)](https://docs.controleclinic.com.br/api-reference/financeiro/entradas-de-caixa-regime-caixa.md): Entradas previstas e realizadas no período, a mesma fonte do Fluxo de Caixa da tela. - [Despesas (regime competência ou vencimento)](https://docs.controleclinic.com.br/api-reference/financeiro/despesas-regime-competência-ou-vencimento.md): Despesas no período, paginadas, filtradas e ordenadas pelo eixo de `date_field` (que vira o `regime`). - [Saldo das contas (regime saldo)](https://docs.controleclinic.com.br/api-reference/financeiro/saldo-das-contas-regime-saldo.md): Saldo de cada conta bancária na data `as_of` (ausente = hoje em Brasília, calculado no banco). A tela mostra `saldo_liquidado`. ## OpenAPI Specs - [openapi](https://api.controleclinic.com.br/v1/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.