---
title: "GET /api/v2/virtual-phone-accounts"
method: GET
path: "/api/v2/virtual-phone-accounts"
tags: ["Public API"]
---

# GET /api/v2/virtual-phone-accounts

`GET /api/v2/virtual-phone-accounts`

Lista os números virtuais.

## Response `200`

- object[]
  - `id` string, required — A valid UUID string, in any version.
  - `name` string, nullable, required — Identificador do número virtual. Utilize para facilitar a gestão dos números virtuais.
  - `phoneNumber` string, required — Número virtual recém-criado, formatado conforme o padrão internacional E.164.
  - `status` 'pending' | 'active' | 'blocked' | 'canceled', required
  - `createdAt` string, date-time, required
  - `canceledAt` string, date-time, nullable, required
  - `cancelReason` string, nullable, required
  - `redirectPhoneNumber` string, nullable, required — Número designado para receber chamadas direcionadas ao número virtual recém-criado, formatado conforme o padrão internacional E.164.
  - `redirectExpiresAt` string, date-time, nullable, required — Data de expiração do redirecionamento de chamadas.
  - `costCenter` string, nullable, required — Centro de custo associado ao número virtual.
  - `employeeId` string, nullable, required — A valid UUID string, in any version.
  - `customFields` object[], required — Campos customizados associados ao número virtual.
    - `label` string, required
    - `type` 'text' | 'select', required
    - `value` string, required

## Other responses

- `401`
- `403`
- `404`
- `413`
- `422`
- `500`

---

[API](https://skmtc.net/salvy/apis/salvy-api.md) · [All operations](https://skmtc.net/salvy/apis/salvy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/salvy/salvy-api/versions/35784581fe38/schema)