> 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/artifact-registry/api-reference/registry-v3-filters.md).

# Registry V3 Filters

## List Filters

> List filter definitions available for the requested \`resource\_type\`\
> (REGISTRY, PACKAGE, or VERSION).\
> \
> Filters returned depend on the scope inferred from the supplied\
> identifiers (ACCOUNT / ORG / PROJECT). For PACKAGE and VERSION\
> resource types, if \`package\_type\` is provided the response is\
> augmented with type-specific filters (e.g. Docker, Maven, npm).\
> \`package\_type\` is ignored when \`resource\_type=REGISTRY\`.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[],"servers":[{"url":"/api"}],"paths":{"/v3/filters":{"get":{"description":"List filter definitions available for the requested `resource_type`\n(REGISTRY, PACKAGE, or VERSION).\n\nFilters returned depend on the scope inferred from the supplied\nidentifiers (ACCOUNT / ORG / PROJECT). For PACKAGE and VERSION\nresource types, if `package_type` is provided the response is\naugmented with type-specific filters (e.g. Docker, Maven, npm).\n`package_type` is ignored when `resource_type=REGISTRY`.\n","operationId":"ListFiltersV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/FilterResourceTypeParamV3"},{"$ref":"#/components/parameters/PackageTypeFilterParamV3"},{"$ref":"#/components/parameters/FilterIdOptionalParamV3"},{"$ref":"#/components/parameters/SearchTermV3"}],"responses":{"200":{"$ref":"#/components/responses/ListFiltersResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"List Filters","tags":["Registry V3 - Filters"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"FilterResourceTypeParamV3":{"description":"Resource type whose filter definitions should be returned.\n","in":"query","name":"resource_type","required":true,"schema":{"$ref":"#/components/schemas/FilterResourceTypeV3"}},"PackageTypeFilterParamV3":{"description":"Filter by package type","in":"query","name":"package_type","schema":{"type":"string"}},"FilterIdOptionalParamV3":{"description":"Optional filter identifier. When provided, returns only the\nfilter definition matching this id.\n","in":"query","name":"filter_id","schema":{"type":"string"}},"SearchTermV3":{"description":"Search term for filtering results.\n\nExample: `search_term=prod` might match keys like \"production\", \"prod-env\", etc.\n","in":"query","name":"search_term","schema":{"type":"string"}}},"schemas":{"FilterResourceTypeV3":{"description":"Resource type whose filter definitions are requested by\n`GET /filters?resource_type=...`.\n","enum":["REGISTRY","PACKAGE","VERSION"],"type":"string"},"ListFiltersResponseBodyV3":{"description":"Response body for a list filters query. Contains a single merged\nlist of filter definitions — static filters (from configuration)\nfollowed by dynamic metadata filters (one per user-defined\nmetadata key, identified by `metadata.<key>`). The list is\ncapped server-side (currently at 100 dynamic entries) and is not\npaginated; `search_term` narrows both static and dynamic\nentries.\n","properties":{"filters":{"description":"Combined filter definitions available for the requested\n`resource_type`, in a stable order: static filters first\n(in configured order), followed by dynamic metadata filters.\n","items":{"$ref":"#/components/schemas/FilterDefinitionV3"},"type":"array"}},"required":["filters"],"type":"object"},"FilterDefinitionV3":{"description":"Definition of a filter that can be applied when listing a resource.","properties":{"conditions":{"description":"Comparison conditions supported by this filter.","items":{"$ref":"#/components/schemas/FilterConditionV3"},"type":"array"},"dataType":{"$ref":"#/components/schemas/FilterDataTypeV3"},"field":{"description":"Backend field name the filter maps to.","type":"string"},"id":{"description":"Stable identifier for the filter.","type":"string"},"inputType":{"$ref":"#/components/schemas/FilterInputTypeV3"},"label":{"description":"Human-readable label for the filter.","type":"string"},"supportsOptions":{"description":"Whether the filter supports a dynamic set of option values.","type":"boolean"}},"required":["id","label","field","dataType","inputType","conditions","supportsOptions"],"type":"object"},"FilterConditionV3":{"description":"Supported comparison condition for a filter.","enum":["EQ","NE","GT","LT","CONTAINS","STARTS_WITH","ENDS_WITH","IN","NOT_IN"],"type":"string"},"FilterDataTypeV3":{"description":"Data type of a filter field.","enum":["string","number","boolean"],"type":"string"},"FilterInputTypeV3":{"description":"UI input control used to render a filter field.","enum":["text","number","checkbox","singleSelect","multiSelect"],"type":"string"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}},"responses":{"ListFiltersResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFiltersResponseBodyV3"}}},"description":"response for list filters"}}}}
```

## List Filter Options

