---
title: "GET /api/v2/virtual-phone-accounts/{id}/sms-messages"
method: GET
path: "/api/v2/virtual-phone-accounts/{id}/sms-messages"
tags: ["Public API"]
---

# GET /api/v2/virtual-phone-accounts/{id}/sms-messages

`GET /api/v2/virtual-phone-accounts/{id}/sms-messages`

Lista as mensagens SMS recebidas por um número virtual, ordenadas por data de recebimento decrescente (`receivedAt`), com paginação. Útil para reprocessar notificações de webhook perdidas.

## Path parameters

- `id` string, required

## Query parameters

- `page` integer, required — Número da página, iniciando em 1.
- `pageSize` integer, required — Tamanho da página. Máximo de 200.
- `receivedAtFrom` string, date-time — Filtra mensagens recebidas a partir desta data (inclusivo), em formato ISO8601.
- `receivedAtTo` string, date-time — Filtra mensagens recebidas até esta data (exclusivo), em formato ISO8601.
- `service` string[] — Filtra mensagens cujo serviço detectado esteja na lista informada. Passe múltiplos valores repetindo o parâmetro (`?service=whatsapp&service=google`). Use `none` para incluir mensagens sem nenhum serviço detectado.

## Response `200`

- object
  - `smsMessages` object[], required
    - `id` string, required — ID da mensagem SMS recebida
    - `receivedAt` string, required — Data e hora de recebimento do SMS, em formato ISO8601
    - `originPhoneNumber` string, required — Número de origem do SMS
    - `destinationPhoneNumber` string, required — Número da linha virtual que recebeu o SMS, em formato E.164.
    - `message` string, required — Conteúdo da mensagem SMS recebida
    - `detections` object, required — Resultado das detecções realizadas no conteúdo da mensagem, como códigos de verificação, etc.
      - `whatsapp` object — Conteúdo detectado de SMS do WhatsApp
        - `verificationCode` string, required — Código de verificação do WhatsApp
      - `google` object — Conteúdo detectado de SMS do Google
        - `verificationCode` string, required — Código de verificação do Google
      - `telegram` object — Conteúdo detectado de SMS do Telegram
        - `verificationCode` string, required — Código de verificação do Telegram
      - `tiktok` object — Conteúdo detectado de SMS do TikTok
        - `verificationCode` string, required — Código de verificação do TikTok
      - `shopee` object — Conteúdo detectado de SMS do Shopee
        - `verificationCode` string, required — Código de verificação do Shopee
      - `amazon` object — Conteúdo detectado de SMS do Amazon
        - `verificationCode` string, required — Código de verificação do Amazon
      - `facebook` object — Conteúdo detectado de SMS do Facebook
        - `verificationCode` string, required — Código de verificação do Facebook
      - `nubank` object — Conteúdo detectado de SMS do Nubank
        - `verificationCode` string, required — Código de verificação do Nubank
      - `microsoft` object — Conteúdo detectado de SMS do Microsoft
        - `verificationCode` string, required — Código de verificação do Microsoft
      - `instagram` object — Conteúdo detectado de SMS do Instagram
        - `verificationCode` string, required — Código de verificação do Instagram
      - `hotmart` object — Conteúdo detectado de SMS do Hotmart
        - `verificationCode` string, required — Código de verificação do Hotmart
      - `discord` object — Conteúdo detectado de SMS do Discord
        - `verificationCode` string, required — Código de verificação do Discord
      - `godaddy` object — Conteúdo detectado de SMS do GoDaddy
        - `verificationCode` string, required — Código de verificação do GoDaddy
      - `twilio` object — Conteúdo detectado de SMS do Twilio
        - `verificationCode` string, required — Código de verificação do Twilio
      - `youtube` object — Conteúdo detectado de SMS do YouTube
        - `verificationCode` string, required — Código de verificação do YouTube
      - `claude` object — Conteúdo detectado de SMS do Claude
        - `verificationCode` string, required — Código de verificação do Claude
      - `samsung` object — Conteúdo detectado de SMS do Samsung
        - `verificationCode` string, required — Código de verificação do Samsung
      - `c6` object — Conteúdo detectado de SMS do C6
        - `verificationCode` string, required — Código de verificação do C6
      - `ifood` object — Conteúdo detectado de SMS do iFood
        - `verificationCode` string, required — Código de verificação do iFood
      - `paypal` object — Conteúdo detectado de SMS do PayPal
        - `verificationCode` string, required — Código de verificação do PayPal
      - `autodesk` object — Conteúdo detectado de SMS do Autodesk
        - `verificationCode` string, required — Código de verificação do Autodesk
      - `globo` object — Conteúdo detectado de SMS do Globo
        - `verificationCode` string, required — Código de verificação do Globo
      - `apple` object — Conteúdo detectado de SMS do Apple
        - `verificationCode` string, required — Código de verificação do Apple
      - `asaas` object — Conteúdo detectado de SMS do ASAAS
        - `verificationCode` string, required — Código de verificação do ASAAS
      - `mercado-livre` object — Conteúdo detectado de SMS do Mercado Livre
        - `verificationCode` string, required — Código de verificação do Mercado Livre
      - `wechat` object — Conteúdo detectado de SMS do WeChat
        - `verificationCode` string, required — Código de verificação do WeChat
      - `alipay` object — Conteúdo detectado de SMS do Alipay
        - `verificationCode` string, required — Código de verificação do Alipay
      - `airbnb` object — Conteúdo detectado de SMS do Airbnb
        - `verificationCode` string, required — Código de verificação do Airbnb
      - `snapchat` object — Conteúdo detectado de SMS do Snapchat
        - `verificationCode` string, required — Código de verificação do Snapchat
      - `hostgator` object — Conteúdo detectado de SMS do HostGator
        - `verificationCode` string, required — Código de verificação do HostGator
      - `messages` object — Conteúdo detectado de SMS do Messages
        - `verificationCode` string, required — Código de verificação do Messages
      - `sendpulse` object — Conteúdo detectado de SMS do SendPulse
        - `verificationCode` string, required — Código de verificação do SendPulse
      - `kwai` object — Conteúdo detectado de SMS do Kwai
        - `verificationCode` string, required — Código de verificação do Kwai
      - `salvy` object — Conteúdo detectado de SMS do Salvy
        - `verificationCode` string, required — Código de verificação do Salvy
      - `santander` object — Conteúdo detectado de SMS do Santander
        - `verificationCode` string, required — Código de verificação do Santander
      - `itau` object — Conteúdo detectado de SMS do Itaú
        - `verificationCode` string, required — Código de verificação do Itaú
      - `temu` object — Conteúdo detectado de SMS do Temu
        - `verificationCode` string, required — Código de verificação do Temu
      - `mercado-pago` object — Conteúdo detectado de SMS do Mercado Pago
        - `verificationCode` string, required — Código de verificação do Mercado Pago
      - `indeed` object — Conteúdo detectado de SMS do Indeed
        - `verificationCode` string, required — Código de verificação do Indeed
      - `zoom` object — Conteúdo detectado de SMS do Zoom
        - `verificationCode` string, required — Código de verificação do Zoom
      - `x` object — Conteúdo detectado de SMS do X
        - `verificationCode` string, required — Código de verificação do X
      - `hostinger` object — Conteúdo detectado de SMS do Hostinger
        - `verificationCode` string, required — Código de verificação do Hostinger
  - `pagination` object, required
    - `page` integer, required
    - `pageSize` integer, required
    - `totalCount` integer, required
    - `totalPages` integer, 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/revisions/35784581fe38/schema)
