Pessoas

Consultar pessoa para edição

GET · API de Integração v2

GET/v2/pessoas/{id}

Consultar pessoa para edição

Retorna o estado completo editável da pessoa: dados principais, contatos, documentos, endereço, complementos, representante, responsáveis, equipes e campos personalizados.

O escritório é resolvido pelo token. Pessoa inexistente, excluída ou de outro escritório retorna 404.

Esta rota não retorna auditoria, dados internos de ownership ou histórico. Use a resposta para preencher o modal e, quando disponível, enviá-la ao endpoint de edição.

Autenticação

X-API-Key no cabeçalho. Como autenticar

Parâmetros de caminho1

idintegerobrigatório

ID da pessoa.

exemplo: 863210

Respostas4

Exemplos ilustrativos · nenhuma requisição é enviada

200 · Sucesso

Quando acontece: A operação foi concluída.
Como tratar: Leia os dados retornados; em listagens, confira também a paginação.

Exemplo declarado no OpenAPI · application/json

Exemplo · HTTP 200

{
  "id": 863210,
  "nome": "João da Silva",
  "apelido": "João",
  "classificacao": "CLIENTE",
  "naturezaPessoa": "FISICA",
  "cpfCnpj": "00000000000",
  "oab": null,
  "avatarUrl": null,
  "contatos": {
    "telefonePrincipal": "81999990000",
    "email": "joao@exemplo.com"
  },
  "documentos": {
    "dataNascimento": "1990-05-20"
  },
  "endereco": {
    "cidade": "Recife",
    "estado": "PE"
  },
  "complementos": {
    "valorHora": 250
  },
  "representante": null,
  "controleAcesso": {
    "responsaveisIds": [
      1649
    ],
    "equipesIds": [
      406
    ]
  },
  "camposPersonalizados": [
    {
      "campoId": 12,
      "valores": [
        "João da Silva"
      ]
    },
    {
      "campoId": 21,
      "valores": [
        "Opção A",
        "Opção C"
      ]
    }
  ]
}

Contrato de respostas

200Pessoa encontrada.

Pessoa encontrada.

application/json

apelidostring

Apelido ou nome curto

exemplo: João

avatarUrlstring

URL do avatar

camposPersonalizadosCampoPersonalizadoResponse[]

Campos personalizados gravados

Ver propriedades

campoIdinteger

ID da definição do campo personalizado

formato: int64exemplo: 12

valoresstring[]

Valores gravados para o campo

exemplo: ["Opção A"]

classificacaostring

Deprecated — use tipoNome para exibir e tipoId para identificar. Só é preenchido nos 8 tipos globais; tipo do escritório vem null.

exemplo: CLIENTE

complementosComplementosResponse

Ver propriedades

grupoEmpresasIdinteger

ID do grupo de empresas

formato: int64

indicacaoIdinteger

ID da indicação. Legado — use indicacoes. É a projeção da mais antiga do conjunto: quem tem três indicações aparece aqui com uma só.

formato: int64

indicacoesIndicacaoResponse[]

Indicações da pessoa, da mais antiga para a mais recente.

Ver propriedades

indicacaoIdinteger

ID da indicação

formato: int64exemplo: 42

obsstring

Observação sobre esta indicação

observacoesstring

Observações

valorHoranumber

Valor da hora

exemplo: 250

contatosContatosResponse

Ver propriedades

emailstring

E-mail

exemplo: joao@exemplo.com

facebookstring

Perfil do Facebook

instagramstring

Perfil do Instagram

linkedinstring

Perfil do LinkedIn

sitestring

Site

telefone03string

Terceiro telefone

telefonePrincipalstring

Telefone principal

exemplo: (81) 99999-9999

telefoneSecundariostring

Telefone secundário

controleAcessoControleAcessoResponse

Ver propriedades

equipesIdsinteger[]

IDs das equipes vinculadas

exemplo: [406]

responsaveisIdsinteger[]

