{"openapi":"3.1.0","info":{"title":"xpu live Public Catalog and Archive API","version":"1.2.0","description":"Read-only public archived AI model/GPU tariffs and current editorial Agent Hosting companies/plans. AI Desktops expose all published device/configuration/manual seller-offer fields through /desktops/models, /desktops/configurations, /desktops/offers and /desktops/schema. Desktop prices are manually maintained observations, preserving exact hardware, seller, marketplace, market, source, checked date, currency, tax, shipping and availability. Desktop lists use version-aware pagination and cache_seconds 0. Hosting is served fresh from WordPress with cache_seconds 0; /hosting/schema describes every company and plan parameter. Decimal amounts retain currency, billing unit and conditions. Missing prices are not zero. Private account prices, historical series and administrator logs are excluded. Providers appear automatically after their first archived collection. Freshness is computed at response time; responses may be cached for 15 seconds and archive reads for 30 seconds."},"servers":[{"url":"https://xpu.live/api/v1"}],"paths":{"/desktops/models":{"get":{"tags":["AI Desktops"],"summary":"Search AI desktops with full configurations and manual seller prices","description":"Current published WordPress device/configuration/manual seller-price catalog. No response cache or automated price collection. Preserve exact configuration, seller, source, market, tax, availability and checked date. Unknown or quote-only amounts are null, not zero.","parameters":[{"in":"query","name":"q","required":false,"schema":{"type":"string","maxLength":200},"description":"Case-insensitive search of public record fields."},{"in":"query","name":"manufacturer","required":false,"schema":{"type":"string","maxLength":200},"description":"Exact filter where applicable."},{"in":"query","name":"category","required":false,"schema":{"enum":["mini","desktop","workstation","ai_station","barebone"]},"description":"Exact filter where applicable."},{"in":"query","name":"currency","required":false,"schema":{"type":"string","pattern":"^[A-Z]{3}$"},"description":"Original listing currency; no conversion."},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Exact filter where applicable."},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0},"description":"Exact filter where applicable."},{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Use the first response version on subsequent pages; restart on HTTP 409."}],"responses":{"200":{"description":"Current public desktop catalog","content":{"application/json":{"schema":{"type":"object","required":["schema_version","version","data","total","limit","offset","next_offset"],"properties":{"schema_version":{"const":1},"update_method":{"const":"manual"},"source":{"type":"object"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"directory":{"type":"string","format":"uri"},"price_note":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/DesktopModel"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Content version changed; restart pagination"},"429":{"description":"Rate limit; respect Retry-After"},"503":{"description":"Current WordPress catalog unavailable; no stale substitute"}}}},"/desktops/models/{model}":{"get":{"tags":["AI Desktops"],"summary":"Read a device by current numeric ID or slug","description":"Current published WordPress device/configuration/manual seller-price catalog. No response cache or automated price collection. Preserve exact configuration, seller, source, market, tax, availability and checked date. Unknown or quote-only amounts are null, not zero.","parameters":[{"in":"path","name":"model","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,200}$"}},{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Use the first response version on subsequent pages; restart on HTTP 409."}],"responses":{"200":{"description":"Current public desktop catalog","content":{"application/json":{"schema":{"type":"object","required":["schema_version","version","data"],"properties":{"schema_version":{"const":1},"update_method":{"const":"manual"},"source":{"type":"object"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"directory":{"type":"string","format":"uri"},"price_note":{"type":"string"},"data":{"$ref":"#/components/schemas/DesktopModel"}}}}}},"400":{"description":"Invalid or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Content version changed; restart pagination"},"429":{"description":"Rate limit; respect Retry-After"},"503":{"description":"Current WordPress catalog unavailable; no stale substitute"}}}},"/desktops/configurations":{"get":{"tags":["AI Desktops"],"summary":"List exact hardware configurations","description":"Current published WordPress device/configuration/manual seller-price catalog. No response cache or automated price collection. Preserve exact configuration, seller, source, market, tax, availability and checked date. Unknown or quote-only amounts are null, not zero.","parameters":[{"in":"query","name":"model","required":false,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,200}$"},"description":"Exact current device numeric ID or slug."},{"in":"query","name":"q","required":false,"schema":{"type":"string","maxLength":200},"description":"Case-insensitive search of public record fields."},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Exact filter where applicable."},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0},"description":"Exact filter where applicable."},{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Use the first response version on subsequent pages; restart on HTTP 409."}],"responses":{"200":{"description":"Current public desktop catalog","content":{"application/json":{"schema":{"type":"object","required":["schema_version","version","data","total","limit","offset","next_offset"],"properties":{"schema_version":{"const":1},"update_method":{"const":"manual"},"source":{"type":"object"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"directory":{"type":"string","format":"uri"},"price_note":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/DesktopConfiguration"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Content version changed; restart pagination"},"429":{"description":"Rate limit; respect Retry-After"},"503":{"description":"Current WordPress catalog unavailable; no stale substitute"}}}},"/desktops/configurations/{id}":{"get":{"tags":["AI Desktops"],"summary":"Read an exact configuration","description":"Current published WordPress device/configuration/manual seller-price catalog. No response cache or automated price collection. Preserve exact configuration, seller, source, market, tax, availability and checked date. Unknown or quote-only amounts are null, not zero.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","pattern":"^[1-9][0-9]{0,12}$"}},{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Use the first response version on subsequent pages; restart on HTTP 409."}],"responses":{"200":{"description":"Current public desktop catalog","content":{"application/json":{"schema":{"type":"object","required":["schema_version","version","data"],"properties":{"schema_version":{"const":1},"update_method":{"const":"manual"},"source":{"type":"object"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"directory":{"type":"string","format":"uri"},"price_note":{"type":"string"},"data":{"$ref":"#/components/schemas/DesktopConfiguration"}}}}}},"400":{"description":"Invalid or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Content version changed; restart pagination"},"429":{"description":"Rate limit; respect Retry-After"},"503":{"description":"Current WordPress catalog unavailable; no stale substitute"}}}},"/desktops/offers":{"get":{"tags":["AI Desktops"],"summary":"List manually entered seller prices","description":"Current published WordPress device/configuration/manual seller-price catalog. No response cache or automated price collection. Preserve exact configuration, seller, source, market, tax, availability and checked date. Unknown or quote-only amounts are null, not zero.","parameters":[{"in":"query","name":"model","required":false,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,200}$"},"description":"Exact current device numeric ID or slug."},{"in":"query","name":"configuration","required":false,"schema":{"type":"string","pattern":"^[1-9][0-9]{0,12}$"},"description":"Exact filter where applicable."},{"in":"query","name":"q","required":false,"schema":{"type":"string","maxLength":200},"description":"Case-insensitive search of public record fields."},{"in":"query","name":"currency","required":false,"schema":{"type":"string","pattern":"^[A-Z]{3}$"},"description":"Original listing currency; no conversion."},{"in":"query","name":"price_kind","required":false,"schema":{"enum":["fixed","from","quote","unknown"]},"description":"Exact filter where applicable."},{"in":"query","name":"availability","required":false,"schema":{"enum":["unknown","in_stock","out_of_stock","preorder","discontinued"]},"description":"Exact filter where applicable."},{"in":"query","name":"region","required":false,"schema":{"type":"string","maxLength":200},"description":"Exact filter where applicable."},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"description":"Exact filter where applicable."},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0},"description":"Exact filter where applicable."},{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Use the first response version on subsequent pages; restart on HTTP 409."}],"responses":{"200":{"description":"Current public desktop catalog","content":{"application/json":{"schema":{"type":"object","required":["schema_version","version","data","total","limit","offset","next_offset"],"properties":{"schema_version":{"const":1},"update_method":{"const":"manual"},"source":{"type":"object"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"directory":{"type":"string","format":"uri"},"price_note":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/DesktopOffer"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Content version changed; restart pagination"},"429":{"description":"Rate limit; respect Retry-After"},"503":{"description":"Current WordPress catalog unavailable; no stale substitute"}}}},"/desktops/offers/{id}":{"get":{"tags":["AI Desktops"],"summary":"Read a manual seller price and its exact configuration","description":"Current published WordPress device/configuration/manual seller-price catalog. No response cache or automated price collection. Preserve exact configuration, seller, source, market, tax, availability and checked date. Unknown or quote-only amounts are null, not zero.","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","pattern":"^[1-9][0-9]{0,12}$"}},{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Use the first response version on subsequent pages; restart on HTTP 409."}],"responses":{"200":{"description":"Current public desktop catalog","content":{"application/json":{"schema":{"type":"object","required":["schema_version","version","data"],"properties":{"schema_version":{"const":1},"update_method":{"const":"manual"},"source":{"type":"object"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"directory":{"type":"string","format":"uri"},"price_note":{"type":"string"},"data":{"$ref":"#/components/schemas/DesktopOffer"}}}}}},"400":{"description":"Invalid or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Content version changed; restart pagination"},"429":{"description":"Rate limit; respect Retry-After"},"503":{"description":"Current WordPress catalog unavailable; no stale substitute"}}}},"/desktops/schema":{"get":{"tags":["AI Desktops"],"summary":"Discover every device, configuration and offer field","responses":{"200":{"description":"Complete dynamic WordPress parameter dictionary: labels, groups, types and choices","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"const":1},"update_method":{"const":"manual"},"source":{"type":"object"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"directory":{"type":"string","format":"uri"},"price_note":{"type":"string"},"data":{"type":"object","properties":{"model":{"type":"object"},"configuration":{"type":"object"},"offer":{"type":"object"}}}}}}}}}}},"/hosting/companies":{"get":{"tags":["Agent Hosting"],"summary":"Search current published Agent Hosting companies","description":"Fresh read-only WordPress source; changes to companies, plans, relationships and public status are automatic. No response cache. Hosting offers retain editorial source dates and conditions; they are distinct from the hourly model/GPU archive. No draft, private, password-protected, orphan or deleted records.","parameters":[{"in":"query","name":"q","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Case-insensitive search of current public record data."},{"in":"query","name":"service_type","required":false,"schema":{"enum":["runtime","platform","sandbox","browser","workflow","paas","vps"]}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0}},{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Pin the version from page one. A changed catalog returns 409; restart pagination without version."}],"responses":{"200":{"description":"Current public hosting data","headers":{"Cache-Control":{"schema":{"const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object","required":["schema_version","source","version","generated_at","cache_seconds","data"],"properties":{"schema_version":{"const":1},"source":{"const":"wordpress_agent_hosting"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"price_note":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/HostingCompany"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid, unsupported or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Hosting version changed; restart pagination"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Hosting source unavailable; no historical substitute"}}}},"/hosting/companies/{company}":{"get":{"tags":["Agent Hosting"],"summary":"Get a company by exact ID or slug, including all its published plans","description":"Fresh read-only WordPress source; changes to companies, plans, relationships and public status are automatic. No response cache. Hosting offers retain editorial source dates and conditions; they are distinct from the hourly model/GPU archive. No draft, private, password-protected, orphan or deleted records.","parameters":[{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Pin the version from page one. A changed catalog returns 409; restart pagination without version."},{"in":"path","name":"company","required":true,"schema":{"type":"string","pattern":"^[a-zA-Z0-9_-]{1,200}$"}}],"responses":{"200":{"description":"Current public hosting data","headers":{"Cache-Control":{"schema":{"const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object","required":["schema_version","source","version","generated_at","cache_seconds","data"],"properties":{"schema_version":{"const":1},"source":{"const":"wordpress_agent_hosting"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"price_note":{"type":"string"},"data":{"$ref":"#/components/schemas/HostingCompany"}}}}}},"400":{"description":"Invalid, unsupported or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Hosting version changed; restart pagination"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Hosting source unavailable; no historical substitute"}}}},"/hosting/plans":{"get":{"tags":["Agent Hosting"],"summary":"List current published plans belonging to published companies","description":"Fresh read-only WordPress source; changes to companies, plans, relationships and public status are automatic. No response cache. Hosting offers retain editorial source dates and conditions; they are distinct from the hourly model/GPU archive. No draft, private, password-protected, orphan or deleted records.","parameters":[{"in":"query","name":"company","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Exact numeric company ID or slug."},{"in":"query","name":"q","required":false,"schema":{"type":"string","minLength":1,"maxLength":200},"description":"Case-insensitive search of current public record data."},{"in":"query","name":"price_status","required":false,"schema":{"enum":["published","quote","unknown"]}},{"in":"query","name":"currency","required":false,"schema":{"enum":["USD","EUR","GBP"]}},{"in":"query","name":"billing","required":false,"schema":{"enum":["month","year","usage","quote"]}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0}},{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Pin the version from page one. A changed catalog returns 409; restart pagination without version."}],"responses":{"200":{"description":"Current public hosting data","headers":{"Cache-Control":{"schema":{"const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object","required":["schema_version","source","version","generated_at","cache_seconds","data"],"properties":{"schema_version":{"const":1},"source":{"const":"wordpress_agent_hosting"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"price_note":{"type":"string"},"data":{"type":"array","items":{"$ref":"#/components/schemas/HostingPlan"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid, unsupported or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Hosting version changed; restart pagination"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Hosting source unavailable; no historical substitute"}}}},"/hosting/plans/{id}":{"get":{"tags":["Agent Hosting"],"summary":"Get a published plan by numeric ID","description":"Fresh read-only WordPress source; changes to companies, plans, relationships and public status are automatic. No response cache. Hosting offers retain editorial source dates and conditions; they are distinct from the hourly model/GPU archive. No draft, private, password-protected, orphan or deleted records.","parameters":[{"in":"query","name":"version","required":false,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"},"description":"Pin the version from page one. A changed catalog returns 409; restart pagination without version."},{"in":"path","name":"id","required":true,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Current public hosting data","headers":{"Cache-Control":{"schema":{"const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object","required":["schema_version","source","version","generated_at","cache_seconds","data"],"properties":{"schema_version":{"const":1},"source":{"const":"wordpress_agent_hosting"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"price_note":{"type":"string"},"data":{"$ref":"#/components/schemas/HostingPlan"}}}}}},"400":{"description":"Invalid, unsupported or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Hosting version changed; restart pagination"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Hosting source unavailable; no historical substitute"}}}},"/hosting/schema":{"get":{"tags":["Agent Hosting"],"summary":"Discover all company and plan editor parameters","description":"Fresh read-only WordPress source; changes to companies, plans, relationships and public status are automatic. No response cache. Hosting offers retain editorial source dates and conditions; they are distinct from the hourly model/GPU archive. No draft, private, password-protected, orphan or deleted records.","parameters":[],"responses":{"200":{"description":"Current public hosting data","headers":{"Cache-Control":{"schema":{"const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object","required":["schema_version","source","version","generated_at","cache_seconds","data"],"properties":{"schema_version":{"const":1},"source":{"const":"wordpress_agent_hosting"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$"},"generated_at":{"type":"string","format":"date-time"},"cache_seconds":{"const":0},"price_note":{"type":"string"},"data":{"type":"object","required":["company","plan"],"properties":{"company":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HostingField"}},"plan":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/HostingField"}}}}}}}}},"400":{"description":"Invalid, unsupported or duplicate parameter"},"404":{"description":"Published record not found"},"409":{"description":"Hosting version changed; restart pagination"},"429":{"description":"Rate limit exceeded"},"503":{"description":"Hosting source unavailable; no historical substitute"}}}},"/prices":{"get":{"summary":"Current public tariffs","parameters":[{"in":"query","name":"kind","required":false,"schema":{"enum":["model","gpu"]},"description":"Exact filter where applicable."},{"in":"query","name":"provider","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"resource","required":false,"schema":{"type":"string"},"description":"Exact provider resource ID or mapped catalog ID."},{"in":"query","name":"catalog_id","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"currency","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"rental","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"q","required":false,"schema":{"type":"string"},"description":"Case-insensitive text search."},{"in":"query","name":"include_stale","required":false,"schema":{"type":"boolean","default":true},"description":"Include observations beyond their freshness window."},{"in":"query","name":"id","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Exact filter where applicable."},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0},"description":"Exact filter where applicable."},{"in":"query","name":"snapshot_id","required":false,"schema":{"type":"string"},"description":"Use the first response snapshot_id on subsequent pages; restart on 409."}],"responses":{"200":{"description":"Public archive response","content":{"application/json":{"schema":{"type":"object","required":["schema_version","snapshot_id","generated_at","data","total","limit","offset","next_offset"],"properties":{"schema_version":{"const":1},"snapshot_id":{"type":"string"},"generated_at":{"type":["string","null"],"format":"date-time"},"dataset_updated_at":{"type":["string","null"],"format":"date-time"},"latest_observed_at":{"type":["string","null"],"format":"date-time"},"selection":{"type":"string"},"cache_seconds":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Price"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid query"},"409":{"description":"Snapshot changed; restart pagination"},"429":{"description":"Too many requests","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Archive temporarily unavailable"}}}},"/prices/lookup":{"get":{"summary":"Exact tariff lookup; id required","parameters":[{"in":"query","name":"id","required":true,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"provider","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Exact filter where applicable."},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0},"description":"Exact filter where applicable."},{"in":"query","name":"snapshot_id","required":false,"schema":{"type":"string"},"description":"Use the first response snapshot_id on subsequent pages; restart on 409."}],"responses":{"200":{"description":"Public archive response","content":{"application/json":{"schema":{"type":"object","required":["schema_version","snapshot_id","generated_at","data","total","limit","offset","next_offset"],"properties":{"schema_version":{"const":1},"snapshot_id":{"type":"string"},"generated_at":{"type":["string","null"],"format":"date-time"},"dataset_updated_at":{"type":["string","null"],"format":"date-time"},"latest_observed_at":{"type":["string","null"],"format":"date-time"},"selection":{"type":"string"},"cache_seconds":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Price"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid query"},"409":{"description":"Snapshot changed; restart pagination"},"429":{"description":"Too many requests","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Archive temporarily unavailable"}}}},"/providers":{"get":{"summary":"Archive providers and public coverage","parameters":[{"in":"query","name":"kind","required":false,"schema":{"enum":["model","gpu"]},"description":"Exact filter where applicable."},{"in":"query","name":"provider","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Exact filter where applicable."},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0},"description":"Exact filter where applicable."},{"in":"query","name":"snapshot_id","required":false,"schema":{"type":"string"},"description":"Use the first response snapshot_id on subsequent pages; restart on 409."}],"responses":{"200":{"description":"Public archive response","content":{"application/json":{"schema":{"type":"object","required":["schema_version","snapshot_id","generated_at","data","total","limit","offset","next_offset"],"properties":{"schema_version":{"const":1},"snapshot_id":{"type":"string"},"generated_at":{"type":["string","null"],"format":"date-time"},"dataset_updated_at":{"type":["string","null"],"format":"date-time"},"latest_observed_at":{"type":["string","null"],"format":"date-time"},"selection":{"type":"string"},"cache_seconds":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid query"},"409":{"description":"Snapshot changed; restart pagination"},"429":{"description":"Too many requests","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Archive temporarily unavailable"}}}},"/resources":{"get":{"summary":"Priced provider resources, not a full model specification catalog","parameters":[{"in":"query","name":"kind","required":false,"schema":{"enum":["model","gpu"]},"description":"Exact filter where applicable."},{"in":"query","name":"provider","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"resource","required":false,"schema":{"type":"string"},"description":"Exact provider resource ID or mapped catalog ID."},{"in":"query","name":"catalog_id","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"currency","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"rental","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"q","required":false,"schema":{"type":"string"},"description":"Case-insensitive text search."},{"in":"query","name":"include_stale","required":false,"schema":{"type":"boolean","default":true},"description":"Include observations beyond their freshness window."},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"description":"Exact filter where applicable."},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"maximum":20000,"default":0},"description":"Exact filter where applicable."},{"in":"query","name":"snapshot_id","required":false,"schema":{"type":"string"},"description":"Use the first response snapshot_id on subsequent pages; restart on 409."}],"responses":{"200":{"description":"Public archive response","content":{"application/json":{"schema":{"type":"object","required":["schema_version","snapshot_id","generated_at","data","total","limit","offset","next_offset"],"properties":{"schema_version":{"const":1},"snapshot_id":{"type":"string"},"generated_at":{"type":["string","null"],"format":"date-time"},"dataset_updated_at":{"type":["string","null"],"format":"date-time"},"latest_observed_at":{"type":["string","null"],"format":"date-time"},"selection":{"type":"string"},"cache_seconds":{"type":"integer"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Resource"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"next_offset":{"type":["integer","null"]}}}}}},"400":{"description":"Invalid query"},"409":{"description":"Snapshot changed; restart pagination"},"429":{"description":"Too many requests","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Archive temporarily unavailable"}}}},"/freshness":{"get":{"summary":"Observation age and provider collection status","parameters":[{"in":"query","name":"provider","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"kind","required":false,"schema":{"enum":["model","gpu"]},"description":"Exact filter where applicable."},{"in":"query","name":"resource","required":false,"schema":{"type":"string"},"description":"Exact provider resource ID or mapped catalog ID."},{"in":"query","name":"catalog_id","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"include_stale","required":false,"schema":{"type":"boolean","default":true},"description":"Include observations beyond their freshness window."},{"in":"query","name":"snapshot_id","required":false,"schema":{"type":"string"},"description":"Use the first response snapshot_id on subsequent pages; restart on 409."}],"responses":{"200":{"description":"Public archive response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"const":1},"snapshot_id":{"type":"string"},"generated_at":{"type":["string","null"],"format":"date-time"},"dataset_updated_at":{"type":["string","null"],"format":"date-time"},"latest_observed_at":{"type":["string","null"],"format":"date-time"},"selection":{"type":"string"},"cache_seconds":{"type":"integer"},"last_attempt_at":{"type":["string","null"],"format":"date-time"},"last_usable_at":{"type":["string","null"],"format":"date-time"},"public_prices":{"type":"integer"},"stale_prices":{"type":"integer"},"providers":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}}}}}}},"400":{"description":"Invalid query"},"409":{"description":"Snapshot changed; restart pagination"},"429":{"description":"Too many requests","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Archive temporarily unavailable"}}}},"/last-update":{"get":{"summary":"Latest attempt, usable dataset and observation times","parameters":[{"in":"query","name":"provider","required":false,"schema":{"type":"string"},"description":"Exact filter where applicable."},{"in":"query","name":"snapshot_id","required":false,"schema":{"type":"string"},"description":"Use the first response snapshot_id on subsequent pages; restart on 409."}],"responses":{"200":{"description":"Public archive response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"const":1},"snapshot_id":{"type":"string"},"generated_at":{"type":["string","null"],"format":"date-time"},"dataset_updated_at":{"type":["string","null"],"format":"date-time"},"latest_observed_at":{"type":["string","null"],"format":"date-time"},"selection":{"type":"string"},"cache_seconds":{"type":"integer"},"last_attempt_at":{"type":["string","null"],"format":"date-time"},"last_usable_at":{"type":["string","null"],"format":"date-time"},"public_prices":{"type":"integer"},"stale_prices":{"type":"integer"},"providers":{"type":"array","items":{"$ref":"#/components/schemas/Provider"}}}}}}},"400":{"description":"Invalid query"},"409":{"description":"Snapshot changed; restart pagination"},"429":{"description":"Too many requests","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Archive temporarily unavailable"}}}},"/stats":{"get":{"summary":"Archive coverage counts; tariffs are not unique website models","parameters":[],"responses":{"200":{"description":"Public archive response","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"const":1},"snapshot_id":{"type":"string"},"generated_at":{"type":["string","null"],"format":"date-time"},"dataset_updated_at":{"type":["string","null"],"format":"date-time"},"latest_observed_at":{"type":["string","null"],"format":"date-time"},"selection":{"type":"string"},"cache_seconds":{"type":"integer"},"registered_providers":{"type":"integer"},"providers_with_public_prices":{"type":"integer"},"public_tariffs":{"type":"integer"},"model_tariffs":{"type":"integer"},"gpu_tariffs":{"type":"integer"},"unique_provider_resources":{"type":"integer"},"mapped_catalog_resources":{"type":"integer"},"unmapped_tariffs":{"type":"integer"},"stale_prices":{"type":"integer"}}}}}},"400":{"description":"Invalid query"},"409":{"description":"Snapshot changed; restart pagination"},"429":{"description":"Too many requests","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Archive temporarily unavailable"}}}},"/openapi.json":{"get":{"summary":"OpenAPI specification","responses":{"200":{"description":"OpenAPI 3.1 JSON document"}}}}},"components":{"schemas":{"DesktopOffer":{"type":"object","required":["id","name","attributes","configuration_id","model_id"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"model_id":{"type":"integer"},"model_slug":{"type":"string"},"model_name":{"type":"string"},"model_url":{"type":"string","format":"uri"},"configuration_id":{"type":"integer"},"configuration_name":{"type":"string"},"configuration_attributes":{"type":"object","additionalProperties":{"type":["string","integer","null"]},"description":"Every public field is described by GET /desktops/schema. Empty values are null; decimal quantities remain strings."},"update_method":{"const":"manual"},"attributes":{"type":"object","additionalProperties":{"type":["string","integer","null"]},"description":"Every public field is described by GET /desktops/schema. Empty values are null; decimal quantities remain strings."},"pricing":{"type":"object","properties":{"status":{"enum":["fixed","from","quote","unknown"]},"amount":{"type":["string","null"]},"currency":{"type":["string","null"]},"unit":{"const":"per_configuration"},"seller":{"type":"string"},"platform":{"type":"string"},"source_url":{"type":"string"},"checked":{"type":["string","null"]}}}}},"DesktopConfiguration":{"type":"object","required":["id","name","attributes","offers"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"model_id":{"type":"integer"},"model_slug":{"type":"string"},"model_name":{"type":"string"},"model_url":{"type":"string"},"attributes":{"type":"object","additionalProperties":{"type":["string","integer","null"]},"description":"Every public field is described by GET /desktops/schema. Empty values are null; decimal quantities remain strings."},"offers":{"type":"array","items":{"$ref":"#/components/schemas/DesktopOffer"}}}},"DesktopModel":{"type":"object","required":["id","name","slug","url","attributes","configurations"],"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"description":{"type":"string"},"excerpt":{"type":"string"},"image":{"type":["string","null"],"format":"uri"},"images":{"type":"array","items":{"type":"object"}},"attributes":{"type":"object","additionalProperties":{"type":["string","integer","null"]},"description":"Every public field is described by GET /desktops/schema. Empty values are null; decimal quantities remain strings."},"configurations":{"type":"array","items":{"$ref":"#/components/schemas/DesktopConfiguration"}}}},"HostingCompany":{"type":"object","required":["id","slug","name","url","attributes","plans","logo","seo"],"properties":{"id":{"type":"integer"},"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"summary":{"type":"string"},"description":{"type":"string"},"modified_gmt":{"type":"string"},"logo":{"type":["object","null"],"properties":{"url":{"type":"string","format":"uri"},"alt":{"type":"string"}},"required":["url","alt"]},"seo":{"type":"object","properties":{"title":{"type":["string","null"]},"description":{"type":["string","null"]},"canonical":{"type":"string"},"social_image":{"type":["object","null"],"properties":{"url":{"type":"string","format":"uri"},"alt":{"type":"string"}},"required":["url","alt"]}}},"attributes":{"type":"object","description":"Complete allowlisted editor parameters. See /hosting/schema for every field label, group, type and select choices. Empty/unknown fields are null. Media values are public image objects, not local paths.","additionalProperties":{"oneOf":[{"type":["string","null"]},{"type":"integer"},{"type":"object","properties":{"url":{"type":"string","format":"uri"},"alt":{"type":"string"}},"required":["url","alt"]}]}},"plans":{"type":"array","items":{"$ref":"#/components/schemas/HostingPlan"}}}},"HostingPlan":{"type":"object","required":["id","company_id","name","pricing","attributes"],"properties":{"id":{"type":"integer"},"company_id":{"type":"integer"},"name":{"type":"string"},"order":{"type":"integer"},"modified_gmt":{"type":"string"},"company_name":{"type":"string"},"company_slug":{"type":"string"},"company_url":{"type":"string"},"pricing":{"type":"object","required":["status","base_amount","currency","billing","unit","source_url","checked"],"properties":{"status":{"enum":["published","quote","unknown"]},"base_amount":{"type":["string","null"],"pattern":"^\\d+(\\.\\d+)?$","description":"Decimal base subscription amount only when explicitly published. Null is unknown/quote-only; \"0\" is an explicit zero base fee, not zero total cost."},"currency":{"type":["string","null"]},"billing":{"enum":["month","year","usage","quote",null]},"unit":{"type":["string","null"]},"source_url":{"type":["string","null"]},"checked":{"type":["string","null"]}}},"attributes":{"type":"object","description":"Complete allowlisted editor parameters. See /hosting/schema for every field label, group, type and select choices. Empty/unknown fields are null. Media values are public image objects, not local paths.","additionalProperties":{"oneOf":[{"type":["string","null"]},{"type":"integer"},{"type":"object","properties":{"url":{"type":"string","format":"uri"},"alt":{"type":"string"}},"required":["url","alt"]}]}}}},"HostingField":{"type":"object","required":["label","group","type","nullable"],"properties":{"label":{"type":"string"},"group":{"type":"string"},"type":{"type":"string"},"nullable":{"const":true},"choices":{"type":"object","additionalProperties":{"type":"string"}}}},"Price":{"type":"object","required":["id","series_id","provider","kind","resource","currency","price_type","components","conditions","source","observed_at","stale","stale_after_seconds"],"properties":{"id":{"type":"string"},"series_id":{"type":"string"},"run_id":{"type":"string"},"kind":{"enum":["model","gpu"]},"provider":{"type":"string"},"resource":{"type":"string"},"catalog_id":{"type":["string","null"]},"variant":{"type":"string"},"currency":{"type":"string"},"price_type":{"type":"string"},"components":{"type":"array","items":{"type":"object","required":["name","amount","unit"],"properties":{"name":{"type":"string"},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$"},"unit":{"type":"string"}}}},"conditions":{"type":"object","additionalProperties":true},"source":{"type":"object","properties":{"url":{"type":["string","null"]},"method":{"type":["string","null"]}}},"observed_at":{"type":["string","null"],"format":"date-time"},"collection_checked_at":{"type":["string","null"],"format":"date-time"},"stale":{"type":"boolean"},"stale_after_seconds":{"type":"integer"}}},"Provider":{"type":"object","properties":{"id":{"type":"string"},"last_attempt_at":{"type":["string","null"],"format":"date-time"},"last_attempt_status":{"type":"string"},"last_success_at":{"type":["string","null"],"format":"date-time"},"last_usable_at":{"type":["string","null"],"format":"date-time"},"public_price_count":{"type":"integer"},"stale_prices":{"type":"integer"},"kinds":{"type":"array","items":{"enum":["model","gpu"]}}}},"Resource":{"type":"object","properties":{"kind":{"enum":["model","gpu"]},"provider":{"type":"string"},"resource":{"type":"string"},"catalog_id":{"type":["string","null"]},"price_count":{"type":"integer"},"stale_prices":{"type":"integer"},"latest_observed_at":{"type":["string","null"],"format":"date-time"}}}}}}