For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DocumentaçãoReferência da API
DocumentaçãoReferência da API
  • Integrações privadas
        • GETListar Leads via Integração
        • GETListar consultores
        • GETListar pessoas
        • POSTCriar pessoa
        • PUTAtualizar pessoa
        • GETListar endereços
  • Entrada pública de leads
LogoLogo
Integrações privadasCRMCadastros

Listar pessoas

||View as Markdown|
GET
/simplificav2/pessoa
GET
/ords/gestao/simplificav2/pessoa
$curl https://gestao.simplificagestao.com.br/ords/gestao/simplificav2/pessoa \
>     -H "Authorization: Bearer <token>"
1{
2  "count": 1,
3  "hasMore": true,
4  "limit": 1,
5  "offset": 1,
6  "items": [
7    {
8      "id": 1,
9      "nome_completo": "string",
10      "cpf": "string",
11      "cnpj": "string",
12      "nome_fantasia": "string",
13      "nascimento": "string",
14      "email": "string",
15      "celular_1": "string",
16      "celular_2": "string",
17      "telefone_fixo": "string",
18      "tipo_registro": "string",
19      "fornecedor": "string",
20      "tipo_pessoa_cliente": "string",
21      "obs": "string",
22      "foto": "string",
23      "interesses": "string",
24      "interesses_nome": "string",
25      "origem_registro": "string",
26      "sexo": "string",
27      "tag": "string",
28      "pessoa_indicacao_id": 1,
29      "consultor_id": 1,
30      "origem_id": 1,
31      "categoria_id": 1,
32      "motivo_inativacao_id": 1,
33      "segmento_id": 1,
34      "data_alter_tipo_pessoa": "string",
35      "ativo": "string",
36      "dt_inativacao": "string",
37      "criado_em": "string",
38      "criado_por": "string",
39      "alterado_em": "string",
40      "alterado_por": "string"
41    }
42  ],
43  "links": [
44    {
45      "rel": "string",
46      "href": "string"
47    }
48  ]
49}
Retorna a lista de pessoas da empresa cadastradas no Simplifica. Uso comum: - consultar leads, clientes e contatos; - alimentar CRM externo, BI e automações; - cruzar pessoa com atividades, reuniões, oportunidades e vendas. Observação importante: - use `tipo_pessoa_cliente = 'L'` para consultar somente leads; - use `tipo_pessoa_cliente = 'C'` para consultar somente clientes; - quando quiser separar explicitamente o tipo, filtre por esse campo no parâmetro `q`; - alguns campos funcionam como referência para cadastros auxiliares; - por exemplo, quando a pessoa trouxer um identificador de origem, a resolução desse dado deve ser feita consultando `pessoa_origem`; - esse modelo prioriza performance e sincronização estruturada no lado consumidor. Exemplos rápidos de filtro: - Leads somente: `q={"tipo_pessoa_cliente":"L"}` ou `%7B%22tipo_pessoa_cliente%22%3A%22L%22%7D` - Clientes somente: `q={"tipo_pessoa_cliente":"C"}` ou `%7B%22tipo_pessoa_cliente%22%3A%22C%22%7D` Exemplo de uso: ```http GET {{base_url}}/simplificav2/pessoa?q={"ativo":"S","$orderby":{"alterado_em":"DESC"}} Authorization: Bearer {{bearer_token}} Accept: application/json ```
Was this page helpful?
Previous

Listar consultores

Next

Criar pessoa

Built with

Retorna a lista de pessoas da empresa cadastradas no Simplifica.

Uso comum:

  • consultar leads, clientes e contatos;
  • alimentar CRM externo, BI e automações;
  • cruzar pessoa com atividades, reuniões, oportunidades e vendas.

Observação importante:

  • use tipo_pessoa_cliente = 'L' para consultar somente leads;
  • use tipo_pessoa_cliente = 'C' para consultar somente clientes;
  • quando quiser separar explicitamente o tipo, filtre por esse campo no parâmetro q;
  • alguns campos funcionam como referência para cadastros auxiliares;
  • por exemplo, quando a pessoa trouxer um identificador de origem, a resolução desse dado deve ser feita consultando pessoa_origem;
  • esse modelo prioriza performance e sincronização estruturada no lado consumidor.

Exemplos rápidos de filtro:

  • Leads somente: q={"tipo_pessoa_cliente":"L"} ou %7B%22tipo_pessoa_cliente%22%3A%22L%22%7D
  • Clientes somente: q={"tipo_pessoa_cliente":"C"} ou %7B%22tipo_pessoa_cliente%22%3A%22C%22%7D

Exemplo de uso:

1GET {{base_url}}/simplificav2/pessoa?q={"ativo":"S","$orderby":{"alterado_em":"DESC"}}
2Authorization: Bearer {{bearer_token}}
3Accept: application/json

Authentication

