> ## 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 planos

> Lista os planos disponíveis para a sua empresa, restritos a linhas móveis (`productType: "mobile"`) nesta versão. Ordenados por nome (`name`) crescente, com desempate por ID crescente. Este endpoint não é paginado.



## OpenAPI

````yaml api-reference/v3/openapi.json GET /api/v3/plans
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/plans:
    get:
      tags:
        - Public API
      description: >-
        Lista os planos disponíveis para a sua empresa, restritos a linhas
        móveis (`productType: "mobile"`) nesta versão. Ordenados por nome
        (`name`) crescente, com desempate por ID crescente. Este endpoint não é
        paginado.
      operationId: publicListPlansV3
      parameters: []
      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: Identificador único do plano.
                          example: 0198c2f1-3815-45b7-9e60-8e137cad845c
                          title: UUID
                          type: string
                          examples:
                            - 123e4567-e89b-12d3-a456-426614174000
                            - 123e4567-e89b-12d3-a456-426614174001
                        name:
                          type: string
                          description: Nome do plano.
                          example: Plano 20GB
                        productType:
                          type: string
                          enum:
                            - mobile
                          description: >-
                            Tipo de produto ao qual o plano se aplica. Hoje
                            sempre "mobile" (linhas móveis); novos tipos poderão
                            ser adicionados sem mudança de versão — cheque este
                            campo ao consumir.
                          example: mobile
                        availableDataAmountGB:
                          type: number
                          description: Quantidade de dados disponível no plano, em GB.
                          example: 20
                        priceCents:
                          type: number
                          description: Valor mensal do plano para a empresa, em centavos.
                          example: 4500
                      required:
                        - id
                        - name
                        - productType
                        - availableDataAmountGB
                        - priceCents
                      additionalProperties: false
                required:
                  - data
                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

````