Skip to main content
GET
/
pessoas
Retorna usuários cadastradas no sistema
curl --request GET \
  --url https://api-integracoes.agulhao.com.br/pessoas \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "1",
    "razaoSocial": "RAZÃO SOCIAL DA EMPRESA",
    "documento": "00000000000000",
    "fantasia": "FANTASIA DA EMPRESA",
    "email": "[email protected]",
    "telefone": "1112345678",
    "celular": "11912345678",
    "guia": true,
    "vendedor": false,
    "cliente": true,
    "ultimaAtualizacao": "2025-01-01T00:00:00",
    "endereco": {
      "cidadeId": "1",
      "cidadeNome": "São Paulo",
      "uf": "SP",
      "cep": "01000000",
      "logradouro": "Avenida Paulista",
      "numero": "1000",
      "complemento": "Apto 101",
      "bairro": "Bela Vista"
    }
  }
]

Authorizations

​
x-api-key
string
header
required

Chave da API gerada no agulhão

Query Parameters

​
pagina
string
default:1

Página atual da busca

​
qtdePorPagina
string
default:100

Quantidade de usuários por página

​
ultimaAtualizacao
string<date-time>

Retorna apenas usuários que foram atualizados após a data informada

Example:

"2025-01-01T00:00:00"

​
vendedor
enum<string>
default:0

Retorna apenas usuários que são vendedores

Available options:
1,
0
​
cliente
enum<string>
default:0

Retorna apenas usuários que são clientes

Available options:
1,
0
​
guia
enum<string>
default:0

Retorna apenas usuários que são guias

Available options:
1,
0

Response

200 - application/json

Sucesso

​
id
string

Identificador único do usuário

Example:

"1"

​
razaoSocial
string

Razão social do usuário

Example:

"RAZÃO SOCIAL DA EMPRESA"

​
documento
string

CNPJ ou CPF do usuário

Example:

"00000000000000"

​
fantasia
string

Nome fantasia do usuário

Example:

"FANTASIA DA EMPRESA"

​
email
string

E-mail do usuário

Example:

"[email protected]"

​
telefone
string

Telefone do usuário

Example:

"1112345678"

​
celular
string

Celular do usuário

Example:

"11912345678"

​
guia
boolean

Indica se o usuário é um guia

Example:

true

​
vendedor
boolean

Indica se o usuário é um vendedor

Example:

false

​
cliente
boolean

Indica se o usuário é um cliente

Example:

true

​
ultimaAtualizacao
string<date-time>

Data da última atualização do usuário

Example:

"2025-01-01T00:00:00"

​
endereco
object