{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/api-reference/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["api-container","api-content","endpoint","api-examples","code-group","tabs","tab"]},"redocly_category":"API Reference","searchWeight":120,"type":"markdown"},"seo":{"title":"Get offering options","description":"Complete API reference and documentation for Freddy AI-powered backend system by Aitronos","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"get-offering-options","__idx":0},"children":["Get offering options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lists what can be ordered from one offering — its locations, its sizes with a price per location, the location and size to preselect, the price of a parked server — and every word the create form shows: the labels, the proposed server name, each choice's summary and button text, and the lines under the button. A client renders these strings as they are and builds none itself. Show the person the price of the location and size they pick, then send that price back as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quote"]}," of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/create-host"},"children":["Create a server"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Free sizing (Aitronos servers)."]}," Besides the fixed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sizes"]},", vCPU and memory can be picked separately from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cpu_choices"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memory_choices"]},". The server is then the cheapest one in the location with at least that many vCPUs and at least that much memory; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resolutions"]}," holds that answer for every offered pair, so look it up rather than computing it, and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/resolve-offering-size"},"children":["Resolve a free size"]}," answers any other pair. When no server has both, the entry's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["machine_type_id"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," and its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["note"]}," names the largest server there."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Aitronos servers"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aitronos"]},") the locations are regions labelled by country, the sizes are Aitronos size classes, and each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hourly"]}," is what your organization is charged per started hour, in CHF, excluding VAT, with your organization's individual agreement already applied. For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["your own account"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["byo"]},") the locations, sizes and prices are the provider's own, in the provider's currency, read with your connected account and cached for 10 minutes; the provider bills you for them. A price that cannot be read right now is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price_verified: false"]},", never ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},", and such a size cannot be created until it can."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It acts for a person: it requires a bearer token whose user holds the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use_forge"]}," capability in the acting organization, and Forge cloud compute switched on for the organization."]},{"$$mdtype":"Tag","name":"ApiContainer","attributes":{},"children":[{"$$mdtype":"Tag","name":"ApiContent","attributes":{},"children":[{"$$mdtype":"Tag","name":"Endpoint","attributes":{"method":"GET","path":"https://api.aitronos.com/v1/forge/compute/offerings/{offering_id}/options"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"path-parameters","__idx":1},"children":["Path Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offering_id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#ef4444 !important","fontWeight":"600 !important","fontStyle":"normal !important"}},"children":["required"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The offering ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-offerings"},"children":["List compute offerings"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aitronos"]},", or a bring-your-own provider such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hetzner"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["digitalocean"]},". 1 to 64 characters."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"query-parameters","__idx":2},"children":["Query Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The organization to act in. Defaults to your current organization. You must be an active member of it, or the request is refused with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403 ORGANIZATION_ACCESS_DENIED"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"headers","__idx":3},"children":["Headers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Organization-Id"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The same as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id"]},", as a header. When both are sent, the query parameter wins."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"returns","__idx":4},"children":["Returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["catalog_version"]}]}," string — send it back inside the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quote"]}," of a create or resume."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}]}," string — the offering's name to show over the form, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Aitronos servers"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]}," string or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," — one line under the title."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["free_sizing"]}]}," boolean — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," when vCPU and memory can be picked separately (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["machine_types"]}," is not empty). Aitronos servers only."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]}]}," object — every label of the create form: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cpu"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memory"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["change"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancel"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["creating"]}," (the button while the request runs), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["alternatives"]}," (the heading over other choices after a refusal), and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name_max_length"]}," (63)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]}," string — ISO 4217 code of every price in the response: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CHF"]}," for Aitronos servers, the provider's own currency for your own account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price_source"]}]}," string — who sets and bills the prices: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aitronos"]}," (billed to your organization), or the offering id of the provider that bills you."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locations"]}]}," array — where servers can run, each with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["detail"]}," (a second line, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}," (ISO 3166-1 alpha-2), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["available"]}," (at least one size can be ordered there now), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["option_label"]}," (the text of the location picker's entry, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Finland · Not available here"]},") and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proposed_name"]}," (the server name to propose while this location is selected: the location's name and the lowest number none of your organization's servers uses, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["germany-2"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sizes"]}]}," array — smallest first, each with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vcpu"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memory_gb"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["disk_gb"]}," (or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arch"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x86_64"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["arm64"]},"), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dedicated_cpu"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prices"]},": one entry per location the size is offered in, with:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location_id"]}]}," string — the location the price applies to."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hourly"]}]}," string or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," — price per started hour as a decimal string in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]},", excluding VAT; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when it could not be read."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["monthly_cap"]}]}," string or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," — the most one server of this size is charged in a calendar month."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["includes_vat"]}]}," boolean — always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["available"]}]}," boolean — the size can be ordered in this location now."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price_verified"]}]}," boolean — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hourly"]}," could not be read."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["summary"]}]}," string — the choice in one line, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["16 vCPU · 64 GB · Germany"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["option_label"]}]}," string — the text of the size picker's entry, with its price or why it cannot be ordered."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}]}," string — why this choice cannot be created right now; present only then."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["button_label"]}]}," string — the create button for this choice, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Create · 16 vCPU · 64 GB · Germany · CHF 0.83/h, at most CHF 520.30/month"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["can_create"]}]}," boolean — whether the create button is enabled for this choice."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["machine_types"]}]}," array — free sizing: every server that can be picked by vCPU and memory, smallest first, in the same shape as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sizes"]},". A machine type of the same vCPU and memory as a size has that size's id (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["std-16"]},"); the others are named after their shape (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ded-x86-48c-192g"]},"). Empty for a bring-your-own offering."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cpu_choices"]}]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memory_choices"]}]}," arrays — free sizing: the values to offer, each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{value, label}"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{\"value\": 16, \"label\": \"16 vCPU\"}"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{\"value\": 64, \"label\": \"64 GB\"}"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resolutions"]}]}," array — free sizing: for every location × ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cpu_choices"]}," value × ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memory_choices"]}," value, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{location_id, vcpu, memory_gb, machine_type_id, note}"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["machine_type_id"]}," is the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["machine_types"]}," entry to create (its price is in that entry), or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when no server there has both; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["note"]}," is a sentence to show (why a larger server was chosen, or the largest server there), or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," for an exact match."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["defaults"]}]}," object — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["size_id"]}," to preselect (each may be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"); ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", the server name to propose for that location; and for free sizing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vcpu"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memory_gb"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["machine_type_id"]}," to preselect (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," without free sizing)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parked_storage"]}]}," object — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["per_gb_month"]}," (price per GB of a parked server per month as a decimal string, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when it is not charged this way or unknown) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["note"]}," (how parking works for this offering)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notes"]}]}," array of strings — sentences to show next to the prices."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["footer_notes"]}]}," array — the lines to show under the create button, in order, each ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{id, text}"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billed_to"]}," (who is billed), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auto_park"]}," (after how many idle hours a server parks itself, from your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-settings"},"children":["compute settings"]},"; left out when it never does), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["park"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connected_as"]}," (bring-your-own), then ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["note_1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["note_2"]},", … (the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notes"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Abbreviated: one of the four sizes, one of the six machine types and two of the 72 resolutions."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"catalog_version\": \"fc-3b8e1f0a9c42\",\n  \"currency\": \"CHF\",\n  \"price_source\": \"aitronos\",\n  \"title\": \"Aitronos servers\",\n  \"description\": \"Billed to your organization as Forge cloud compute.\",\n  \"free_sizing\": true,\n  \"fields\": {\n    \"location\": \"Location\",\n    \"size\": \"Size\",\n    \"cpu\": \"CPU\",\n    \"memory\": \"Memory\",\n    \"name\": \"Name\",\n    \"change\": \"Change\",\n    \"cancel\": \"Cancel\",\n    \"create\": \"Create\",\n    \"creating\": \"Creating…\",\n    \"alternatives\": \"Available instead\",\n    \"name_max_length\": 63\n  },\n  \"locations\": [\n    {\n      \"id\": \"eu-central\",\n      \"label\": \"Germany\",\n      \"detail\": \"Falkenstein or Nuremberg\",\n      \"country\": \"DE\",\n      \"available\": true,\n      \"order\": 0,\n      \"option_label\": \"Germany\",\n      \"proposed_name\": \"germany-1\"\n    },\n    {\n      \"id\": \"eu-north\",\n      \"label\": \"Finland\",\n      \"detail\": \"Helsinki\",\n      \"country\": \"FI\",\n      \"available\": true,\n      \"order\": 1,\n      \"option_label\": \"Finland\",\n      \"proposed_name\": \"finland-1\"\n    }\n  ],\n  \"sizes\": [\n    {\n      \"id\": \"std-16\",\n      \"label\": \"16 vCPU · 64 GB\",\n      \"vcpu\": 16,\n      \"memory_gb\": 64,\n      \"disk_gb\": 360,\n      \"arch\": \"x86_64\",\n      \"dedicated_cpu\": true,\n      \"order\": 2,\n      \"prices\": [\n        {\n          \"location_id\": \"eu-central\",\n          \"hourly\": \"0.83\",\n          \"monthly_cap\": \"520.30\",\n          \"includes_vat\": false,\n          \"available\": true,\n          \"price_verified\": true,\n          \"summary\": \"16 vCPU · 64 GB · Germany\",\n          \"option_label\": \"16 vCPU · 64 GB · CHF 0.83/h\",\n          \"button_label\": \"Create · 16 vCPU · 64 GB · Germany · CHF 0.83/h, at most CHF 520.30/month\",\n          \"can_create\": true\n        },\n        {\n          \"location_id\": \"eu-north\",\n          \"hourly\": \"0.83\",\n          \"monthly_cap\": \"520.30\",\n          \"includes_vat\": false,\n          \"available\": true,\n          \"price_verified\": true,\n          \"summary\": \"16 vCPU · 64 GB · Finland\",\n          \"option_label\": \"16 vCPU · 64 GB · CHF 0.83/h\",\n          \"button_label\": \"Create · 16 vCPU · 64 GB · Finland · CHF 0.83/h, at most CHF 520.30/month\",\n          \"can_create\": true\n        }\n      ]\n    }\n  ],\n  \"machine_types\": [\n    {\n      \"id\": \"ded-x86-48c-192g\",\n      \"label\": \"48 vCPU · 192 GB\",\n      \"vcpu\": 48,\n      \"memory_gb\": 192,\n      \"disk_gb\": 960,\n      \"arch\": \"x86_64\",\n      \"dedicated_cpu\": true,\n      \"order\": 5,\n      \"prices\": [\n        {\n          \"location_id\": \"eu-central\",\n          \"hourly\": \"2.58\",\n          \"monthly_cap\": \"1607.04\",\n          \"includes_vat\": false,\n          \"available\": true,\n          \"price_verified\": true,\n          \"summary\": \"48 vCPU · 192 GB · Germany\",\n          \"option_label\": \"48 vCPU · 192 GB · CHF 2.58/h\",\n          \"button_label\": \"Create · 48 vCPU · 192 GB · Germany · CHF 2.58/h, at most CHF 1,607.04/month\",\n          \"can_create\": true\n        },\n        {\n          \"location_id\": \"eu-north\",\n          \"hourly\": \"2.58\",\n          \"monthly_cap\": \"1607.04\",\n          \"includes_vat\": false,\n          \"available\": true,\n          \"price_verified\": true,\n          \"summary\": \"48 vCPU · 192 GB · Finland\",\n          \"option_label\": \"48 vCPU · 192 GB · CHF 2.58/h\",\n          \"button_label\": \"Create · 48 vCPU · 192 GB · Finland · CHF 2.58/h, at most CHF 1,607.04/month\",\n          \"can_create\": true\n        }\n      ]\n    }\n  ],\n  \"cpu_choices\": [\n    {\"value\": 2, \"label\": \"2 vCPU\"},\n    {\"value\": 4, \"label\": \"4 vCPU\"},\n    {\"value\": 8, \"label\": \"8 vCPU\"},\n    {\"value\": 16, \"label\": \"16 vCPU\"},\n    {\"value\": 32, \"label\": \"32 vCPU\"},\n    {\"value\": 48, \"label\": \"48 vCPU\"}\n  ],\n  \"memory_choices\": [\n    {\"value\": 8, \"label\": \"8 GB\"},\n    {\"value\": 16, \"label\": \"16 GB\"},\n    {\"value\": 32, \"label\": \"32 GB\"},\n    {\"value\": 64, \"label\": \"64 GB\"},\n    {\"value\": 128, \"label\": \"128 GB\"},\n    {\"value\": 192, \"label\": \"192 GB\"}\n  ],\n  \"resolutions\": [\n    {\"location_id\": \"eu-central\", \"vcpu\": 16, \"memory_gb\": 64, \"machine_type_id\": \"std-16\", \"note\": null},\n    {\n      \"location_id\": \"eu-central\",\n      \"vcpu\": 16,\n      \"memory_gb\": 192,\n      \"machine_type_id\": \"ded-x86-48c-192g\",\n      \"note\": \"No server in Germany has exactly 16 vCPU and 192 GB, so this is the cheapest one with at least that much.\"\n    }\n  ],\n  \"defaults\": {\n    \"location_id\": \"eu-central\",\n    \"size_id\": \"std-16\",\n    \"name\": \"germany-1\",\n    \"vcpu\": 16,\n    \"memory_gb\": 64,\n    \"machine_type_id\": \"std-16\"\n  },\n  \"parked_storage\": {\"per_gb_month\": \"0.0269\", \"note\": \"A parked server is stored as a snapshot.\"},\n  \"notes\": [\"Billed per started hour, never more than the monthly cap.\", \"Prices exclude VAT.\"],\n  \"footer_notes\": [\n    {\n      \"id\": \"billed_to\",\n      \"text\": \"Billed to Acme AG as Forge cloud compute. Park keeps your work and stops the compute charge.\"\n    },\n    {\"id\": \"auto_park\", \"text\": \"Parks on its own after 1 h without use.\"},\n    {\"id\": \"note_1\", \"text\": \"Billed per started hour, never more than the monthly cap.\"},\n    {\"id\": \"note_2\", \"text\": \"Prices exclude VAT.\"}\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errors","__idx":5},"children":["Errors"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When"},"children":["When"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTHENTICATION_REQUIRED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No credential, or a credential with no user (an organization API key)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ORGANIZATION_ACCESS_DENIED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Organization-Id"]}," names an organization you are not an active member of."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INSUFFICIENT_PERMISSIONS"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The user does not hold ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use_forge"]}," in the acting organization."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_DISABLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Forge cloud compute is not switched on for the organization."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_OFFERING_BLOCKED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The offering cannot be used in this environment. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.blocked_reason"]}," are the catalog's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blocked_reason"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_OFFERING_NOT_OFFERED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The offering is not offered to you right now: switched off, switched off for your organization, or offered to Aitronos staff only. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," names the offering (for example \"DigitalOcean is not offered right now.\") and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details.offering_id"]}," is its id."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_OFFERING_NOT_FOUND"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No offering has this id."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_CREDENTIAL_MISSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A bring-your-own offering whose account is not connected."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_CREDENTIAL_REJECTED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The provider refused the connected account. Connect it again."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["502"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FORGE_COMPUTE_PROVIDER_UNREACHABLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The provider did not answer. Try again in a moment."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ApiExamples","attributes":{},"children":[{"$$mdtype":"Tag","name":"CodeGroup","attributes":{"mode":"dropdown"},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","data-title":"cURL","header":{"title":"cURL","controls":{"copy":{}}},"source":"curl \"https://api.aitronos.com/v1/forge/compute/offerings/aitronos/options\" \\\n  -H \"Authorization: Bearer $ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python SDK","header":{"title":"Python SDK","controls":{"copy":{}}},"source":"# pip install aitronos-sdk\n#\n# The Python SDK does not expose a typed `forge_compute` namespace yet, so call\n# the endpoint directly with the same bearer token you would pass to `Aitronos(...)`.\nimport httpx\n\nACCESS_TOKEN = \"your-access-token\"\n\noptions = httpx.get(\n    \"https://api.aitronos.com/v1/forge/compute/offerings/aitronos/options\",\n    headers={\"Authorization\": f\"Bearer {ACCESS_TOKEN}\"},\n).json()\ndefault = options[\"defaults\"]\nsize = next(s for s in options[\"sizes\"] if s[\"id\"] == default[\"size_id\"])\nprice = next(p for p in size[\"prices\"] if p[\"location_id\"] == default[\"location_id\"])\nprint(size[\"label\"], price[\"hourly\"], options[\"currency\"])\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","data-title":"Python","header":{"title":"Python","controls":{"copy":{}}},"source":"import os\nimport requests\n\ntoken = os.environ[\"AITRONOS_TOKEN\"]\nresponse = requests.get(\n    \"https://api.aitronos.com/v1/forge/compute/offerings/aitronos/options\",\n    headers={\"Authorization\": f\"Bearer {token}\"},\n)\noptions = response.json()\nquote = {\n    \"hourly\": options[\"sizes\"][2][\"prices\"][0][\"hourly\"],\n    \"currency\": options[\"currency\"],\n    \"catalog_version\": options[\"catalog_version\"],\n}\nprint(quote)\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","data-title":"JavaScript","header":{"title":"JavaScript","controls":{"copy":{}}},"source":"const response = await fetch(\n  \"https://api.aitronos.com/v1/forge/compute/offerings/aitronos/options\",\n  { headers: { Authorization: `Bearer ${process.env.AITRONOS_TOKEN}` } },\n);\nconst options = await response.json();\nconst { location_id, size_id } = options.defaults;\nconst size = options.sizes.find((s) => s.id === size_id);\nconst price = size.prices.find((p) => p.location_id === location_id);\nconsole.log(size.label, price.hourly, options.currency);\n","lang":"javascript"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"200 OK (own account)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"catalog_version\": \"fc-3b8e1f0a9c42\",\n  \"currency\": \"USD\",\n  \"price_source\": \"digitalocean\",\n  \"title\": \"DigitalOcean\",\n  \"description\": \"Runs in your own DigitalOcean team. DigitalOcean bills you directly.\",\n  \"free_sizing\": false,\n  \"fields\": {\n    \"location\": \"Location\",\n    \"size\": \"Size\",\n    \"cpu\": \"CPU\",\n    \"memory\": \"Memory\",\n    \"name\": \"Name\",\n    \"change\": \"Change\",\n    \"cancel\": \"Cancel\",\n    \"create\": \"Create\",\n    \"creating\": \"Creating…\",\n    \"alternatives\": \"Available instead\",\n    \"name_max_length\": 63\n  },\n  \"locations\": [\n    {\n      \"id\": \"ams3\",\n      \"label\": \"Amsterdam 3\",\n      \"detail\": \"Amsterdam\",\n      \"country\": \"NL\",\n      \"available\": true,\n      \"order\": 0,\n      \"option_label\": \"Amsterdam 3\",\n      \"proposed_name\": \"amsterdam-3-1\"\n    },\n    {\n      \"id\": \"fra1\",\n      \"label\": \"Frankfurt 1\",\n      \"detail\": \"Frankfurt\",\n      \"country\": \"DE\",\n      \"available\": true,\n      \"order\": 1,\n      \"option_label\": \"Frankfurt 1\",\n      \"proposed_name\": \"frankfurt-1-1\"\n    }\n  ],\n  \"sizes\": [\n    {\n      \"id\": \"c-8\",\n      \"label\": \"c-8 · 8 vCPU · 16 GB\",\n      \"vcpu\": 8,\n      \"memory_gb\": 16,\n      \"disk_gb\": 100,\n      \"arch\": \"x86_64\",\n      \"dedicated_cpu\": true,\n      \"order\": 0,\n      \"prices\": [\n        {\n          \"location_id\": \"ams3\",\n          \"hourly\": \"0.2500\",\n          \"monthly_cap\": \"168.00\",\n          \"includes_vat\": false,\n          \"available\": true,\n          \"price_verified\": true,\n          \"summary\": \"c-8 · 8 vCPU · 16 GB · Amsterdam 3\",\n          \"option_label\": \"c-8 · 8 vCPU · 16 GB · USD 0.25/h\",\n          \"button_label\": \"Create · c-8 · 8 vCPU · 16 GB · Amsterdam 3 · USD 0.25/h (DigitalOcean price)\",\n          \"can_create\": true\n        },\n        {\n          \"location_id\": \"fra1\",\n          \"hourly\": \"0.2500\",\n          \"monthly_cap\": \"168.00\",\n          \"includes_vat\": false,\n          \"available\": true,\n          \"price_verified\": true,\n          \"summary\": \"c-8 · 8 vCPU · 16 GB · Frankfurt 1\",\n          \"option_label\": \"c-8 · 8 vCPU · 16 GB · USD 0.25/h\",\n          \"button_label\": \"Create · c-8 · 8 vCPU · 16 GB · Frankfurt 1 · USD 0.25/h (DigitalOcean price)\",\n          \"can_create\": true\n        }\n      ]\n    }\n  ],\n  \"machine_types\": [],\n  \"cpu_choices\": [],\n  \"memory_choices\": [],\n  \"resolutions\": [],\n  \"defaults\": {\n    \"location_id\": \"fra1\",\n    \"size_id\": \"c-8\",\n    \"name\": \"frankfurt-1-1\",\n    \"vcpu\": null,\n    \"memory_gb\": null,\n    \"machine_type_id\": null\n  },\n  \"parked_storage\": {\"per_gb_month\": \"0.0600\", \"note\": \"A parked server is stored as a snapshot.\"},\n  \"notes\": [\"Prices are DigitalOcean's own, billed by DigitalOcean to your account.\", \"Prices exclude VAT.\"],\n  \"footer_notes\": [\n    {\"id\": \"billed_to\", \"text\": \"DigitalOcean bills you directly; nothing is added to Acme AG's usage.\"},\n    {\"id\": \"park\", \"text\": \"Park keeps your work and stops the server's hourly bill.\"},\n    {\"id\": \"connected_as\", \"text\": \"Connected as ops@acme.example.\"},\n    {\"id\": \"note_1\", \"text\": \"Prices are DigitalOcean's own, billed by DigitalOcean to your account.\"},\n    {\"id\": \"note_2\", \"text\": \"Prices exclude VAT.\"}\n  ]\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"403 Forbidden","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FORGE_COMPUTE_DISABLED\",\n    \"message\": \"Cloud servers are not enabled for this organization.\",\n    \"system_message\": \"Forge cloud compute is disabled for this organization\",\n    \"type\": \"authorization_error\",\n    \"status\": 403,\n    \"details\": {\"feature\": \"forge_compute_enabled\"},\n    \"trace_id\": \"3f1c9a52-7d4e-4b8a-9c21-6e0d5f7a8b34\",\n    \"timestamp\": \"2026-09-28T09:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"404 Not Found","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FORGE_COMPUTE_OFFERING_NOT_FOUND\",\n    \"message\": \"This server option does not exist. Refresh the list and choose again.\",\n    \"system_message\": \"Unknown Forge compute offering: 'acme-cloud'\",\n    \"type\": \"client_error\",\n    \"status\": 404,\n    \"details\": {\"offering_id\": \"acme-cloud\"},\n    \"trace_id\": \"3f1c9a52-7d4e-4b8a-9c21-6e0d5f7a8b34\",\n    \"timestamp\": \"2026-09-28T09:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"422 Unprocessable Entity","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FORGE_COMPUTE_CREDENTIAL_MISSING\",\n    \"message\": \"Connect your DigitalOcean account before using it.\",\n    \"system_message\": \"No credential connected for DigitalOcean\",\n    \"type\": \"validation_error\",\n    \"status\": 422,\n    \"details\": {\"offering\": \"DigitalOcean\"},\n    \"trace_id\": \"3f1c9a52-7d4e-4b8a-9c21-6e0d5f7a8b34\",\n    \"timestamp\": \"2026-09-28T09:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"502 Bad Gateway","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"FORGE_COMPUTE_PROVIDER_UNREACHABLE\",\n    \"message\": \"DigitalOcean could not be reached. Try again in a moment.\",\n    \"system_message\": \"DigitalOcean could not be reached\",\n    \"type\": \"bad_gateway\",\n    \"status\": 502,\n    \"details\": {\"offering\": \"DigitalOcean\"},\n    \"trace_id\": \"3f1c9a52-7d4e-4b8a-9c21-6e0d5f7a8b34\",\n    \"timestamp\": \"2026-09-28T09:00:00Z\"\n  }\n}\n","lang":"json"},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":6},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/introduction"},"children":["Forge cloud compute overview"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-billing-organizations"},"children":["List billing organizations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/choose-billing-organization"},"children":["Choose the default billing organization"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-project-groups"},"children":["List project groups"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/put-project-group"},"children":["Register or update a project group"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/delete-project-group"},"children":["Delete a project group"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-offerings"},"children":["List compute offerings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-offering-options"},"children":["Get offering options"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/resolve-offering-size"},"children":["Resolve a free size"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-credentials"},"children":["List connected accounts"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/put-credential"},"children":["Connect a cloud account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/delete-credential"},"children":["Disconnect a cloud account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/create-host"},"children":["Create a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-hosts"},"children":["List servers"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-my-hosts"},"children":["List your servers in every organization"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-host"},"children":["Get a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-host-usage"},"children":["Get a server's daily cost and uptime"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-host-intervals"},"children":["List a server's running intervals"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-host-events"},"children":["List a server's event history"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-progress"},"children":["Report a setup step"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-host-key"},"children":["Report the server's host key"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-ready"},"children":["Mark a server ready"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/report-activity"},"children":["Report activity"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/park-host"},"children":["Park a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/resume-host"},"children":["Resume a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/delete-host"},"children":["Delete a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/revoke-host"},"children":["Revoke a server"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-settings"},"children":["Get compute settings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-settings"},"children":["Update compute settings"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-limits"},"children":["Get spend limits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-organization-limits"},"children":["Change the organization's limits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-my-limit"},"children":["Set your own limit"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-member-limits"},"children":["List member limits"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/update-member-limit"},"children":["Set a member's limit"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/delete-orphan"},"children":["Delete a leftover resource"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/assets/get-pricing.a1f4a5c69505ff07d8f94ed9588348eade862458c82c1d34e23b1c589add5713.4236153a.md"},"children":["Get pricing sheet"]}]}]}]},"headings":[{"value":"Get offering options","id":"get-offering-options","depth":1},{"value":"Path Parameters","id":"path-parameters","depth":4},{"value":"Query Parameters","id":"query-parameters","depth":4},{"value":"Headers","id":"headers","depth":4},{"value":"Returns","id":"returns","depth":2},{"value":"Errors","id":"errors","depth":2},{"value":"Related Resources","id":"related-resources","depth":2}],"frontmatter":{"title":"Get offering options","keywords":["forge","cloud compute","options","locations","sizes","prices"],"seo":{"title":"Get offering options"}},"lastModified":"2026-10-26T18:32:31.576Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/forge-compute/get-offering-options","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}