UsuáriosListar Convites

Listar Convites

Retorna a lista paginada de convites de usuários da empresa, com filtros opcionais por status e papel (role).

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

curl -X GET "https://api-sandbox.contasimples.com/users/v1/invites?status=PENDING&roleId=uuid-role-id&limit=10&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": "uuid-invite-id",
      "email": "user@company.com",
      "role": {
        "id": "uuid-role-id"
      },
      "expiresAt": "2025-12-31T23:59:59.000Z"
    }
  ],
  "nextPageStartKey": "example_string",
  "limit": 10
}
GET
/users/v1/invites
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
statusstring

Filtro por status do convite.

Options: PENDING, EXCLUDED, EXPIRED
query
roleIdstring

Filtro por ID do papel (role) atribuído ao convite.

Format: uuid
query
limitinteger

Número máximo de convites por página. Mínimo: 1, Máximo: 100. Padrão: 10.

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

statusstring

Filtro por status do convite.

Allowed values:PENDINGEXCLUDEDEXPIRED
roleIdstring

Filtro por ID do papel (role) atribuído ao convite.

Example:
uuid-role-id
limitinteger

Número máximo de convites por página. Mínimo: 1, Máximo: 100. Padrão: 10.

Example:
10
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 convites.

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.