---
title: "Get the price catalogue"
url: https://docs.corefinity.com/api/reference/billing/get-billing-catalogue
type: endpoint
last_updated: 2026-11-13
feature: billing
related:
  - https://docs.corefinity.com/guides/billing/billing-overview.md
  - https://docs.corefinity.com/mcp/tools/corestack_billing_catalogue_get.md
---
# Get the price catalogue

Answers the packages on sale with their monthly prices, the add-ons with the price of one unit, the staging
environment sizes, the price modifiers (the Performance server type, the region) and the VAT that applies to
the account. Prices exclude VAT and are in the billing account's currency unless `currency` names another;
everyone who is signed in may read them. Someone who may not read the billing account, and a request whose
`account` is not one of your company's, is not refused: the prices are in pounds sterling unless `currency`
says otherwise, and the three fields of `vat` are `null`.

```http
GET /api/corestack/billing/catalogue
```

- Scope: `read`
- Two-factor: required on your account (all)
- Rate limit: 120 a minute
- Try it in the console: on

## Query parameters

- `account` (integer): The billing account to read, by its `id` (see `GET /corestack/billing/account`). Left out, the request acts on your company's default billing account. An account that does not exist and one that is not your company's answer the same 404.
- `account_id` (integer): The same as `account`, under the name the MCP tools use. Send one of the two: when they name different accounts the request is refused `422 invalid` on `account_id`.
- `product_line` (string): Only one line: `cs` for CoreStack packages, `cc` for CoreCluster packages.
- `region` (string): The region to price in, `uk` when left out.
- `currency` (string): The currency to price in. Left out, the billing account's.
- `platform` (string): A platform key, such as `wordpress`. The packages that cannot run it are moved to `hidden`. A key that is not a platform on offer is refused `422 invalid` on `platform`.

## Request

### curl

```bash
curl https://manage.corefinity.com/api/corestack/billing/catalogue \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
```

### PHP

```php
use Illuminate\Support\Facades\Http;

$response = Http::withToken(env('COREFINITY_TOKEN'))
    ->acceptJson()
    ->get('https://manage.corefinity.com/api/corestack/billing/catalogue');

$data = $response->json();
```

### Node

```javascript
const res = await fetch('https://manage.corefinity.com/api/corestack/billing/catalogue', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
    Accept: 'application/json',
  },
});

// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);
```

### Python

```python
import os
import requests

res = requests.get(
    "https://manage.corefinity.com/api/corestack/billing/catalogue",
    headers={
        "Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
        "Accept": "application/json",
    },
)

data = res.json() if res.content else None
```

## Responses

### 200 The catalogue.

