Clientes

Gerencie o cadastro de clientes do seu escritório. Suporta Pessoa Física (PF) e Pessoa Jurídica (PJ) com campos específicos para cada tipo.

GET /v1/clients

Lista todos os clientes do time.

Query Parameters

Parâmetro	Tipo	Padrão	Descrição
`page`	number	1	Página atual
`limit`	number	20	Itens por página (máx: 100)
`type`	string	-	Filtrar por tipo: `PF`, `PJ`
`status`	string	-	Filtrar por status: `active`, `inactive`
`segment`	string	-	Filtrar por segmento: `vip`, `premium`, `regular`, `occasional`
`search`	string	-	Buscar por nome, email ou documento
`sort`	string	`-created_at`	Ordenação

Request

curl -X GET "https://api.juspilot.co/v1/clients?type=PF&segment=premium" \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "cli_abc123def456",
      "type": "PF",
      "name": "João da Silva",
      "email": "joao.silva@email.com",
      "phone": "+55 11 99999-8888",
      "cpf": "123.456.789-00",
      "segment": "premium",
      "status": "active",
      "cases_count": 3,
      "created_at": "2026-01-15T10:30:00Z"
    },
    {
      "id": "cli_xyz789ghi012",
      "type": "PJ",
      "name": "Empresa ABC Ltda",
      "email": "contato@empresaabc.com.br",
      "phone": "+55 11 3333-4444",
      "cnpj": "12.345.678/0001-90",
      "segment": "vip",
      "status": "active",
      "cases_count": 8,
      "created_at": "2026-01-10T09:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "pages": 8
  }
}

POST /v1/clients

Cria um novo cliente.

Request Body - Pessoa Física (PF)

Campo	Tipo	Obrigatório	Descrição
`type`	string	Sim	Tipo: `PF`
`name`	string	Sim	Nome completo
`email`	string	Não	Email
`phone`	string	Não	Telefone com DDI
`whatsapp`	string	Não	WhatsApp
`cpf`	string	Não	CPF
`rg`	string	Não	RG
`birth_date`	string	Não	Data de nascimento (YYYY-MM-DD)
`gender`	string	Não	Gênero: `masculino`, `feminino`, `outro`
`marital_status`	string	Não	Estado civil
`nationality`	string	Não	Nacionalidade
`profession`	string	Não	Profissão
`segment`	string	Não	Segmento: `vip`, `premium`, `regular`, `occasional`
`address`	object	Não	Endereço completo
`notes`	string	Não	Observações
`tags`	array	Não	Tags/etiquetas
`metadata`	object	Não	Dados customizados

Request Body - Pessoa Jurídica (PJ)

Campo	Tipo	Obrigatório	Descrição
`type`	string	Sim	Tipo: `PJ`
`name`	string	Sim	Razão social ou nome fantasia
`legal_name`	string	Não	Razão social
`trade_name`	string	Não	Nome fantasia
`email`	string	Não	Email
`phone`	string	Não	Telefone com DDI
`whatsapp`	string	Não	WhatsApp
`cnpj`	string	Não	CNPJ
`state_registration`	string	Não	Inscrição estadual
`segment`	string	Não	Segmento: `vip`, `premium`, `regular`, `occasional`
`address`	object	Não	Endereço completo
`contact_person`	string	Não	Pessoa de contato
`notes`	string	Não	Observações
`tags`	array	Não	Tags/etiquetas
`metadata`	object	Não	Dados customizados

Objeto Address

{
  "street": "Av. Paulista",
  "number": "1000",
  "complement": "Sala 101",
  "neighborhood": "Bela Vista",
  "city": "São Paulo",
  "state": "SP",
  "zip_code": "01310-100",
  "country": "Brasil"
}

Request - Pessoa Física

curl -X POST https://api.juspilot.co/v1/clients \
  -H "Authorization: Bearer jp_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "PF",
    "name": "João da Silva",
    "email": "joao.silva@email.com",
    "phone": "+55 11 99999-8888",
    "cpf": "123.456.789-00",
    "birth_date": "1985-06-15",
    "profession": "Empresário",
    "segment": "premium",
    "address": {
      "street": "Rua das Flores",
      "number": "123",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "zip_code": "01234-567"
    }
  }'

Request - Pessoa Jurídica

curl -X POST https://api.juspilot.co/v1/clients \
  -H "Authorization: Bearer jp_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "PJ",
    "name": "Empresa ABC Ltda",
    "legal_name": "Empresa ABC Comércio e Serviços Ltda",
    "trade_name": "Empresa ABC",
    "email": "contato@empresaabc.com.br",
    "phone": "+55 11 3333-4444",
    "cnpj": "12.345.678/0001-90",
    "segment": "vip",
    "contact_person": "Maria Santos"
  }'

