> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/api-reference/cost-management-agent-apis/commitment-orchestrator/filter-apis.md).

# Filter APIs

## Get all filter options

> Retrieves all available filter options including regions, instance families, and provider account IDs for the specified account and optional date range.

```json
{"openapi":"3.0.1","info":{"title":"Commitment Orchestrator APIs","version":"1.0.0"},"tags":[],"servers":[{"url":"https://app.harness.io/gateway","description":"Production server"}],"paths":{"/accounts/{account_id}/v1/filters":{"post":{"tags":["Filter APIs"],"summary":"Get all filter options","description":"Retrieves all available filter options including regions, instance families, and provider account IDs for the specified account and optional date range.","operationId":"GetFilters","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string"},"description":"Account Identifier for the entity"},{"name":"routingId","in":"query","required":true,"schema":{"type":"string"},"description":"Routing identifier for request processing"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Start date for filtering data (YYYY-MM-DD format)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"End date for filtering data (YYYY-MM-DD format)"},{"name":"service","in":"query","required":false,"schema":{"type":"string","enum":["Amazon Elastic Compute Cloud - Compute","Amazon Relational Database Service"]},"description":"AWS service type for filtering. Supported services are EC2 and RDS"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilterResponse"}}}},"400":{"description":"Invalid request parameters or unsupported service"}}}}},"components":{"schemas":{"FilterResponse":{"type":"object","properties":{"region":{"type":"array","items":{"type":"string"},"description":"List of available AWS regions"},"instance_family":{"type":"array","items":{"type":"string"},"description":"List of available instance families"},"account_id":{"type":"array","items":{"type":"string"},"description":"List of available cloud provider account IDs"}},"required":["region","instance_family","account_id"]}}}}
```

## Get available regions

> Retrieves all available AWS regions for the specified account and optional date range.

```json
{"openapi":"3.0.1","info":{"title":"Commitment Orchestrator APIs","version":"1.0.0"},"tags":[],"servers":[{"url":"https://app.harness.io/gateway","description":"Production server"}],"paths":{"/accounts/{account_id}/v1/filters/regions":{"post":{"tags":["Filter APIs"],"summary":"Get available regions","description":"Retrieves all available AWS regions for the specified account and optional date range.","operationId":"GetRegionFilters","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string"},"description":"Account Identifier for the entity"},{"name":"routingId","in":"query","required":true,"schema":{"type":"string"},"description":"Routing identifier for request processing"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Start date for filtering data (YYYY-MM-DD format)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"End date for filtering data (YYYY-MM-DD format)"},{"name":"service","in":"query","required":false,"schema":{"type":"string","enum":["Amazon Elastic Compute Cloud - Compute","Amazon Relational Database Service","VirtualMachines"]},"description":"Service type for filtering. Supported services are AWS EC2, AWS RDS and Azure VirtualMachines"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}},"400":{"description":"Invalid request parameters or unsupported service"}}}}}}
```

## Get available instance families

> Retrieves all available instance families for the specified account and optional date range.

```json
{"openapi":"3.0.1","info":{"title":"Commitment Orchestrator APIs","version":"1.0.0"},"tags":[],"servers":[{"url":"https://app.harness.io/gateway","description":"Production server"}],"paths":{"/accounts/{account_id}/v1/filters/instancefamilies":{"post":{"tags":["Filter APIs"],"summary":"Get available instance families","description":"Retrieves all available instance families for the specified account and optional date range.","operationId":"GetInstanceFamilyFilters","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string"},"description":"Account Identifier for the entity"},{"name":"routingId","in":"query","required":true,"schema":{"type":"string"},"description":"Routing identifier for request processing"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Start date for filtering data (YYYY-MM-DD format)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"End date for filtering data (YYYY-MM-DD format)"},{"name":"service","in":"query","required":false,"schema":{"type":"string","enum":["Amazon Elastic Compute Cloud - Compute","Amazon Relational Database Service","VirtualMachines"]},"description":"Service type for filtering. Supported services are AWS EC2, AWS RDS and Azure VirtualMachines"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}},"400":{"description":"Invalid request parameters or unsupported service"}}}}}}
```

## Get available provider account IDs

> Retrieves all available cloud provider account IDs for the specified account and optional date range.

```json
{"openapi":"3.0.1","info":{"title":"Commitment Orchestrator APIs","version":"1.0.0"},"tags":[],"servers":[{"url":"https://app.harness.io/gateway","description":"Production server"}],"paths":{"/accounts/{account_id}/v1/filters/provideraccounts":{"post":{"tags":["Filter APIs"],"summary":"Get available provider account IDs","description":"Retrieves all available cloud provider account IDs for the specified account and optional date range.","operationId":"GetProviderAccountFilters","parameters":[{"name":"account_id","in":"path","required":true,"schema":{"type":"string"},"description":"Account Identifier for the entity"},{"name":"routingId","in":"query","required":true,"schema":{"type":"string"},"description":"Routing identifier for request processing"},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Start date for filtering data (YYYY-MM-DD format)"},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"End date for filtering data (YYYY-MM-DD format)"},{"name":"service","in":"query","required":false,"schema":{"type":"string","enum":["Amazon Elastic Compute Cloud - Compute","Amazon Relational Database Service","VirtualMachines"]},"description":"Service type for filtering. Supported services are AWS EC2, AWS RDS and Azure VirtualMachines"}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"}}}}},"400":{"description":"Invalid request parameters or unsupported service"}}}}}}
```
