GET Listar Contas

Lista todas as empresas (accounts) com paginação.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

Limite máximo

O parâmetro limit aceita no máximo 100 itens por página.

Endpoint

GET https://api-dev.imagemais.com.br/api/accounts

Parâmetros de Query

Nome	Tipo	Obrigatório	Descrição
`limit`	`number`	❌	Número de itens retornados a cada página (máx. `100`). Padrão: `50`
`offset`	`number`	❌	Número da página atual. Padrão: `0`

Requisição

curl -X 'GET' \
  'https://api-dev.imagemais.com.br/api/accounts?limit=50&offset=0' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {accessToken}'

Respostas

200 Sucesso

[
  {
    "id": 1,
    "name": "Account Test 1",
    "logoId": null,
    "contactId": 1,
    "createdAt": "2025-03-07T13:30:30.618Z",
    "updatedAt": "2025-03-07T13:30:30.618Z",
    "deletedAt": null,
    "statusId": 1,
    "expirationDate": "2025-12-31T23:59:59.000Z",
    "maxUsers": 10
  },
  {
    "id": 2,
    "name": "Account Test 2",
    "logoId": null,
    "contactId": 2,
    "createdAt": "2025-03-07T13:30:30.626Z",
    "updatedAt": "2025-03-07T13:30:30.626Z",
    "deletedAt": null,
    "statusId": 1,
    "expirationDate": "2025-12-31T23:59:59.000Z",
    "maxUsers": 15
  },
  {
    "id": 3,
    "name": "Account Test 3",
    "logoId": null,
    "contactId": 3,
    "createdAt": "2025-03-07T13:30:30.631Z",
    "updatedAt": "2025-03-07T13:30:30.631Z",
    "deletedAt": null,
    "statusId": 2,
    "expirationDate": "2025-12-31T23:59:59.000Z",
    "maxUsers": 5
  }
]

Estrutura do objeto de retorno

Campo	Tipo	Descrição
`id`	`number`	Identificador único da conta
`name`	`string`	Nome da empresa
`logoId`	`number \| null`	ID do logo da empresa
`contactId`	`number`	ID do contato associado
`statusId`	`number`	ID do status da conta
`expirationDate`	`string`	Data de expiração da conta (ISO 8601)
`maxUsers`	`number`	Número máximo de usuários permitidos
`createdAt`	`string`	Data de criação do registro
`updatedAt`	`string`	Data da última atualização
`deletedAt`	`string \| null`	Data de exclusão (soft delete)

Endpoint​

Parâmetros de Query​

Requisição​

Respostas​

200 Sucesso​

Estrutura do objeto de retorno​