Response

{
  "success": true,
  "data": {
    "id": "cli_abc123def456",
    "type": "PF",
    "name": "João da Silva",
    "email": "joao.silva@email.com",
    "phone": "+55 11 99999-8888",
    "cpf": "123.456.789-00",
    "birth_date": "1985-06-15",
    "profession": "Empresário",
    "segment": "premium",
    "status": "active",
    "address": {
      "street": "Rua das Flores",
      "number": "123",
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "zip_code": "01234-567"
    },
    "cases_count": 0,
    "created_at": "2026-02-04T10:30:00Z",
    "updated_at": "2026-02-04T10:30:00Z"
  }
}

GET /v1/clients/:id

Busca um cliente específico.

Request

curl -X GET https://api.juspilot.co/v1/clients/cli_abc123def456 \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "cli_abc123def456",
    "type": "PF",
    "name": "João da Silva",
    "email": "joao.silva@email.com",
    "phone": "+55 11 99999-8888",
    "whatsapp": "+55 11 99999-8888",
    "cpf": "123.456.789-00",
    "rg": "12.345.678-9",
    "birth_date": "1985-06-15",
    "gender": "masculino",
    "marital_status": "casado",
    "nationality": "brasileiro",
    "profession": "Empresário",
    "segment": "premium",
    "status": "active",
    "address": {
      "street": "Rua das Flores",
      "number": "123",
      "complement": null,
      "neighborhood": "Centro",
      "city": "São Paulo",
      "state": "SP",
      "zip_code": "01234-567",
      "country": "Brasil"
    },
    "notes": "Cliente indicado por Dr. Carlos",
    "tags": ["indicação", "prioridade"],
    "cases_count": 3,
    "metadata": {},
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-02-04T14:20:00Z"
  }
}

PUT /v1/clients/:id

Atualiza um cliente existente.

Request

curl -X PUT https://api.juspilot.co/v1/clients/cli_abc123def456 \
  -H "Authorization: Bearer jp_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+55 11 88888-7777",
    "segment": "vip",
    "notes": "Cliente VIP - atendimento prioritário"
  }'

Response

{
  "success": true,
  "data": {
    "id": "cli_abc123def456",
    "phone": "+55 11 88888-7777",
    "segment": "vip",
    "notes": "Cliente VIP - atendimento prioritário",
    "updated_at": "2026-02-04T15:00:00Z"
  }
}

DELETE /v1/clients/:id

Desativa um cliente (soft delete).

Clientes com processos ativos não podem ser desativados. Arquive os processos primeiro.

Request

curl -X DELETE https://api.juspilot.co/v1/clients/cli_abc123def456 \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": {
    "id": "cli_abc123def456",
    "status": "inactive",
    "deactivated_at": "2026-02-04T15:30:00Z"
  }
}

GET /v1/clients/:id/cases

Lista os processos de um cliente.

Request

curl -X GET https://api.juspilot.co/v1/clients/cli_abc123def456/cases \
  -H "Authorization: Bearer jp_live_sua_chave_aqui"

Response

{
  "success": true,
  "data": [
    {
      "id": "case_xyz789",
      "title": "Ação de Cobrança",
      "number": "0001234-56.2026.8.26.0100",
      "area": "Cível",
      "phase": "em-andamento",
      "priority": "alta",
      "status": "ativo",
      "created_at": "2026-01-20T10:00:00Z"
    },
    {
      "id": "case_abc123",
      "title": "Consultoria Empresarial",
      "number": null,
      "area": "Empresarial",
      "phase": "finalizado",
      "priority": "media",
      "status": "arquivado",
      "created_at": "2025-06-15T09:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2,
    "pages": 1
  }
}

Segmentos de Cliente

Segmento	Descrição
`vip`	Clientes VIP - atendimento diferenciado
`premium`	Clientes premium - prioridade alta
`regular`	Clientes regulares
`occasional`	Clientes ocasionais

Erros Comuns

Código	Erro	Solução
`400`	`Invalid type`	Use: `PF` ou `PJ`
`400`	`Invalid CPF format`	Use formato: 123.456.789-00
`400`	`Invalid CNPJ format`	Use formato: 12.345.678/0001-90
`404`	`Client not found`	Verifique o ID do cliente
`422`	`Duplicate CPF`	CPF já cadastrado
`422`	`Duplicate CNPJ`	CNPJ já cadastrado
`422`	`Client has active cases`	Arquive os processos antes de desativar

Clientes

On this page