> ## 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 linhas da fatura > Lista o detalhamento por linha de uma fatura, da linha de maior valor para a de menor. Cada item traz os valores da linha no momento do fechamento da fatura. Vazio em faturas que não são de telecom, e em faturas de telecom fechadas antes do registro deste detalhamento. ## OpenAPI ````yaml api-reference/v3/openapi.json GET /api/v3/invoices/{id}/phone-accounts 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/invoices/{id}/phone-accounts: get: tags: - Public API description: >- Lista o detalhamento por linha de uma fatura, da linha de maior valor para a de menor. Cada item traz os valores da linha no momento do fechamento da fatura. Vazio em faturas que não são de telecom, e em faturas de telecom fechadas antes do registro deste detalhamento. operationId: publicListInvoicePhoneAccountsV3 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 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 da linha na plataforma Salvy. example: 123e4567-e89b-12d3-a456-426614174000 title: UUID type: string examples: - 123e4567-e89b-12d3-a456-426614174000 - 123e4567-e89b-12d3-a456-426614174001 phoneNumber: anyOf: - title: PhoneNumberE164 type: string description: >- Phone number in E.164 format. Supports Brazilian numbers (+55). examples: - '+5511999999999' - '+551139999999' - type: 'null' description: >- Número da linha no momento do fechamento da fatura, no formato E.164. example: '+5541999887766' name: description: >- Nome atribuído à linha no momento do fechamento da fatura. example: Linha comercial - vendas type: - string - 'null' status: type: string enum: - pending - available - active - partial-block - blocked - canceled description: >- Situação da linha no momento do fechamento da fatura. example: active costCenter: anyOf: - type: object properties: id: description: Identificador do centro de custo da linha. 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 centro de custo da linha. example: TI-Curitiba code: description: >- Código do centro de custo. Nulo quando o centro de custo não tem código definido. example: TI-CWB type: - string - 'null' required: - id - name - code additionalProperties: false - type: 'null' description: >- Centro de custo da linha no momento do fechamento da fatura; detalhes em GET /cost-centers/{id}. Nulo quando a linha não tinha um centro de custo cadastrado no fechamento. employee: anyOf: - type: object properties: id: description: >- Identificador do colaborador vinculado à linha no fechamento da fatura. example: 123e4567-e89b-12d3-a456-426614174000 title: UUID type: string examples: - 123e4567-e89b-12d3-a456-426614174000 - 123e4567-e89b-12d3-a456-426614174001 name: type: string description: >- Nome do colaborador vinculado à linha no fechamento da fatura. example: Maria de Souza required: - id - name additionalProperties: false - type: 'null' meteredDataGB: description: >- Quantidade de dados tarifada por GB no período, em GB. Nulo quando o plano da linha não é cobrado por consumo. example: 12.5 type: - number - 'null' subscriptionAmountCents: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Soma das assinaturas cobradas da linha no período, em centavos. example: 4990 meteredAmountCents: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Consumo tarifado da linha no período (excedente cobrado por GB), em centavos. Zero quando o plano não é cobrado por consumo. example: 600 oneTimeAmountCents: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Soma das cobranças pontuais da linha no período (ex.: troca de eSIM, entrega), em centavos. Igual à soma de `oneTimeCharges`. example: 900 oneTimeCharges: type: array items: type: object properties: amountCents: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Valor da cobrança pontual, em centavos. example: 900 category: type: string enum: - data - roaming - sim-card - phone-number - delivery - device-management - document - fee description: >- Categoria da cobrança pontual. Conjunto estável para agrupamento; novos valores podem surgir conforme novos tipos de cobrança forem faturados. example: sim-card description: type: string description: >- Descrição da cobrança pontual, legível ao cliente. example: Troca de eSIM chargedAt: 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))$ description: Data em que a cobrança pontual ocorreu. example: '2026-07-14T12:00:00.000Z' required: - amountCents - category - description - chargedAt additionalProperties: false description: >- Cobranças pontuais da linha no período, uma a uma. Vazio quando não houve cobrança pontual. totalAmountCents: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Total cobrado da linha no período, em centavos. Igual a `subscriptionAmountCents` + `meteredAmountCents` + `oneTimeAmountCents`. example: 6490 subscriptionPeriods: type: array items: type: object properties: plan: type: object properties: id: description: Identificador do plano vigente no período. example: 123e4567-e89b-12d3-a456-426614174000 title: UUID type: string examples: - 123e4567-e89b-12d3-a456-426614174000 - 123e4567-e89b-12d3-a456-426614174001 name: type: string description: Nome do plano vigente no período. example: Salvy 20GB required: - id - name additionalProperties: false billableDays: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Dias faturados dentro do período. example: 18 periodStartDate: type: string format: date 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])))$ description: Primeiro dia do período faturado. example: '2026-07-01' periodEndDate: type: string format: date 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])))$ description: Último dia do período faturado. example: '2026-07-18' amountCents: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: Valor cobrado pelo período, em centavos. example: 2994 required: - plan - billableDays - periodStartDate - periodEndDate - amountCents additionalProperties: false description: >- Períodos de assinatura da linha dentro do mês. Mais de um período aparece quando a linha trocou de plano, foi ativada ou cancelada no meio do mês. required: - id - phoneNumber - name - status - costCenter - employee - meteredDataGB - subscriptionAmountCents - meteredAmountCents - oneTimeAmountCents - oneTimeCharges - totalAmountCents - subscriptionPeriods 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 ````