Axuz Developers

GET /v1/teams/{teamId}/billing/invoices

Últimas 100 faturas do time

  • Access: Team member
  • Service: https://api-billing.axuz.net

Accepted authentication

  • sessionCookie — Sessão plena Axuz (cookie de sessão da casa). Sessão restrita é 403 enrollment_required.
  • bearerSession — JWT de acesso da sessão em `Authorization: Bearer`.

Responde GET /teams/{teamId}/billing/invoices pra Admin/Financer do workspace verem seu histórico. Devolve as 100 mais recentes. Efeito: SELECT em invoices por team_id ordenado por issued_at DESC.

Parameters

NameInTypeRequiredDescription
teamIdpathstringyes

Responses

200

lista

NameTypeRequiredDescription
itemsarray<BillingInvoice>no
items[].idstring<uuid>no
items[].team_idstring<uuid>no
items[].subscription_idstring<uuid> | nullno
items[].numberstringno
items[].statusstringno

enum: "draft", "open", "paid", "past_due", "void", "refunded"

items[].currencystringno
items[].subtotal_centsintegerno
items[].tax_centsintegerno
items[].discount_centsintegerno
items[].total_centsintegerno
items[].issued_atstring<date-time>no
items[].due_atstring<date-time>no
items[].paid_atstring<date-time> | nullno
items[].period_startstring<date-time> | nullno
items[].period_endstring<date-time> | nullno
items[].pdf_urlstringno
items[].tax_id_snapshotstringno
items[].billing_emailstringno
items[].providerstringno
items[].provider_inv_idstringno
items[].notesstringno
items[].created_atstring<date-time>no
items[].updated_atstring<date-time>no
items[].itemsarray<BillingInvoiceItem>no
items[].items[].idstring<uuid>no
items[].items[].invoice_idstring<uuid>no
items[].items[].descriptionstringno
items[].items[].quantityintegerno
items[].items[].unit_centsintegerno
items[].items[].amount_centsintegerno
items[].items[].metadataobjectno
items[].paymentsarray<BillingPayment>no
items[].payments[].idstring<uuid>no
items[].payments[].invoice_idstring<uuid>no
items[].payments[].team_idstring<uuid>no
items[].payments[].amount_centsintegerno
items[].payments[].currencystringno
items[].payments[].statusstringno

enum: "pending", "succeeded", "failed", "refunded"

items[].payments[].methodstringno
items[].payments[].providerstringno
items[].payments[].provider_pay_idstringno
items[].payments[].failure_reasonstringno
items[].payments[].paid_atstring<date-time> | nullno
items[].payments[].created_atstring<date-time>no

400

input inválido

NameTypeRequiredDescription
errorstringyes

401

Sem credencial valida

NameTypeRequiredDescription
errorstringyes

403

Sem permissao (nao e owner/admin; token sem escopo; token de integracao em rota nao permitida)

NameTypeRequiredDescription
errorstringyes

429

Limite de requisições excedido.

NameTypeRequiredDescription
errorstringyes

500

erro interno

NameTypeRequiredDescription
errorstringyes

Examples

"Try it" is turned off in this reference. Use the examples with your test credential.

curl

curl -sS -X GET 'https://api-billing.axuz.net/v1/teams/TEAM_ID/billing/invoices' \
  -H "Authorization: Bearer $AXUZ_TOKEN"

Node.js

const res = await fetch("https://api-billing.axuz.net/v1/teams/TEAM_ID/billing/invoices", {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.AXUZ_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
console.log(await res.json());

Python

import os
import requests

res = requests.request(
    "GET",
    "https://api-billing.axuz.net/v1/teams/TEAM_ID/billing/invoices",
    headers={
        "Authorization": f"Bearer {os.environ['AXUZ_TOKEN']}",
    },
    timeout=30,
)
res.raise_for_status()
print(res.json())