UsuáriosListar Usuários

Listar Usuários

Retorna a lista paginada de usuários da empresa, com filtro opcional por e-mail.

Use nextPageStartKey para navegar entre páginas (paginação por cursor).

curl -X GET "https://api-sandbox.contasimples.com/users/v1/users?email=user%40company.com&limit=20&nextPageStartKey=example_string" \
  -H "Content-Type: application/json" \
  -H "Signature-Input: example_string" \
  -H "Signature: example_string" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "data": [
    {
      "id": "example_string",
      "email": "user@company.com",
      "name": "João Silva",
      "phone": "11999999999",
      "role": {
        "id": "example_string",
        "name": "Contador(a)"
      },
      "active": true
    }
  ],
  "nextPageStartKey": "example_string",
  "limit": 20
}
GET
/users/v1/users
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN
query
emailstring

Filtro por e-mail do usuário (correspondência exata).

query
limitinteger

Número máximo de usuários por página. Mínimo: 1, Máximo: 100.

Min: 1 • Max: 100
query
nextPageStartKeystring

Token opaco de paginação retornado na resposta anterior. Use exatamente como recebido para obter a próxima página.

header
Signature-Inputstring

O que foi assinado e os parâmetros da assinatura, no formato da RFC 9421. Uma credencial com chave pública precisa enviar este header em todas as chamadas, inclusive as de leitura, ou a requisição é recusada com 401. A assinatura cobre os componentes @method, @path e @query, e também content-digest quando houver corpo. created e alg são obrigatórios, e o created vale por 300 segundos. O formato completo, com exemplos, está em Assinatura de Requisições.

header
Signaturestring

A assinatura da base definida pela RFC 9421, em base64, entre : e com o mesmo rótulo usado no Signature-Input, por exemplo sig=:SGVsbG8gd29ybGQ=:. Vai sempre junto com o Signature-Input.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Token Bearer obtido via OAuth 2.0 Client Credentials. Formato: Bearer TOKEN

Query Parameters

emailstring

Filtro por e-mail do usuário (correspondência exata).

Example:
user@company.com
limitinteger

Número máximo de usuários por página. Mínimo: 1, Máximo: 100.

Example:
20
nextPageStartKeystring

Token opaco de paginação retornado na resposta anterior. Use exatamente como recebido para obter a próxima página.

Headers

Signature-Inputstring

O que foi assinado e os parâmetros da assinatura, no formato da RFC 9421. Uma credencial com chave pública precisa enviar este header em todas as chamadas, inclusive as de leitura, ou a requisição é recusada com 401. A assinatura cobre os componentes @method, @path e @query, e também content-digest quando houver corpo. created e alg são obrigatórios, e o created vale por 300 segundos. O formato completo, com exemplos, está em Assinatura de Requisições.

Signaturestring

A assinatura da base definida pela RFC 9421, em base64, entre : e com o mesmo rótulo usado no Signature-Input, por exemplo sig=:SGVsbG8gd29ybGQ=:. Vai sempre junto com o Signature-Input.

Responses

dataarray
Required

Lista de usuários.

nextPageStartKeystring

Token opaco para a próxima página. Se ausente, não há mais páginas. Use este valor no parâmetro nextPageStartKey da próxima requisição.

limitinteger

Número de itens por página.