---
title: "Dados básicos"
method: POST
path: "/queries"
tags: ["Dados pessoais"]
---

# Dados básicos

`POST /queries`

## Request

- Base URL: `https://api.deskdata.com.br`
- URL: `https://api.deskdata.com.br/queries`
- Auth: HTTP bearer

## Headers

- `Authorization` string, required

## Request body

- object
  - `type` 'persons', required: Tipo da busca
  - `key_type` 'cpf' | 'name' | 'email' | 'phone', required: Tipo da chave de busca
  - `key_value` string, required: Valor da chave de busca
  - `filters` FilterItem[]: Lista de filtros de busca
    - `key_type` 'mother_name' | 'birthdate' | 'address_street' | 'address_number' | 'address_neighborhood' | 'address_city' | 'address_state' | 'cpf_masked', required: Tipo do filtro de busca (verifique a disponibilidade para a chave de busca utilizada)
    - `key_value` string, required: Valor do filtro de busca
  - `datasets` basic, required: Lista de conjuntos de dados desejados

## Response `200`

OK

- ResponseQueriesPostSuccess
  - `status` object: Status do retorno da requisição
    - `code` integer: Código do retorno da requisição
    - `message` string: Mensagem do retorno da requisição
    - `details` string: Detalhes do retorno da requisição
  - `data` object: Dados resultantes
    - `basic` object: Informações do conjunto de dados 'basic' sobre a pessoa consultada
      - `age` integer: Anos de idade no momento da consulta
      - `birth_date` string, date-time: Data de nascimento
      - `chinese_sign` 'Rat' | 'Ox' | 'Tiger' | 'Rabbit' | 'Dragon' | 'Snake' | 'Horse' | 'Goat' | 'Monkey' | 'Rooster' | 'Dog' | 'Pig': Signo do horóscopo chinês
      - `father_name` string: Nome completo do pai
      - `gender` 'M' | 'F' | 'U': Gênero, sendo 'M' = 'masculino', 'F' = 'feminino' e 'U' = 'não identidicado'
      - `mother_name` string: Nome completo da mãe
      - `nationality` string: Nacionalidade
      - `zodiac_sign` 'CAPRICORNIO' | 'ARIES' | 'LEAO' | 'CANCER' | 'LIBRA' | 'AQUARIO' | 'SAGITARIO' | 'GEMEOS' | 'VIRGEM' | 'TOURO' | 'PEIXES' | 'ESCORPIAO': Sígno do horóscopo ocidental
      - `marital_record` object: Informações sobre o estado civil
        - `status` string: Estado civil
        - `status_date` string, date-time: Data da captura do estado civil
      - `name` object: Informações sobre o nome completo
        - `full_name` string: Nome completo
        - `full_name_word_count` integer: Contagem de palavras no nome completo
        - `full_name_namesake_count` integer: Contagem de homônimos de nome completo
        - `full_name_uniqueness` number, float: Unicidade do nome completo, sendo '0' muito comum e '1' único
        - `first_name_uniqueness` number, float: Unicidade do primeiro nome, sendo '0' muito comum e '1' único
        - `first_and_last_name_uniqueness` number, float: Unicidade do primeiro e último nome, sendo '0' muito comum e '1' único
      - `obit` object: Informações sobre o indicativo de óbito
        - `indication` boolean: Inticativo de óbito
        - `year` integer: Ano do óbito
      - `tax_id` object: Informações sobre o CPF
        - `number` string: Número
        - `country` string: País de emissão
        - `fiscal_region` 'DF-GO-MS-MT-TO' | 'AC-AM-AP-PA-RO-RR' | 'CE-MA-PI' | 'AL-PB-PE-RN' | 'BA-SE' | 'MG' | 'ES-RJ' | 'SP' | 'PR-SC' | 'RS': Região fiscal
        - `registration_date` string, date-time: Data de registro
        - `status` 'NULA' | 'PENDENTE DE REGULARIZACAO' | 'REGULAR' | 'SUSPENSA' | 'TITULAR FALECIDO': Status na Receita Federal
        - `status_date` string, date-time: Data de captura do status na Receita Federal
      - `cnh` object: Informações sobre a CNH
        - `number` string: Número
      - `rg` object: Informações sobre o RG
        - `number` string: Número
        - `issuing_agency` string: Órgão emissor
        - `issuing_state` 'AC' | 'AL' | 'AP' | 'AM' | 'BA' | 'CE' | 'DF' | 'ES' | 'GO' | 'MA' | 'MT' | 'MS' | 'MG' | 'PA' | 'PB' | 'PR' | 'PE' | 'PI' | 'RJ' | 'RN' | 'RS' | 'RO' | 'RR' | 'SC' | 'SP' | 'SE' | 'TO': Estado do órgão emissor
      - `social_security` object: Informações sobre o PIS, PASEP, NIS ou NIT
        - `number` string: Número
      - `voter_id` object: Informações sobre o título eleitoral
        - `number` string: Número

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/deskdata/apis/consultas-a-pessoas.md) - [All operations](https://skmtc.dev/deskdata/apis/consultas-a-pessoas/llms.txt) - [OpenAPI document](https://skmtc.dev/deskdata/apis/consultas-a-pessoas/revisions/45627a7f440c?raw)