Offers

Offers are the instant servers in stock right now, with their specs, prices and OS choices. Pick one here before you order. Needs the read permission.

List offers

GET /offers returns every instant server your account can order now. The list is not paged.

curlTypeScriptPythonGo

curl -sS https://api.redswitches.com/v1/offers \
  -H "Authorization: Bearer $REDSWITCHES_API_KEY"

const { data: offers } = await rs.offers.list();
const amsterdam = offers.filter((o) => o.location?.city === "Amsterdam");

offers = client.offers.list().data
amsterdam = [o for o in offers if o.location and o.location.city == "Amsterdam"]

offers, err := client.Offers.List(ctx)
if err != nil {
	log.Fatal(err)
}
for _, o := range offers.Data {
	fmt.Println(o.ID, o.Name, o.Stock)
}

{
  "data": [
    {
      "id": "ofr_12",
      "name": "Instant Dedicated Server E-2388G",
      "location": { "city": "Amsterdam", "country": "NL" },
      "cpu": "Intel Xeon E-2388G (8 cores, 3.2 GHz)",
      "ram": "64 GB DDR4",
      "disks": "2 x 960 GB NVMe SSD",
      "port_speed": "1 Gbps",
      "traffic": "50 TB",
      "currency": "USD",
      "prices": [
        { "cycle": "monthly", "price": "129.00", "setup": "0.00" },
        { "cycle": "annually", "price": "1393.20", "setup": "0.00" }
      ],
      "os": [
        { "id": "os_31", "name": "Ubuntu 24.04" },
        { "id": "os_32", "name": "Debian 12" }
      ],
      "stock": "5+",
      "as_of": "2026-11-15T09:30:00Z"
    }
  ]
}

Get one offer

GET /offers/{id} returns one offer of the same list. An offer that is not on your list now (sold out, withdrawn, or never offered to you) is 404 not_found.

curlTypeScriptPythonGo

curl -sS https://api.redswitches.com/v1/offers/ofr_12 \
  -H "Authorization: Bearer $REDSWITCHES_API_KEY"

const offer = await rs.offers.get("ofr_12");

offer = client.offers.get("ofr_12")

offer, err := client.Offers.Get(ctx, "ofr_12")

{
  "id": "ofr_12",
  "name": "Instant Dedicated Server E-2388G",
  "location": { "city": "Amsterdam", "country": "NL" },
  "cpu": "Intel Xeon E-2388G (8 cores, 3.2 GHz)",
  "ram": "64 GB DDR4",
  "disks": "2 x 960 GB NVMe SSD",
  "port_speed": "1 Gbps",
  "traffic": "50 TB",
  "currency": "USD",
  "prices": [{ "cycle": "monthly", "price": "129.00", "setup": "0.00" }],
  "os": [{ "id": "os_31", "name": "Ubuntu 24.04" }],
  "stock": 3,
  "as_of": "2026-11-15T09:30:00Z"
}

Fields

Field	Type	Meaning
`id`	string	The offer id, `ofr_<n>`. Use it as `offer_id` when ordering.
`name`	string	The product name, as the client area shows it.
`location`	object or null	`city`, and `country` as a two-letter code (or null).
`cpu`	string or null	The CPU model. Null when unknown.
`ram`, `disks`, `port_speed`, `traffic`	string or null	The specs as the client area words them.
`currency`	string	Your account's currency.
`prices`	array	One entry per billing cycle: `cycle` (`monthly`, `quarterly`, `semiannually`, `annually`, `biennially` or `triennially`), `price` and `setup` as decimal strings.
`os`	array	The operating systems you can choose: `id` (`os_<n>`) and `name`. Use the `id` as `os_id` when ordering.
`stock`	number or string	`1` to `4`, or `"5+"`. The exact count above five is not shown.
`as_of`	string	When this list was read (UTC).

Prices

Prices are for the default configuration, per billing cycle, before tax, in your account's currency.
setup is the one-time fee for that cycle.
Orders through the API are monthly only. The other cycles are shown for comparison.
The order total you pay includes tax and setup. Get the exact figure with a dry run before you order.

Freshness

The list is rebuilt at most every 30 seconds. Stock can change between reading an offer and ordering it: an order then answers 409 sold_out and nothing is charged.