# 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**

```json
{
  "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**

```json
{
  "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**

```json
[
  {
    "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**

```json
{
  "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**

```json
{
  "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
      }
    }
  ]
}
```
