# Billing

> The Billing object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `workspace_id` * | string |  |
| `plan` * | [WorkspacePlan](/docs/api/objects/workspace-plan/) |  |
| `plan_fee` * | [Money](/docs/api/objects/money/) |  |
| `included_usage` | [Money](/docs/api/objects/money/) |  |
| `payment_method` | object or null |  |
| `credit_balance` | [Money](/docs/api/objects/money/) |  |
| `next_invoice_estimate` | [Money](/docs/api/objects/money/) |  |
| `vat_number` | string or null |  |
| `status` | `ok`, `past_due`, `unpaid` |  |

\* always present

## Example

```json
{
  "workspace_id": "string",
  "plan": "trial",
  "plan_fee": {
    "amount": "7.42",
    "currency": "GBP",
    "display": "£7.42"
  },
  "included_usage": {
    "amount": "7.42",
    "currency": "GBP",
    "display": "£7.42"
  },
  "payment_method": {
    "brand": "string",
    "last4": "string",
    "exp_month": 1,
    "exp_year": 1
  },
  "credit_balance": {
    "amount": "7.42",
    "currency": "GBP",
    "display": "£7.42"
  },
  "next_invoice_estimate": {
    "amount": "7.42",
    "currency": "GBP",
    "display": "£7.42"
  },
  "vat_number": "string",
  "status": "ok"
}
```

## Used by

- [Plan, payment method and balance](/docs/api/spend/#plan-payment-method-and-balance)
- [Change plan](/docs/api/spend/#change-plan)