AuthorizationBearer
Token privado usado para consultar dados da plataforma. Como usar: - obtenha o token privado da sua empresa; - envie `Authorization: Bearer SEU_TOKEN_PRIVADO`; - não use `x-api-key` neste módulo.

Query parameters

offsetintegerOptional>=0

Quantos registros pular antes de começar a resposta.

limitintegerOptional>=1
Quantidade máxima de registros por resposta. Observação: - informe `limit` explicitamente quando quiser controlar a quantidade por resposta.
qstringOptional
Filtro opcional para restringir, combinar ou ordenar os resultados. Se você não enviar `q`, o endpoint retorna a listagem padrão daquele recurso. Quando precisar filtrar, o `q` recebe um JSON no padrão FilterObject do ORDS. Regras práticas: - comece testando o endpoint sem filtro; - use os nomes de coluna publicados naquele endpoint; - use sempre o nome do campo exatamente como ele aparece no schema do endpoint; - `offset` e `limit` não entram dentro do `q`; - em clientes HTTP fora do Postman, o conteúdo normalmente precisa ser enviado URL-encoded; - no Postman, prefira informar o valor na aba `Params`. Operadores úteis: - `$or` - `$between` - `$orderby` - `$date` - `$ne`, `$lt`, `$lte`, `$gt`, `$gte` - `$instr`, `$ninstr` - `$notnull` Exemplos legíveis: - `{"id":162472}` - `{"ativo":"S"}` - `{"receita_recorrente_id":{"$notnull":null}}` - `{"status":"ABERTO","$orderby":{"data_vencimento":"ASC"}}` - `{"criado_em":{"$between":[{"$date":"2026-03-01T00:00:00Z"},{"$date":"2026-03-31T23:59:59Z"}]}}` Os mesmos exemplos prontos para URL: - `%7B%22id%22%3A162472%7D` - `%7B%22ativo%22%3A%22S%22%7D` - `%7B%22receita_recorrente_id%22%3A%7B%22%24notnull%22%3Anull%7D%7D` - `%7B%22status%22%3A%22ABERTO%22%2C%22%24orderby%22%3A%7B%22data_vencimento%22%3A%22ASC%22%7D%7D` - `%7B%22criado_em%22%3A%7B%22%24between%22%3A%5B%7B%22%24date%22%3A%222026-03-01T00%3A00%3A00Z%22%7D%2C%7B%22%24date%22%3A%222026-03-31T23%3A59%3A59Z%22%7D%5D%7D%7D`

Response

Coleção paginada de pessoas.

countinteger
hasMoreboolean
limitinteger
offsetinteger
itemslist of objects
linkslist of objects

Errors

400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error

Token privado usado para consultar dados da plataforma.

Como usar:

  • obtenha o token privado da sua empresa;
  • envie Authorization: Bearer SEU_TOKEN_PRIVADO;
  • não use x-api-key neste módulo.

Quantidade máxima de registros por resposta.

Observação:

  • informe limit explicitamente quando quiser controlar a quantidade por resposta.

Filtro opcional para restringir, combinar ou ordenar os resultados.

Se você não enviar q, o endpoint retorna a listagem padrão daquele recurso.

Quando precisar filtrar, o q recebe um JSON no padrão FilterObject do ORDS.

Regras práticas:

  • comece testando o endpoint sem filtro;
  • use os nomes de coluna publicados naquele endpoint;
  • use sempre o nome do campo exatamente como ele aparece no schema do endpoint;
  • offset e limit não entram dentro do q;
  • em clientes HTTP fora do Postman, o conteúdo normalmente precisa ser enviado URL-encoded;
  • no Postman, prefira informar o valor na aba Params.

Operadores úteis:

  • $or
  • $between
  • $orderby
  • $date
  • $ne, $lt, $lte, $gt, $gte
  • $instr, $ninstr
  • $notnull

Exemplos legíveis:

  • {"id":162472}
  • {"ativo":"S"}
  • {"receita_recorrente_id":{"$notnull":null}}
  • {"status":"ABERTO","$orderby":{"data_vencimento":"ASC"}}
  • {"criado_em":{"$between":[{"$date":"2026-03-01T00:00:00Z"},{"$date":"2026-03-31T23:59:59Z"}]}}

Os mesmos exemplos prontos para URL:

  • %7B%22id%22%3A162472%7D
  • %7B%22ativo%22%3A%22S%22%7D
  • %7B%22receita_recorrente_id%22%3A%7B%22%24notnull%22%3Anull%7D%7D
  • %7B%22status%22%3A%22ABERTO%22%2C%22%24orderby%22%3A%7B%22data_vencimento%22%3A%22ASC%22%7D%7D
  • %7B%22criado_em%22%3A%7B%22%24between%22%3A%5B%7B%22%24date%22%3A%222026-03-01T00%3A00%3A00Z%22%7D%2C%7B%22%24date%22%3A%222026-03-31T23%3A59%3A59Z%22%7D%5D%7D%7D