# SkuDefinition

Everything a tier gives a tenant apart from its prices: allowances, caps, concurrency, retention, discount, priority and capabilities. A contract keeps a copy taken when it was signed (or last renewed), so a catalogue change never alters a running term. Null on a limit means unlimited.

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `tier` | [`SkuTier`](https://docs.maitento.com/reference/types/sku-tier.md) |  |
| `sold` | `boolean` | Whether tenants can choose this tier themselves. Enterprise is set up by a platform admin. |
| `allowances` | [`MeterAllowances`](https://docs.maitento.com/reference/types/meter-allowances.md) |  |
| `storageCapGb` | `number \| null` | The most that can be stored at once before storage is charged, in GB (10^9 bytes). |
| `lanes` | [`LaneAllowance`](https://docs.maitento.com/reference/types/lane-allowance.md)`[]` | One entry per lane type. A lane type with no entry has no concurrency on this tier. |
| `maxPartitions` | `integer \| null` |  |
| `maxFileSystems` | `integer \| null` |  |
| `maxCredentials` | `integer \| null` |  |
| `maxCredentialStacks` | `integer \| null` |  |
| `retentionDefaultHours` | `integer` | How long finished runs are kept unless the tenant chooses otherwise. |
| `retentionMaxHours` | `integer \| null` | The longest a tenant may keep finished runs, retention leases included. |
| `overageDiscountBasisPoints` | `integer` | The discount on every overage charge, in basis points (1,500 = 15%). |
| `priority` | [`QueuePriorityClass`](https://docs.maitento.com/reference/types/queue-priority-class.md) |  |
| `premiumExecution` | `boolean` | Whether capsules and code pipelines can run at all. |
| `canTopUp` | `boolean` | Whether prepaid credit can be bought. Free can't: it stops at its allowance. |

## Example

```json
{
  "tier": "Free",
  "sold": false,
  "allowances": {
    "standardSeconds": 0,
    "premiumGiBSeconds": 0,
    "webSearchPages": 0,
    "webFetchUnits": 0
  },
  "storageCapGb": 0,
  "lanes": [
    {
      "lane": "Standard",
      "included": 0,
      "max": 0
    }
  ],
  "maxPartitions": 0,
  "maxFileSystems": 0,
  "maxCredentials": 0,
  "maxCredentialStacks": 0,
  "retentionDefaultHours": 0,
  "retentionMaxHours": 0,
  "overageDiscountBasisPoints": 0,
  "priority": "Spare",
  "premiumExecution": false,
  "canTopUp": false
}
```

## Where it's used

- Inside [`BillingCatalogueTier`](https://docs.maitento.com/reference/types/billing-catalogue-tier.md)