# The Contract object

### The Contract object

```json
{
  "id": "ctrct_test_61SIqALsEreXk4vb616S0Sp34rSQ5rdid9OCzVKXYQrI",
  "object": "v2.billing.contract",
  "status": "draft",
  "created": "2025-01-01T10:00:00.000Z",
  "currency": "usd",
  "contract_number": "C-2026-0001",
  "pricing_lines": {
    "data": []
  },
  "pricing_overrides": {
    "data": []
  },
  "customer": "cus_61SIqALsEreXk4vb616S0Sp34rSQ5rdi",
  "metadata": {},
  "billing_settings": {
    "billing_profile_details": {
      "customer": "cus_61SIqALsEreXk4vb616S0Sp34rSQ5rdi"
    },
    "collection_settings_details": {
      "collection_method": "send_invoice"
    }
  },
  "collection_status": "current",
  "collection_status_transitions": {
    "current_at": "2025-01-01T10:00:00.000Z"
  }
}
```

## Attributes

- `id` (string)
  The contract id.

- `object` (string, value is "v2.billing.contract")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- [`billing_cycle_anchor`](https://docs.stripe.com/api/v2/billing-contracts/contracts/object.md?query=billing_cycle_anchor) (object, nullable)
  The billing cycle anchor.

- [`billing_settings`](https://docs.stripe.com/api/v2/billing-contracts/contracts/object.md?query=billing_settings) (object, nullable)
  The billing settings.

- `contract_number` (string)
  A unique user-provided contract number e.g. C-2026-0001.

- `created` (timestamp)
  Timestamp of when the contract was created.

- `currency` (string)
  The currency.

- `customer` (string)
  The customer id.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `metadata` (map, nullable)
  Set of key-value pairs.

- [`pricing_lines`](https://docs.stripe.com/api/v2/billing-contracts/contracts/object.md?query=pricing_lines) (object, nullable)
  The pricing lines. Only populated when `pricing_lines` is passed in the `include` parameter.

- [`pricing_overrides`](https://docs.stripe.com/api/v2/billing-contracts/contracts/object.md?query=pricing_overrides) (object, nullable)
  The pricing overrides. Only populated when `pricing_overrides` is passed in the `include` parameter.

- `status` (enum)
  The current status of the contract.
Possible enum values:
  - `active`
    Contract is active and will bill automatically.

  - `canceled`
    Contract was canceled.

  - `draft`
    Contract is in draft and will not bill until activated.

  - `ended`
    Contract has reached its end date.

- [`status_transitions`](https://docs.stripe.com/api/v2/billing-contracts/contracts/object.md?query=status_transitions) (object, nullable)
  Historical timestamps of when the contract transitioned into each status.