```json
{
  "addons": [
    {
      "key": "core",
      "label": "Extra core",
      "max": 16,
      "monthly": {
        "amount": "45.00",
        "currency": "GBP"
      },
      "step": 1,
      "unit": "core",
      "unit_prices": {
        "cc": {
          "general": "45.000000",
          "optimised": "54.000000"
        },
        "cs": {
          "general": "45.000000",
          "optimised": "54.000000"
        }
      }
    },
    {
      "key": "memory_gb",
      "label": "Extra memory",
      "max": 64,
      "monthly": {
        "amount": "5.00",
        "currency": "GBP"
      },
      "step": 1,
      "unit": "GB",
      "unit_prices": {
        "cc": {
          "general": "5.000000",
          "optimised": "6.000000"
        },
        "cs": {
          "general": "5.000000",
          "optimised": "6.000000"
        }
      }
    }
  ],
  "compute_optimised": {
    "available": true,
    "label": "Performance",
    "product_lines": {
      "cc": {
        "available": true,
        "reason": null
      }
    },
    "reason": null
  },
  "currency": "GBP",
  "hidden": [],
  "modifiers": [
    {
      "applies_to": [
        "cs",
        "cc"
      ],
      "key": "compute_optimised",
      "label": "Performance",
      "scope": "compute_family",
      "value_percent": "20"
    },
    {
      "applies_to": [
        "cs",
        "cc"
      ],
      "key": "region_uk",
      "label": "United Kingdom",
      "scope": "region",
      "value_percent": "0"
    }
  ],
  "packages": [
    {
      "code": "CC4",
      "cores": 4,
      "disk_gb": 200,
      "included_uat": null,
      "key": "cc4",
      "log_quota_gb": 250,
      "log_retention_days": 90,
      "memory_gib": 16,
      "money_back_days": 0,
      "monthly": {
        "amount": "300.00",
        "currency": "GBP"
      },
      "monthly_optimised": {
        "amount": "360.00",
        "currency": "GBP"
      },
      "name": "CoreCluster CC4",
      "platforms_allowed": [
        "wordpress",
        "laravel",
        "magento2"
      ],
      "product_line": "cc",
      "tiers": [
        "S",
        "M",
        "L"
      ],
      "trial_days": 0
    },
    {
      "code": "CC6",
      "cores": 6,
      "disk_gb": 300,
      "included_uat": null,
      "key": "cc6",
      "log_quota_gb": 300,
      "log_retention_days": 90,
      "memory_gib": 24,
      "money_back_days": 0,
      "monthly": {
        "amount": "450.00",
        "currency": "GBP"
      },
      "monthly_optimised": {
        "amount": "540.00",
        "currency": "GBP"
      },
      "name": "CoreCluster CC6",
      "platforms_allowed": [
        "wordpress",
        "laravel",
        "magento2"
      ],
      "product_line": "cc",
      "tiers": [
        "S",
        "M",
        "L"
      ],
      "trial_days": 0
    }
  ],
  "platform": null,
  "region": "uk",
  "uat_sizes": [
    {
      "cores": 0.5,
      "disk_gb": 20,
      "key": "xsmall",
      "label": "Extra small",
      "memory_gib": 2,
      "monthly": {
        "amount": "40.00",
        "currency": "GBP"
      }
    },
    {
      "cores": 1,
      "disk_gb": 50,
      "key": "small",
      "label": "Small",
      "memory_gib": 4,
      "monthly": {
        "amount": "75.00",
        "currency": "GBP"
      }
    }
  ],
  "vat": {
    "country": "GB",
    "kind": "standard",
    "rate_percent": 20
  }
}
```

### 401 No token, or a token that is not valid.

```json
{
  "message": "Unauthenticated."
}
```

### 403 The token lacks the scope (`scope_required`, with the `scope` to use), or your company requires two-factor authentication and you have not set it up. For routes outside Managed Clusters.

```json
{
  "code": "company_unavailable",
  "message": "Your company is unavailable.",
  "reason": "company_unavailable"
}
```

### 404 Billing is not on for your company (`feature_off`). An `account` you may not read is not a 404 here; the catalogue is answered without it.

```json
{
  "code": "feature_off",
  "message": "Not found.",
  "reason": "feature_off"
}
```

### 422 `zone_unknown`: the region is not one that is priced. `currency_unpublished`: there are no prices in the currency at the moment. `invalid`: a parameter is wrong (`field` names it), or `account` and `account_id` name different billing accounts.

```json
{
  "code": "invalid",
  "errors": {
    "account_id": [
      "Send account or account_id, not both: they name different billing accounts."
    ]
  },
  "field": "account_id",
  "message": "Send account or account_id, not both: they name different billing accounts.",
  "reason": "invalid"
}
```

### 429 Too many requests (`rate_limited`). Wait for the number of seconds in `Retry-After`, which `retry_after_seconds` repeats.

```json
{
  "code": "rate_limited",
  "message": "Too many requests. Try again in 60 seconds.",
  "reason": "rate_limited",
  "retry_after_seconds": 60
}
```

## If it is refused

| Status | Reason | What to do |
|---|---|---|
| 401 |  | Send a valid token as `Authorization: Bearer <token>`. |
| 403 | `company_unavailable` | Your company is unavailable. |
| 403 | `scope_required` | Use a token with the scope named in `scope`. |
| 403 | `two_factor_required` | Turn on two-factor on your account, then send again. |
| 404 | `feature_off` | This feature is not on for your organisation yet. |
| 422 | `invalid` | Fix the field named in `field`; `errors` says why. |
| 422 | `currency_unpublished` | Prices in that currency are not available right now. Choose another currency, or try again later. |
| 422 | `zone_unknown` | That is not a region. Choose uk, us, nl or aus. |
| 429 | `rate_limited` | Wait for the seconds in `Retry-After`. |

## The same task elsewhere

- Guide: [Billing](https://docs.corefinity.com/guides/billing/billing-overview.md)
- MCP tool: [`corestack_billing_catalogue_get`](https://docs.corefinity.com/mcp/tools/corestack_billing_catalogue_get.md)
