Factures

Obtenir une facture

GET/v1/billing/invoices/{id}

Obtient une facture avec ses articles et transactions.

curl --request GET \
  --url https://api.serverside.com/v1/billing/invoices/{id} \
  --header 'Authorization: Bearer <api-key>'

{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "createdAt": "2026-01-15T09:30:00Z",
    "dueDate": "2026-01-15T09:30:00Z",
    "status": "UNPAID",
    "type": "STANDARD",
    "currency": "<string>",
    "invoiceNumber": 123,
    "orderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "billedFrom": {
      "name": "<string>",
      "address1": "<string>",
      "address2": "<string>",
      "city": "<string>",
      "region": "<string>",
      "postalCode": "<string>",
      "countryCode": "<string>",
      "vatNumber": "<string>",
      "emailAddress": "<string>",
      "phoneNumber": "<string>"
    },
    "billedTo": {
      "name": "<string>",
      "address1": "<string>",
      "address2": "<string>",
      "city": "<string>",
      "region": "<string>",
      "postalCode": "<string>",
      "countryCode": "<string>",
      "vatNumber": "<string>",
      "emailAddress": "<string>",
      "phoneNumber": "<string>"
    },
    "taxBreakdown": [
      {
        "name": "<string>",
        "rate": 123,
        "amount": 123,
        "taxId": "<string>"
      }
    ],
    "items": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "title": "<string>",
        "subscriptionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "periodStart": "2026-01-15T09:30:00Z",
        "periodEnd": "2026-01-15T09:30:00Z",
        "subtotal": 123,
        "discount": 123,
        "taxTreatment": "STANDARD",
        "taxRate": 123,
        "taxAmount": 123,
        "total": 123
      }
    ],
    "transactions": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "transactionReference": "<string>",
        "amount": 123,
        "currency": "<string>",
        "createdAt": "2026-01-15T09:30:00Z",
        "paymentProvider": "STRIPE",
        "status": "PENDING"
      }
    ],
    "subtotal": 123,
    "discount": 123,
    "taxes": 123,
    "total": 123,
    "amountDue": 123
  }
}

Autorisations

Authorizationstringheaderobligatoire
Clé API d’organisation (org_...), créée dans la console cloud sur https://cloud.serverside.com et affichée une seule fois, envoyée comme Authorization: Bearer <key>. Elle authentifie l’organisation.

Permission requise : organization.billing.read

Paramètres de chemin

idstring<uuid>obligatoire

Réponse

200 · application/json

OK

successbooleanobligatoire
Valeurs autorisées :true
dataobject | nullobligatoire