IDs dos responsáveis vinculados

exemplo: [1649]

cpfCnpjstring

CPF ou CNPJ informado

exemplo: 000.000.000-00

documentosDocumentosResponse

Ver propriedades

cidstring

CID

ctpsstring

CTPS

dataEmissaoRgstring

Data de emissão do RG

dataNascimentostring

Data de nascimento

exemplo: 1990-01-31

estadoCivilstring

Estado civil

nacionalidadestring

Nacionalidade

naturalidadestring

Naturalidade

nomeMaestring

Nome da mãe

nomePaistring

Nome do pai

orgaoEmissorRgstring

Órgão emissor do RG

pisstring

PIS

profissaostring

Profissão

rgstring

sexostring

Sexo

enderecoEnderecoResponse

Ver propriedades

bairrostring

Bairro

cepstring

CEP

exemplo: 50000-000

cidadestring

Cidade

complementostring

Complemento

estadostring

exemplo: PE

logradourostring

Logradouro

numerostring

Número

idinteger

Identificador da pessoa

formato: int64exemplo: 123

naturezaPessoastring

Natureza da pessoa

exemplo: FISICA

nomestring

Nome da pessoa

exemplo: João da Silva

oabstring

Número da OAB

representanteRepresentanteResponse

Ver propriedades

bairrostring

Bairro do representante

cepstring

CEP do representante

cidadestring

Cidade do representante

documentostring

Documento do representante

enderecostring

Endereço do representante

estadostring

UF do representante

exemplo: PE

nascimentostring

Data de nascimento do representante

exemplo: 1990-01-31

nomestring

Nome do representante

rgstring

RG do representante

tipoIdinteger

ID do tipo no catálogo (GET /v2/pessoas/tipos)

formato: int64exemplo: 12

tipoNomestring

Nome do tipo, para exibir

exemplo: Curador

400ID inválido.

ID inválido.

O contrato não declara um corpo para esta resposta.

401Não autenticado (token ausente/inválido).

Não autenticado (token ausente/inválido).

O contrato não declara um corpo para esta resposta.

404Pessoa não encontrada.

Pessoa não encontrada.

O contrato não declara um corpo para esta resposta.

curl --request GET \
  --url 'https://api.expedit.com.br/v2/pessoas/863210' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: SUA_API_KEY'

Requisição e resposta

As chamadas são enviadas diretamente à API. O domínio deste portal precisa estar autorizado no CORS.

A resposta aparecerá aquiPreencha os campos e envie a requisição para consultar o retorno da API.

Explorar exemplos de resposta

Exemplos ilustrativos · nenhuma requisição é enviada

200 · Sucesso

Quando acontece: A operação foi concluída.
Como tratar: Leia os dados retornados; em listagens, confira também a paginação.

Exemplo declarado no OpenAPI · application/json

Exemplo · HTTP 200

{
  "id": 863210,
  "nome": "João da Silva",
  "apelido": "João",
  "classificacao": "CLIENTE",
  "naturezaPessoa": "FISICA",
  "cpfCnpj": "00000000000",
  "oab": null,
  "avatarUrl": null,
  "contatos": {
    "telefonePrincipal": "81999990000",
    "email": "joao@exemplo.com"
  },
  "documentos": {
    "dataNascimento": "1990-05-20"
  },
  "endereco": {
    "cidade": "Recife",
    "estado": "PE"
  },
  "complementos": {
    "valorHora": 250
  },
  "representante": null,
  "controleAcesso": {
    "responsaveisIds": [
      1649
    ],
    "equipesIds": [
      406
    ]
  },
  "camposPersonalizados": [
    {
      "campoId": 12,
      "valores": [
        "João da Silva"
      ]
    },
    {
      "campoId": 21,
      "valores": [
        "Opção A",
        "Opção C"
      ]
    }
  ]
}

Exemplos e campos gerados do contrato OpenAPI. Revise os valores antes de integrar.