Catalog

The catalog API exposes available infrastructure options from all enabled providers.

Plans

List Plans

GET /v1/plans

Query parameters: page, limit

Returns available server and instance plans with specs, pricing, and regional availability.

Get Plan

GET /v1/plans/:id

Returns a single plan by slug or ID.

Regions

List Regions

GET /v1/regions

Query parameters: page, limit

Returns available regions with city, country, and site information.

Get Region

GET /v1/regions/:id

Returns a single region by slug or ID.

Operating Systems

List Operating Systems

GET /v1/operating_systems

Query parameters: page, limit

Returns available operating system images.

Also available at /v1/plans/operating_systems (Latitude alias).

Get Operating System

GET /v1/operating_systems/:id

Returns a single operating system by slug or ID.

Also available at:

GET /v1/plans/operating-systems/:id

Server Catalog (Create Wizard)

The server catalog powers the unified create wizard in the console.

List Categories

GET /v1/server-catalog/categories

Returns categories: bare-metal, bare-metal-gpu, virtual-machine, virtual-machine-gpu.

List Tiers

GET /v1/server-catalog/tiers

Returns tiers: all, core-optimized, memory-optimized, storage-optimized.

List Macro Regions

GET /v1/server-catalog/macroregions

List Cities

GET /v1/server-catalog/cities?region=north-america

List Servers

GET /v1/server-catalog/servers?category=bare-metal&tier=standard&region=north-america

Get Server Option

GET /v1/server-catalog/servers/:id

List OS Versions

GET /v1/server-catalog/os-versions?category=bare-metal

Get Billing Options

GET /v1/server-catalog/billing-options?serverId=rs4-metal-large

Full Catalog

Get All Catalog

GET /v1/catalog/all

Returns the complete catalog (plans, regions, instance types, images) from all providers in a single response.

curl https://api.fugoku.com/v1/catalog/all \
  -H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN"

List Catalog Resources

GET /v1/catalog/resources

Returns all catalog resources (instance types, plans, images) with filtering by provider.

curl https://api.fugoku.com/v1/catalog/resources?providerId=prov-lat-1 \
  -H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN"

Get Catalog Resource

GET /v1/catalog/resources/:id

Returns a single catalog resource by ID.

Get Region Details

GET /v1/catalog/regions/:id

Returns detailed information for a specific region, including available zones and providers.

Get Availability

GET /v1/catalog/availability

Returns availability matrix for plans across regions and providers.

curl https://api.fugoku.com/v1/catalog/availability \
  -H "X-Fugoku-API-Key: $FUGOKU_API_TOKEN"