Catalog (Beta) | API & MCP Reference | Archera
Cloud SKU catalog — attribute filters, search, and per-SKU detail
Returns the public catalog plus the org's own custom-priced SKUs.
List filterable catalog SKU attributes
get/beta/v1/org/{org_id}/catalog/skus/attributes
Returns the fields that can be used in the 'filter' parameter of the catalog SKU list endpoint, along with their types.
Path parameters
- org_id: string · uuid Required
Responses
200 OK
{
"name": "text",
"field": "text",
"type": "boolean"
}
400 Bad request
401 Unauthorized
403 Forbidden
404 Not found
405 Method not allowed
409 Conflict
500 Internal server error
Get valid values for a filterable catalog SKU attribute
get/beta/v1/org/{org_id}/catalog/skus/attributes/{field}
Returns the distinct values for a given field, scoped to the same filters that would be applied on the list endpoint.
Path parameters
- org_id: string · uuid Required
- field: string · min: 1 Required
Query parameters
- provider: string · enum Required
Possible values:aws, azure, gcp - search: string · nullable Optional
Responses
200 OK
{
"name": "text",
"field": "text",
"type": "boolean",
"filters": [{
"field": "text",
"value": "text",
"op": "="
}]
}
400 Bad request
401 Unauthorized
403 Forbidden
404 Not found
405 Method not allowed
409 Conflict
422 Unprocessable Content
500 Internal server error
List catalog SKUs
get/beta/v1/org/{org_id}/catalog/skus
Returns SKUs from the public catalog plus the org's custom-priced SKUs, filtered to USD on-demand prices.
Path parameters
- org_id: string · uuid Required
Query parameters
- provider: string · enum Required
Possible values:aws, azure, gcp - search: string · nullable Optional
- filter: object · nullable Optional
Responses
200 OK
[
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"provider": "aws",
"provider_sku_id": "text",
"name": "text",
"family": "text",
"service": "text",
"provider_service": "text",
"region_code": "text",
"full_region_name": "text",
"instance_type": "text",
"instance_type_family": "text",
"usage_type": "text",
"operation": "text",
"operating_system": "text",
"tenancy": "text",
"database_engine": "text",
"database_edition": "text",
"cache_engine": "text",
"is_multi_az": true,
"is_current_generation": true,
"license_model": "text",
"pre_installed_sw": "text",
"processor_architecture": "text",
"vcpu": 1,
"memory": 1,
"is_reservable": true,
"is_public": true,
"ondemand_usage_unit": "text",
"ondemand_usage_price": 1,
"price_currency": "text"
}
]
Get catalog SKU detail
get/beta/v1/org/{org_id}/catalog/skus/{sku_id}
Returns the full SKU record including hardware specs and (when available) the on-demand pricing terms.
Path parameters
- org_id: string · uuid Required
- sku_id: string · uuid Required
Responses
200 OK
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"provider": "aws",
"provider_sku_id": "text",
"name": "text",
"family": "text",
"service": "text",
"provider_service": "text",
"region_code": "text",
"full_region_name": "text",
"instance_type": "text",
"instance_type_family": "text",
"usage_type": "text",
"operation": "text",
"operating_system": "text",
"tenancy": "text",
"database_engine": "text",
"database_edition": "text",
"cache_engine": "text",
"is_multi_az": true,
"is_current_generation": true,
"license_model": "text",
"pre_installed_sw": "text",
"processor_architecture": "text",
"vcpu": 1,
"memory": 1,
"is_reservable": true,
"is_public": true,
"ondemand_usage_unit": "text",
"ondemand_usage_price": 1,
"price_currency": "text",
"description": "text",
"location_type": "text",
"availability_zone": "text",
"physical_processor": "text",
"clock_speed": "text",
"processor_features": "text",
"network_performance": "text",
"storage": "text",
"dedicated_ebs_throughput": "text",
"io": "text",
"tax_type": "text",
"has_ondemand_terms": true,
"normalization_size_factor": 1,
"is_byol": true,
"integration_id": "123e4567-e89b-12d3-a456-426614174000",
"end_date": "2026-07-27T21:05:42.759Z",
"publication_date": "2026-07-27T21:05:42.759Z",
"updated_at": "2026-07-27",
"attributes": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"ondemand_terms": {}
}
400 Bad request
401 Unauthorized
403 Forbidden
404 Not Found
405 Method not allowed
409 Conflict
500 Internal server error
Compare commitment offers for a hypothetical CatalogSKU + quantity
get/beta/v1/org/{org_id}/catalog/skus/{sku_id}/offer-comparison
Returns every (offer, lease) candidate available for the SKU.
Path parameters
- org_id: string · uuid Required
- sku_id: string · uuid Required
Query parameters
- quantity: integer · min: 1 Optional
Responses
200 OK
{
"sku_id": "123e4567-e89b-12d3-a456-426614174000",
"quantity": 1,
"ondemand_baseline": {
"monthly_cost": 1,
"ondemand_usage_unit": "text",
"ondemand_usage_price": 1
},
"candidates": [
{
"offer_id": "123e4567-e89b-12d3-a456-426614174000",
"offer": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"provider": "aws",
"type": "text",
"region": "text",
"duration_seconds": 1,
"instance_type": "text",
"instance_family": "text",
"offering_class": "standard",
"payment_option": "no_upfront",
"plan_type": "text",
"product_description": "text",
"display_name": "text",
"guaranteed_display_name": "text",
"is_flexible": true
},
"lease_menu_item_id": "123e4567-e89b-12d3-a456-426614174000",
"selected_amount": 1,
"contract_term": "one_year_gris",
"payment_option": "no_upfront",
"discount_rate": 1,
"breakeven_days": 1,
"commitment_upfront_cost": 1,
"commitment_financials_monthly_rate": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1
},
"covered_ondemand_cost": 1
}
}
],
"targets": [
{
"contract_term": "one_year_gris",
"payment_option": "no_upfront",
"actual_term": "one_year_gris",
"actual_payment_option": "no_upfront",
"actual_term_reason": "exact_match",
"candidate": {
"offer_id": "123e4567-e89b-12d3-a456-426614174000",
"offer": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"provider": "aws",
"type": "text",
"region": "text",
"duration_seconds": 1,
"instance_type": "text",
"instance_family": "text",
"offering_class": "standard",
"payment_option": "no_upfront",
"plan_type": "text",
"product_description": "text",
"display_name": "text",
"guaranteed_display_name": "text",
"is_flexible": true
},
"lease_menu_item_id": "123e4567-e89b-12d3-a456-426614174000",
"selected_amount": 1,
"contract_term": "one_year_gris",
"payment_option": "no_upfront",
"discount_rate": 1,
"breakeven_days": 1,
"commitment_upfront_cost": 1,
"commitment_financials_monthly_rate": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1
},
"covered_ondemand_cost": 1
}
},
"commitment_financials_monthly_rate": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1
},
"covered_ondemand_cost": 1
},
"commitment_upfront_cost": 1,
"delta_vs_ondemand": {
"monthly_net_savings": 1,
"monthly_commitment_cost": 1,
"upfront_cost": 1
}
}
]
}