> List the selectable values for a single filter identified by\
> \`filter\_id\`. Same authorization and scoping semantics as\
> \`GET /filters\`. \`package\_type\` is only meaningful for filters on\
> PACKAGE and VERSION resources and is ignored otherwise;\
> \`search\_term\` narrows the returned options in place of\
> pagination.<br>

```json
{"openapi":"3.0.0","info":{"title":"Harness Artifact Registry API","version":"1.0.0"},"tags":[],"servers":[{"url":"/api"}],"paths":{"/v3/filters/options":{"get":{"description":"List the selectable values for a single filter identified by\n`filter_id`. Same authorization and scoping semantics as\n`GET /filters`. `package_type` is only meaningful for filters on\nPACKAGE and VERSION resources and is ignored otherwise;\n`search_term` narrows the returned options in place of\npagination.\n","operationId":"ListFilterOptionsV3","parameters":[{"$ref":"#/components/parameters/AccountIdentifierV3"},{"$ref":"#/components/parameters/OrgIdentifierV3"},{"$ref":"#/components/parameters/ProjectIdentifierV3"},{"$ref":"#/components/parameters/FilterResourceTypeParamV3"},{"$ref":"#/components/parameters/FilterIdParamV3"},{"$ref":"#/components/parameters/PackageTypeFilterParamV3"},{"$ref":"#/components/parameters/OptionValuesParamV3"},{"$ref":"#/components/parameters/SearchTermV3"}],"responses":{"200":{"$ref":"#/components/responses/ListFilterOptionsResponseV3"},"default":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorV3"}}},"description":"Error response."}},"summary":"List Filter Options","tags":["Registry V3 - Filters"]}}},"components":{"parameters":{"AccountIdentifierV3":{"description":"Unique identifier for the Harness account.\n","in":"query","name":"account_identifier","required":true,"schema":{"type":"string"}},"OrgIdentifierV3":{"description":"Unique identifier for the organization within the account.\n\nExample: `default` or `engineering_org`\n","in":"query","name":"org_identifier","schema":{"type":"string"}},"ProjectIdentifierV3":{"description":"Unique identifier for the project within the organization.\n\nExample: `my_project` or `frontend_services`\n","in":"query","name":"project_identifier","schema":{"type":"string"}},"FilterResourceTypeParamV3":{"description":"Resource type whose filter definitions should be returned.\n","in":"query","name":"resource_type","required":true,"schema":{"$ref":"#/components/schemas/FilterResourceTypeV3"}},"FilterIdParamV3":{"description":"Identifier of the filter whose selectable options should be\nreturned. Matches `FilterDefinitionV3.id` from\n`GET /filters`, including namespaced ids for dynamic filters\n(e.g. `metadata.env`).\n","in":"query","name":"filter_id","required":true,"schema":{"type":"string"}},"PackageTypeFilterParamV3":{"description":"Filter by package type","in":"query","name":"package_type","schema":{"type":"string"}},"OptionValuesParamV3":{"description":"Optional list of option values. When provided, returns only the\noptions whose values match one of the supplied values.\n","in":"query","name":"option_values","schema":{"items":{"type":"string"},"type":"array"},"style":"form"},"SearchTermV3":{"description":"Search term for filtering results.\n\nExample: `search_term=prod` might match keys like \"production\", \"prod-env\", etc.\n","in":"query","name":"search_term","schema":{"type":"string"}}},"schemas":{"FilterResourceTypeV3":{"description":"Resource type whose filter definitions are requested by\n`GET /filters?resource_type=...`.\n","enum":["REGISTRY","PACKAGE","VERSION"],"type":"string"},"ListFilterOptionsResponseBodyV3":{"description":"Response body for `GET /filters/options`. Returns the set of\nselectable values for a single filter. The list is bounded\nserver-side; `search_term` narrows it in place of pagination.\n","properties":{"options":{"description":"Selectable values for the requested filter.","items":{"$ref":"#/components/schemas/FilterOptionV3"},"type":"array"}},"required":["options"],"type":"object"},"FilterOptionV3":{"description":"One selectable value for a filter with `supportsOptions=true`.","properties":{"label":{"description":"Human-readable label for the value.","type":"string"},"value":{"description":"Value to send back when applying the filter.","type":"string"}},"required":["value","label"],"type":"object"},"ErrorV3":{"description":"An error response","properties":{"error":{"$ref":"#/components/schemas/ApiErrorsV3"}},"required":["error"],"type":"object"},"ApiErrorsV3":{"properties":{"code":{"description":"For some errors that could be handled programmatically, a short string indicating the [error code](https://docs.stripe.com/error-codes) reported.","maxLength":5000,"type":"string"},"message":{"description":"A human-readable message providing more details about the error. These messages can be shown to users.","maxLength":40000,"type":"string"},"param":{"description":"If the error is parameter-specific, the parameter related to the error. For example, we can use this to display a message near the correct form field.","maxLength":5000,"type":"string"},"type":{"description":"The type of error returned.","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","API_ERROR"],"type":"string"}},"required":["type"],"title":"APIErrors","type":"object"}},"responses":{"ListFilterOptionsResponseV3":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListFilterOptionsResponseBodyV3"}}},"description":"response for list filter options"}}}}
```
