Account

Retrieve account billing details

Return the subscription billing snapshot of the company: base plan, additional NIF subscription and default payment method.

  • The additional NIF subscription is null without additional tax IDs.
  • A tax ID paid by another account gets managed: true, plan gestionada, no payment data.
  • Amounts are 2-decimal euro strings; unresolved ones are null.
get/companies/{company}/billing

Request

  • Base URL: https://api.factuarea.com/v1
  • URL: https://api.factuarea.com/v1/companies/{company}/billing
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

Headers

Factuarea-Versionstring date
Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

Example response

{
  "data": {
    "object": "account_billing",
    "plan": {
      "slug": "empresario",
      "name": "Profesional",
      "status": "active",
      "billing_interval": "month",
      "current_period_end": "2026-08-01T09:12:00+00:00",
      "pending_change": {
        "slug": "emprendedor",
        "name": "Esencial",
        "effective_at": "2026-08-01T09:12:00+00:00",
        "billing_interval": "month"
      }
    },
    "gestoria_seats": {
      "status": "active",
      "quantity": 4,
      "active_companies": 4,
      "unit_amount": "15.00",
      "tax_rate": 21,
      "tax_amount": "3.15",
      "total_per_seat": "18.15",
      "recurring_total": "72.60",
      "currency": "EUR",
      "billing_interval": "month",
      "next_invoice_at": "2026-07-15T10:00:00+00:00"
    },
    "payment_method": {
      "brand": "visa",
      "last_four": "4242"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.