---
title: "Listar contas"
method: GET
path: "/api/v1/account"
tags: ["Contas"]
---

# Listar contas

`GET /api/v1/account`

Lista as contas da organização autenticada (token), com paginação e ordenação pela data de criação.

## Query parameters

- `order_by` 'asc' | 'desc'
- `page` integer
- `limit` integer

## Response `200`

Lista paginada de contas (`count` + `data`)

- ListOrganizationAccountsResponse
  - `count` integer — Total de contas
  - `data` ListAccountResponse[] — Lista de contas
    - `biometricProvider` 'idwall' | 'serpro' — Provedor biométrico
    - `cloudConfig` CloudConfigPayload
      - `access_key` string
      - `container` string
      - `provider` string
      - `region` string
      - `secret_key` string
      - `session_token` string
    - `color` string — Cor em hexadecimal
    - `companyId` string — Identificador da empresa no Nuvidio Call para redirecionamento em transbordo
    - `contractedIntelligences` ContractedIntelligence[] — Lista de inteligências contratadas
    - `createdAt` string — Data e hora de criação
    - `id` string — Identificador da conta
    - `logo` string — Logo da conta
    - `name` string — Nome da conta
    - `organizationId` string — Identificador da organização
    - `slug` string — Identificador amigável da conta
    - `styleId` string — Identificador do template de estilo
    - `transcriptionProvider` 'bot_runner' — Provedor de transcrição
    - `updatedAt` string — Data e hora da última modificação
    - `videoProvider` 'daily' — Provedor de vídeo
    - `whatsappConfig` WhatsAppConfigPayload
      - `apiKey` string — Chave de API da plataforma de envio
      - `apiSecret` string — Segredo da API da plataforma de envio
      - `pathParams` object — Conjunto de pares chave-valor em que cada chave corresponde ao nome de um campo esperado pelo template WhatsApp
      - `template` string — Nome do template cadastrado na plataforma de envio

## Other responses

- `422` — Parâmetros de query inválidos
- `500` — Erro inesperado ao listar contas

---

[API](https://skmtc.net/nuvidio/apis/nuvidio-openapi.md) · [All operations](https://skmtc.net/nuvidio/apis/nuvidio-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nuvidio/nuvidio-openapi/revisions/a262554413c2/schema)