> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salvy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar SMS da linha

> Lista as mensagens SMS recebidas por uma linha telefônica, ordenadas por data de recebimento decrescente (`receivedAt`), com paginação. Útil para reprocessar notificações de webhook perdidas. Mensagens SMS só existem para linhas do tipo DID (`mobile-did`, `landline-did`); linhas de outros tipos retornam uma lista vazia.



## OpenAPI

````yaml api-reference/v3/openapi.json GET /api/v3/phone-accounts/{id}/sms-messages
openapi: 3.1.0
info:
  version: v3
  title: Salvy API
  x-logo:
    url: web/logo.png
servers:
  - url: https://api.salvy.com.br
    description: Salvy API URL
security:
  - bearerAuth: []
tags:
  - name: Public API
  - name: Outgoing Webhooks
paths:
  /api/v3/phone-accounts/{id}/sms-messages:
    get:
      tags:
        - Public API
      description: >-
        Lista as mensagens SMS recebidas por uma linha telefônica, ordenadas por
        data de recebimento decrescente (`receivedAt`), com paginação. Útil para
        reprocessar notificações de webhook perdidas. Mensagens SMS só existem
        para linhas do tipo DID (`mobile-did`, `landline-did`); linhas de outros
        tipos retornam uma lista vazia.
      operationId: publicListPhoneAccountSmsMessagesV3
      parameters:
        - name: id
          in: path
          required: true
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            type: string
        - name: page
          in: query
          required: true
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            default: 1
            description: Número da página, iniciando em 1.
            example: 1
            type: integer
            minimum: 1
            maximum: 9007199254740991
        - name: pageSize
          in: query
          required: true
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            default: 50
            description: Tamanho da página. Máximo de 200.
            example: 50
            type: integer
            minimum: 1
            maximum: 200
        - name: receivedAtFrom
          in: query
          required: false
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            description: >-
              Filtra mensagens recebidas a partir desta data (inclusivo), em
              formato ISO8601.
            example: '2025-09-01T00:00:00Z'
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
        - name: receivedAtTo
          in: query
          required: false
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            description: >-
              Filtra mensagens recebidas até esta data (exclusivo), em formato
              ISO8601.
            example: '2025-10-01T00:00:00Z'
            type: string
            format: date-time
            pattern: >-
              ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
        - name: service
          in: query
          required: false
          schema:
            $schema: https://json-schema.org/draft/2020-12/schema
            description: >-
              Filtra mensagens cujo serviço detectado esteja na lista informada.
              Passe múltiplos valores repetindo o parâmetro
              (`?service=whatsapp&service=google`). Use `__null__` para incluir
              mensagens sem nenhum serviço detectado.
            type: array
            items:
              anyOf:
                - type: string
                  enum:
                    - whatsapp
                    - google
                    - telegram
                    - tiktok
                    - shopee
                    - amazon
                    - facebook
                    - nubank
                    - microsoft
                    - instagram
                    - hotmart
                    - discord
                    - godaddy
                    - twilio
                    - youtube
                    - claude
                    - samsung
                    - c6
                    - ifood
                    - paypal
                    - autodesk
                    - globo
                    - apple
                    - asaas
                    - mercado-livre
                    - wechat
                    - alipay
                    - airbnb
                    - snapchat
                    - hostgator
                    - messages
                    - sendpulse
                    - kwai
                    - salvy
                    - santander
                    - itau
                    - temu
                    - mercado-pago
                    - indeed
                    - zoom
                    - x
                    - hostinger
                    - unknown
                - type: string
                  const: __null__
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          description: ID da mensagem SMS recebida
                          example: 0140a8c6-3815-45b7-9e60-8e137cad845c
                          title: UUID
                          type: string
                          examples:
                            - 123e4567-e89b-12d3-a456-426614174000
                            - 123e4567-e89b-12d3-a456-426614174001
                        receivedAt:
                          description: >-
                            Data e hora de recebimento do SMS, em formato
                            ISO8601
                          example: '2025-09-03T00:00:00Z'
                          title: PlainDateTime
                          type: string
                          examples:
                            - '2023-10-05T14:48:00.000Z'
                        originPhoneNumber:
                          type: string
                          description: Número de origem do SMS
                          example: '23456'
                        destinationPhoneNumber:
                          description: >-
                            Número da linha virtual que recebeu o SMS, em
                            formato E.164.
                          example: '+5511987654321'
                          title: PhoneNumberE164
                          type: string
                          examples:
                            - '+5511999999999'
                            - '+551139999999'
                        message:
                          type: string
                          description: Conteúdo da mensagem SMS recebida
                          example: Seu codigo de verificação e 123456
                        detections:
                          type: object
                          properties:
                            whatsapp:
                              description: Conteúdo detectado de SMS do WhatsApp
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do WhatsApp
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            google:
                              description: Conteúdo detectado de SMS do Google
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Google
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            telegram:
                              description: Conteúdo detectado de SMS do Telegram
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Telegram
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            tiktok:
                              description: Conteúdo detectado de SMS do TikTok
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do TikTok
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            shopee:
                              description: Conteúdo detectado de SMS do Shopee
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Shopee
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            amazon:
                              description: Conteúdo detectado de SMS do Amazon
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Amazon
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            facebook:
                              description: Conteúdo detectado de SMS do Facebook
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Facebook
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            nubank:
                              description: Conteúdo detectado de SMS do Nubank
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Nubank
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            microsoft:
                              description: Conteúdo detectado de SMS do Microsoft
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Microsoft
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            instagram:
                              description: Conteúdo detectado de SMS do Instagram
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Instagram
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            hotmart:
                              description: Conteúdo detectado de SMS do Hotmart
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Hotmart
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            discord:
                              description: Conteúdo detectado de SMS do Discord
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Discord
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            godaddy:
                              description: Conteúdo detectado de SMS do GoDaddy
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do GoDaddy
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            twilio:
                              description: Conteúdo detectado de SMS do Twilio
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Twilio
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            youtube:
                              description: Conteúdo detectado de SMS do YouTube
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do YouTube
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            claude:
                              description: Conteúdo detectado de SMS do Claude
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Claude
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            samsung:
                              description: Conteúdo detectado de SMS do Samsung
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Samsung
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            c6:
                              description: Conteúdo detectado de SMS do C6
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do C6
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            ifood:
                              description: Conteúdo detectado de SMS do iFood
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do iFood
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            paypal:
                              description: Conteúdo detectado de SMS do PayPal
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do PayPal
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            autodesk:
                              description: Conteúdo detectado de SMS do Autodesk
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Autodesk
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            globo:
                              description: Conteúdo detectado de SMS do Globo
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Globo
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            apple:
                              description: Conteúdo detectado de SMS do Apple
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Apple
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            asaas:
                              description: Conteúdo detectado de SMS do ASAAS
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do ASAAS
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            mercado-livre:
                              description: Conteúdo detectado de SMS do Mercado Livre
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Mercado Livre
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            wechat:
                              description: Conteúdo detectado de SMS do WeChat
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do WeChat
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            alipay:
                              description: Conteúdo detectado de SMS do Alipay
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Alipay
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            airbnb:
                              description: Conteúdo detectado de SMS do Airbnb
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Airbnb
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            snapchat:
                              description: Conteúdo detectado de SMS do Snapchat
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Snapchat
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            hostgator:
                              description: Conteúdo detectado de SMS do HostGator
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do HostGator
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            messages:
                              description: Conteúdo detectado de SMS do Messages
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Messages
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            sendpulse:
                              description: Conteúdo detectado de SMS do SendPulse
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do SendPulse
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            kwai:
                              description: Conteúdo detectado de SMS do Kwai
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Kwai
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            salvy:
                              description: Conteúdo detectado de SMS do Salvy
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Salvy
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            santander:
                              description: Conteúdo detectado de SMS do Santander
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Santander
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            itau:
                              description: Conteúdo detectado de SMS do Itaú
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Itaú
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            temu:
                              description: Conteúdo detectado de SMS do Temu
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Temu
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            mercado-pago:
                              description: Conteúdo detectado de SMS do Mercado Pago
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Mercado Pago
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            indeed:
                              description: Conteúdo detectado de SMS do Indeed
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Indeed
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            zoom:
                              description: Conteúdo detectado de SMS do Zoom
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Zoom
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            x:
                              description: Conteúdo detectado de SMS do X
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do X
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                            hostinger:
                              description: Conteúdo detectado de SMS do Hostinger
                              type: object
                              properties:
                                verificationCode:
                                  type: string
                                  description: Código de verificação do Hostinger
                                  example: '123456'
                              required:
                                - verificationCode
                              additionalProperties: false
                          additionalProperties: false
                          description: >-
                            Resultado das detecções realizadas no conteúdo da
                            mensagem, como códigos de verificação, etc.
                      required:
                        - id
                        - receivedAt
                        - originPhoneNumber
                        - destinationPhoneNumber
                        - message
                        - detections
                      additionalProperties: false
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                        example: 1
                      pageSize:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                        example: 50
                      totalCount:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                        example: 123
                      totalPages:
                        type: integer
                        minimum: -9007199254740991
                        maximum: 9007199254740991
                        example: 3
                    required:
                      - page
                      - pageSize
                      - totalCount
                      - totalPages
                    additionalProperties: false
                required:
                  - data
                  - pagination
                additionalProperties: false
        '401':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - unauthorized
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '403':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - forbidden
                      - insufficient-scope
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '404':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - resource-not-found
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '413':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - payload-too-large
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
        '422':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - input-validation-error
                      - unprocessable-entity
                      - company-not-active
                  message:
                    type: string
                  details:
                    type: array
                    items:
                      type: object
                      properties:
                        key:
                          type: string
                        message:
                          type: string
                      required:
                        - key
                        - message
                      additionalProperties: false
                required:
                  - code
                  - message
                additionalProperties: {}
        '500':
          description: ''
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - unknown
                  message:
                    type: string
                required:
                  - code
                  - message
                additionalProperties: {}
      deprecated: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: key

````