{"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":"List servers","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":"list-servers","__idx":0},"children":["List servers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lists the Forge cloud servers you created in the acting organization (your current one, or the one named in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id"]},"), newest first, each as the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-host#returns"},"children":["server object"]},". Deleted servers stay in the list for seven days after they were deleted. With ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope=org"]}," it lists every member's servers, so an organization admin can see — and stop — everything the organization pays for. To list your servers in every organization at once, use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/list-my-hosts"},"children":["List your servers in every organization"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Callers holding ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manage_forge"]}," also receive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orphans"]},": resources Forge labelled in the organization's own (bring-your-own) provider accounts that no server Forge manages owns any more, such as a server left behind by an interrupted delete or one forgotten when its account was disconnected with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["forget_hosts=true"]},", with what each costs at the provider. Remove one with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/delete-orphan"},"children":["Delete a leftover resource"]},". Resources in Aitronos' own accounts are never listed; Aitronos cleans those up itself."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requires a bearer token (or API key) whose principal holds the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use_forge"]}," capability in the acting organization; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope=org"]}," requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manage_forge"]},". It works while Forge cloud compute is switched off. An organization API key has no user of its own, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope=mine"]}," lists no servers for it."]},{"$$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/hosts"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"query-parameters","__idx":1},"children":["Query Parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope"]}]}," string ",{"$$mdtype":"Tag","name":"em","attributes":{"style":{"color":"#9ca3af !important","fontWeight":"500 !important","fontStyle":"normal !important"}},"children":["optional"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mine"]}," (default) lists the servers you created; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["org"]}," lists every member's servers and requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manage_forge"]},"."]},{"$$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":2},"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":3},"children":["Returns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hosts"]}]}," array — the servers, newest first, each a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/forge-compute/get-host#returns"},"children":["server object"]},". A server whose record cannot be read is left out rather than failing the whole list."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orphans"]}]}," array — leftover resources in the organization's own provider accounts. Always empty for callers without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manage_forge"]},". Each entry:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offering_id"]}]}," string — the bring-your-own offering whose account holds the resource."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["provider_resource_id"]}]}," string — the resource's id at the provider. Some providers' ids contain a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resource_type"]}]}," string — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["server"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["snapshot"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ssh_key"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firewall"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]}," string or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," — the resource's name at the provider."]},{"$$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"]}," — what the resource costs per hour at the provider, in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]},"; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when unknown or not charged by the hour."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]}," string or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," — the currency of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hourly"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["first_seen_at"]}]}," string or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," — when Forge first found the resource (UTC)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_seen_at"]}]}," string — when Forge last found it (UTC)."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"hosts\": [\n    {\n      \"id\": \"fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90\",\n      \"offering_id\": \"aitronos\",\n      \"kind\": \"managed\",\n      \"name\": \"build-box\",\n      \"organization\": {\"id\": \"org_3c1e9a7b5d2f4e8a9b0c6d1e2f3a4b5c\", \"name\": \"Acme Engineering\"},\n      \"user_id\": \"usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7\",\n      \"project_group\": {\"id\": \"fpgrp_4b9e2c7a1d3f4e8a9c0b6d2e1f3a5b7c\", \"client_id\": \"grp-clients\", \"name\": \"Clients\"},\n      \"location_id\": \"eu-central\",\n      \"location_label\": \"Germany\",\n      \"size_id\": \"std-16\",\n      \"size_label\": \"16 vCPU · 64 GB\",\n      \"state\": \"ready\",\n      \"state_label\": \"Ready\",\n      \"transient\": false,\n      \"step\": \"ready\",\n      \"step_started_at\": \"2026-09-28T09:03:41.502318Z\",\n      \"state_changed_at\": \"2026-09-28T09:03:41.502318Z\",\n      \"failure\": null,\n      \"ipv4\": \"203.0.113.24\",\n      \"ipv6\": \"2001:db8:4f2a::1\",\n      \"ssh_port\": 22,\n      \"ssh_user\": \"forge\",\n      \"bootstrap_host_key_pub\": null,\n      \"host_key_pub\": \"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000\",\n      \"price\": {\n        \"hourly\": \"0.83\",\n        \"monthly_cap\": \"520.30\",\n        \"currency\": \"CHF\",\n        \"source\": \"aitronos\",\n        \"includes_vat\": false,\n        \"catalog_version\": \"fc-3b8e1f0a9c42\",\n        \"quoted_at\": \"2026-09-28T09:00:00.184066Z\",\n        \"parked_per_gb_month\": \"0.0269\",\n        \"price_verified\": true\n      },\n      \"month_to_date\": \"0.83\",\n      \"notice\": null,\n      \"idle_reminder\": null,\n      \"reconcile_flags\": null,\n      \"actions\": [\"park\", \"delete\", \"revoke\"],\n      \"created_at\": \"2026-09-28T09:00:00.184066Z\",\n      \"ready_at\": \"2026-09-28T09:03:41.502318Z\",\n      \"parked_at\": null,\n      \"parked_expires_at\": null,\n      \"deleted_at\": null,\n      \"revoked_at\": null,\n      \"revoke_reason\": null,\n      \"last_activity_at\": null\n    },\n    {\n      \"id\": \"fchost_0b7e4d21c9a84f6b8d3e5a1c7f902e64\",\n      \"offering_id\": \"aitronos\",\n      \"kind\": \"managed\",\n      \"name\": \"nightly-tests\",\n      \"organization\": {\"id\": \"org_3c1e9a7b5d2f4e8a9b0c6d1e2f3a4b5c\", \"name\": \"Acme Engineering\"},\n      \"user_id\": \"usr_2c6b8e1f4a9d4c7e8b0f3a5d6e1c9b27\",\n      \"project_group\": null,\n      \"location_id\": \"eu-central\",\n      \"location_label\": \"Germany\",\n      \"size_id\": \"std-8\",\n      \"size_label\": \"8 vCPU · 32 GB\",\n      \"state\": \"parked\",\n      \"state_label\": \"Parked. The server is saved and not running\",\n      \"transient\": false,\n      \"step\": null,\n      \"step_started_at\": null,\n      \"state_changed_at\": \"2026-09-28T18:03:40.905112Z\",\n      \"failure\": null,\n      \"ipv4\": null,\n      \"ipv6\": null,\n      \"ssh_port\": 22,\n      \"ssh_user\": \"forge\",\n      \"bootstrap_host_key_pub\": null,\n      \"host_key_pub\": \"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000\",\n      \"price\": {\n        \"hourly\": \"0.42\",\n        \"monthly_cap\": \"261.55\",\n        \"currency\": \"CHF\",\n        \"source\": \"aitronos\",\n        \"includes_vat\": false,\n        \"catalog_version\": \"fc-3b8e1f0a9c42\",\n        \"quoted_at\": \"2026-09-27T14:12:09.551208Z\",\n        \"parked_per_gb_month\": \"0.0269\",\n        \"price_verified\": true\n      },\n      \"month_to_date\": \"11.76\",\n      \"notice\": null,\n      \"idle_reminder\": null,\n      \"reconcile_flags\": null,\n      \"actions\": [\"resume\", \"delete\"],\n      \"created_at\": \"2026-09-27T14:12:09.551208Z\",\n      \"ready_at\": \"2026-09-27T14:15:02.300417Z\",\n      \"parked_at\": \"2026-09-28T18:03:40.905112Z\",\n      \"parked_expires_at\": \"2026-10-28T18:03:40.905112Z\",\n      \"deleted_at\": null,\n      \"revoked_at\": null,\n      \"revoke_reason\": null,\n      \"last_activity_at\": \"2026-09-28T06:40:00Z\"\n    }\n  ],\n  \"orphans\": [\n    {\n      \"offering_id\": \"digitalocean\",\n      \"provider_resource_id\": \"512399871\",\n      \"resource_type\": \"server\",\n      \"name\": \"forge-build-box\",\n      \"hourly\": \"0.2500\",\n      \"currency\": \"USD\",\n      \"first_seen_at\": \"2026-09-27T21:40:02.551730Z\",\n      \"last_seen_at\": \"2026-09-28T08:55:02.118904Z\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errors","__idx":4},"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 valid credential."]}]},{"$$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 caller does not hold ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use_forge"]},", or asked for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope=org"]}," without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manage_forge"]},"."]}]},{"$$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":["VALIDATION_ERROR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope"]}," is neither ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mine"]}," nor ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["org"]},"."]}]}]}]}]}]},{"$$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/hosts?scope=org\" \\\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 credential you would pass to `Aitronos(...)`\n# — an API key or a bearer token, both sent as `Authorization: Bearer <value>`.\nimport httpx\n\nAPI_KEY = \"your-api-key\"\n\nlisting = httpx.get(\n    \"https://api.aitronos.com/v1/forge/compute/hosts\",\n    headers={\"Authorization\": f\"Bearer {API_KEY}\"},\n    params={\"scope\": \"org\"},\n).json()\nfor server in listing[\"hosts\"]:\n    print(server[\"name\"], server[\"state\"], server[\"month_to_date\"])\nfor leftover in listing[\"orphans\"]:\n    print(\"leftover\", leftover[\"resource_type\"], leftover[\"provider_resource_id\"])\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/hosts\",\n    headers={\"Authorization\": f\"Bearer {token}\"},\n)\nrunning = [h for h in response.json()[\"hosts\"] if h[\"state\"] == \"ready\"]\nprint(len(running), \"ready servers\")\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(\"https://api.aitronos.com/v1/forge/compute/hosts?scope=mine\", {\n  headers: { Authorization: `Bearer ${process.env.AITRONOS_TOKEN}` },\n});\nconst { hosts } = await response.json();\nconsole.log(hosts.map((h) => `${h.name}: ${h.state_label}`));\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 (scope=org)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"hosts\": [\n    {\n      \"id\": \"fchost_5d0c2b9e7a414f3c9e8b1a6d2f4c7e90\",\n      \"offering_id\": \"aitronos\",\n      \"kind\": \"managed\",\n      \"name\": \"build-box\",\n      \"organization\": {\"id\": \"org_3c1e9a7b5d2f4e8a9b0c6d1e2f3a4b5c\", \"name\": \"Acme Engineering\"},\n      \"user_id\": \"usr_7f3a9c2e1b8d4e6fa0c5b3d9e2f1a4c7\",\n      \"project_group\": {\"id\": \"fpgrp_4b9e2c7a1d3f4e8a9c0b6d2e1f3a5b7c\", \"client_id\": \"grp-clients\", \"name\": \"Clients\"},\n      \"location_id\": \"eu-central\",\n      \"location_label\": \"Germany\",\n      \"size_id\": \"std-16\",\n      \"size_label\": \"16 vCPU · 64 GB\",\n      \"state\": \"ready\",\n      \"state_label\": \"Ready\",\n      \"transient\": false,\n      \"step\": \"ready\",\n      \"step_started_at\": \"2026-09-28T09:03:41.502318Z\",\n      \"state_changed_at\": \"2026-09-28T09:03:41.502318Z\",\n      \"failure\": null,\n      \"ipv4\": \"203.0.113.24\",\n      \"ipv6\": \"2001:db8:4f2a::1\",\n      \"ssh_port\": 22,\n      \"ssh_user\": \"forge\",\n      \"bootstrap_host_key_pub\": null,\n      \"host_key_pub\": \"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000\",\n      \"price\": {\n        \"hourly\": \"0.83\",\n        \"monthly_cap\": \"520.30\",\n        \"currency\": \"CHF\",\n        \"source\": \"aitronos\",\n        \"includes_vat\": false,\n        \"catalog_version\": \"fc-3b8e1f0a9c42\",\n        \"quoted_at\": \"2026-09-28T09:00:00.184066Z\",\n        \"parked_per_gb_month\": \"0.0269\",\n        \"price_verified\": true\n      },\n      \"month_to_date\": \"0.83\",\n      \"notice\": null,\n      \"idle_reminder\": null,\n      \"reconcile_flags\": null,\n      \"actions\": [\"park\", \"delete\", \"revoke\"],\n      \"created_at\": \"2026-09-28T09:00:00.184066Z\",\n      \"ready_at\": \"2026-09-28T09:03:41.502318Z\",\n      \"parked_at\": null,\n      \"parked_expires_at\": null,\n      \"deleted_at\": null,\n      \"revoked_at\": null,\n      \"revoke_reason\": null,\n      \"last_activity_at\": null\n    },\n    {\n      \"id\": \"fchost_0b7e4d21c9a84f6b8d3e5a1c7f902e64\",\n      \"offering_id\": \"aitronos\",\n      \"kind\": \"managed\",\n      \"name\": \"nightly-tests\",\n      \"organization\": {\"id\": \"org_3c1e9a7b5d2f4e8a9b0c6d1e2f3a4b5c\", \"name\": \"Acme Engineering\"},\n      \"user_id\": \"usr_2c6b8e1f4a9d4c7e8b0f3a5d6e1c9b27\",\n      \"project_group\": null,\n      \"location_id\": \"eu-central\",\n      \"location_label\": \"Germany\",\n      \"size_id\": \"std-8\",\n      \"size_label\": \"8 vCPU · 32 GB\",\n      \"state\": \"parked\",\n      \"state_label\": \"Parked. The server is saved and not running\",\n      \"transient\": false,\n      \"step\": null,\n      \"step_started_at\": null,\n      \"state_changed_at\": \"2026-09-28T18:03:40.905112Z\",\n      \"failure\": null,\n      \"ipv4\": null,\n      \"ipv6\": null,\n      \"ssh_port\": 22,\n      \"ssh_user\": \"forge\",\n      \"bootstrap_host_key_pub\": null,\n      \"host_key_pub\": \"ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIExampleServerHostKeyForDocumentationOnly0000\",\n      \"price\": {\n        \"hourly\": \"0.42\",\n        \"monthly_cap\": \"261.55\",\n        \"currency\": \"CHF\",\n        \"source\": \"aitronos\",\n        \"includes_vat\": false,\n        \"catalog_version\": \"fc-3b8e1f0a9c42\",\n        \"quoted_at\": \"2026-09-27T14:12:09.551208Z\",\n        \"parked_per_gb_month\": \"0.0269\",\n        \"price_verified\": true\n      },\n      \"month_to_date\": \"11.76\",\n      \"notice\": null,\n      \"idle_reminder\": null,\n      \"reconcile_flags\": null,\n      \"actions\": [\"resume\", \"delete\"],\n      \"created_at\": \"2026-09-27T14:12:09.551208Z\",\n      \"ready_at\": \"2026-09-27T14:15:02.300417Z\",\n      \"parked_at\": \"2026-09-28T18:03:40.905112Z\",\n      \"parked_expires_at\": \"2026-10-28T18:03:40.905112Z\",\n      \"deleted_at\": null,\n      \"revoked_at\": null,\n      \"revoke_reason\": null,\n      \"last_activity_at\": \"2026-09-28T06:40:00Z\"\n    }\n  ],\n  \"orphans\": [\n    {\n      \"offering_id\": \"digitalocean\",\n      \"provider_resource_id\": \"512399871\",\n      \"resource_type\": \"server\",\n      \"name\": \"forge-build-box\",\n      \"hourly\": \"0.2500\",\n      \"currency\": \"USD\",\n      \"first_seen_at\": \"2026-09-27T21:40:02.551730Z\",\n      \"last_seen_at\": \"2026-09-28T08:55:02.118904Z\"\n    }\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\": \"INSUFFICIENT_PERMISSIONS\",\n    \"message\": \"You don't have permission to perform this action.\",\n    \"system_message\": \"Missing required capability: manage_forge\",\n    \"type\": \"authorization_error\",\n    \"status\": 403,\n    \"details\": {\"required_capability\": \"manage_forge\"},\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":5},"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"]}]}]}]},"headings":[{"value":"List servers","id":"list-servers","depth":1},{"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":"List servers","keywords":["forge","cloud compute","servers","list","orphans"],"seo":{"title":"List servers"}},"lastModified":"2026-10-26T18:32:31.577Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/forge-compute/list-hosts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}