# Get the price list

`GET https://api.parasend.com/v1/billing/prices`

Source: https://parasend.com/docs/api/billing/prices

Authentication: `Authorization: Bearer <API key>` (a `ps_test_` key in test mode, `ps_live_` in live mode).

The public self-serve prices on a date (default today), excluding VAT: the three self-serve doors (pay as you go, plans 500 / 1,000 / 5,000) and the per-use prices that are the same on every plan. Enterprise levels are contract data and never listed. Any signed-in member or API key may read it. `price_list_not_found` (404) when no list is in effect for the currency on that date (there is no EUR list yet).

## Query parameters

- `currency` (string, optional): One of: `ISK`, `EUR`. Default: `"ISK"`.
- `on` (string · date, optional): YYYY-MM-DD; default today (UTC = Iceland).

## Example: Get the price list

```bash
curl "https://api.parasend.com/v1/billing/prices" \
  -H "Authorization: Bearer $PARASEND_KEY"
```

```js
const res = await fetch('https://api.parasend.com/v1/billing/prices', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
  },
});
const data = await res.json();
```

## Response 200

The price list.

```json
{
  "object": "price_list",
  "currency": "ISK",
  "on": "2026-11-06",
  "prices_exclude_vat": true,
  "vat_percent": 24,
  "plans": [
    {
      "plan": "payg",
      "door": 1,
      "rails": [
        "card"
      ],
      "monthly_fee": null,
      "included_deliveries": null,
      "delivery_price": 311,
      "request_price": 311
    },
    {
      "plan": "p500",
      "door": 2,
      "rails": [
        "card",
        "bank_claim"
      ],
      "monthly_fee": 143500,
      "included_deliveries": 500,
      "delivery_price": 287,
      "request_price": 287
    },
    {
      "plan": "p1000",
      "door": 2,
      "rails": [
        "card",
        "bank_claim"
      ],
      "monthly_fee": 263000,
      "included_deliveries": 1000,
      "delivery_price": 263,
      "request_price": 263
    },
    {
      "plan": "p5000",
      "door": 2,
      "rails": [
        "card",
        "bank_claim"
      ],
      "monthly_fee": 1200000,
      "included_deliveries": 5000,
      "delivery_price": 240,
      "request_price": 240
    }
  ],
  "per_use": [
    {
      "product": "PS-SECRET",
      "unit_amount": 39
    },
    {
      "product": "PS-QUAL",
      "unit_amount": 340
    },
    {
      "product": "PS-EID",
      "unit_amount": 29
    },
    {
      "product": "PS-SMS-IS",
      "unit_amount": 25
    },
    {
      "product": "PS-VIDEO",
      "unit_amount": 215
    }
  ],
  "sms_international": [
    {
      "country": "AD",
      "unit_amount": 50
    },
    {
      "country": "AG",
      "unit_amount": 50
    },
    {
      "country": "AI",
      "unit_amount": 25
    },
    {
      "country": "AL",
      "unit_amount": 50
    },
    {
      "country": "AO",
      "unit_amount": 25
    },
    {
      "country": "AT",
      "unit_amount": 50
    },
    {
      "country": "BG",
      "unit_amount": 50
    },
    {
      "country": "BH",
      "unit_amount": 25
    },
    {
      "country": "BN",
      "unit_amount": 25
    },
    {
      "country": "BO",
      "unit_amount": 50
    },
    {
      "country": "BW",
      "unit_amount": 50
    },
    {
      "country": "CH",
      "unit_amount": 25
    },
    {
      "country": "CK",
      "unit_amount": 50
    },
    {
      "country": "CV",
      "unit_amount": 50
    },
    {
      "country": "CY",
      "unit_amount": 25
    },
    {
      "country": "CZ",
      "unit_amount": 25
    },
    {
      "country": "DE",
      "unit_amount": 50
    },
    {
      "country": "DJ",
      "unit_amount": 50
    },
    {
      "country": "DK",
      "unit_amount": 25
    },
    {
      "country": "EE",
      "unit_amount": 25
    },
    {
      "country": "ER",
      "unit_amount": 50
    },
    {
      "country": "FI",
      "unit_amount": 50
    },
    {
      "country": "FO",
      "unit_amount": 25
    },
    {
      "country": "FR",
      "unit_amount": 25
    },
    {
      "country": "GE",
      "unit_amount": 50
    },
    {
      "country": "GF",
      "unit_amount": 50
    },
    {
      "country": "GG",
      "unit_amount": 25
    },
    {
      "country": "GI",
      "unit_amount": 25
    },
    {
      "country": "GL",
      "unit_amount": 25
    },
    {
      "country": "GP",
      "unit_amount": 50
    },
    {
      "country": "GR",
      "unit_amount": 25
    },
    {
      "country": "GY",
      "unit_amount": 50
    },
    {
      "country": "HK",
      "unit_amount": 25
    },
    {
      "country": "HR",
      "unit_amount": 50
    },
    {
      "country": "IM",
      "unit_amount": 25
    },
    {
      "country": "IT",
      "unit_amount": 25
    },
    {
      "country": "JE",
      "unit_amount": 25
    },
    {
      "country": "JM",
      "unit_amount": 50
    },
    {
      "country": "JP",
      "unit_amount": 25
    },
    {
      "country": "LI",
      "unit_amount": 25
    },
    {
      "country": "LT",
      "unit_amount": 25
    },
    {
      "country": "LU",
      "unit_amount": 25
    },
    {
      "country": "LV",
      "unit_amount": 25
    },
    {
      "country": "MD",
      "unit_amount": 50
    },
    {
      "country": "ME",
      "unit_amount": 50
    },
    {
      "country": "MK",
      "unit_amount": 25
    },
    {
      "country": "MO",
      "unit_amount": 25
    },
    {
      "country": "MQ",
      "unit_amount": 50
    },
    {
      "country": "MS",
      "unit_amount": 25
    },
    {
      "country": "MT",
      "unit_amount": 25
    },
    {
      "country": "MU",
      "unit_amount": 50
    },
    {
      "country": "MX",
      "unit_amount": 25
    },
    {
      "country": "NA",
      "unit_amount": 25
    },
    {
      "country": "NC",
      "unit_amount": 50
    },
    {
      "country": "NF",
      "unit_amount": 25
    },
    {
      "country": "NL",
      "unit_amount": 50
    },
    {
      "country": "NO",
      "unit_amount": 25
    },
    {
      "country": "NU",
      "unit_amount": 50
    },
    {
      "country": "PA",
      "unit_amount": 50
    },
    {
      "country": "PF",
      "unit_amount": 50
    },
    {
      "country": "PL",
      "unit_amount": 25
    },
    {
      "country": "PT",
      "unit_amount": 25
    },
    {
      "country": "PW",
      "unit_amount": 25
    },
    {
      "country": "RE",
      "unit_amount": 50
    },
    {
      "country": "RO",
      "unit_amount": 25
    },
    {
      "country": "SB",
      "unit_amount": 25
    },
    {
      "country": "SE",
      "unit_amount": 25
    },
    {
      "country": "SI",
      "unit_amount": 50
    },
    {
      "country": "SK",
      "unit_amount": 25
    },
    {
      "country": "SM",
      "unit_amount": 50
    },
    {
      "country": "SR",
      "unit_amount": 50
    },
    {
      "country": "ST",
      "unit_amount": 50
    },
    {
      "country": "TL",
      "unit_amount": 50
    },
    {
      "country": "TO",
      "unit_amount": 50
    },
    {
      "country": "TV",
      "unit_amount": 25
    },
    {
      "country": "UA",
      "unit_amount": 50
    },
    {
      "country": "VU",
      "unit_amount": 50
    },
    {
      "country": "WS",
      "unit_amount": 50
    }
  ]
}
```

Errors: one shape, `{"error": {type, code, message, param, request_id}}`; every code is listed at https://parasend.com/docs/errors.