---
title: "List SCA facet options"
method: POST
path: "/api/v1/sca/facets"
tags: ["SCA"]
---

# List SCA facet options

`POST /api/v1/sca/facets`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v1/sca/facets`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Retrieve global lists of dependencies and advisories for filter UIs.

## Request body

- ListScaFacetOptionsInput
  - `organizationId` string
  - `repositoryIds` string[]
  - `branch` string: Read each repository as of its newest finished scan on this branch. Omit for the newest scan on any branch.
  - `ecosystems` string[]
  - `facets` string[]: Which option lists to compute. Each is an independent query over a different population, so asking for fewer is faster. Omit to compute all of them. A facet that was not asked for is absent from the response rather than empty.

## Response `200`

Successful response

- ScaFacetOptions
  - `dependencies` string[]
  - `advisories` string[]
  - `ecosystems` string[]

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api-2.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api-2/revisions/ea6ae4b68cd3?raw)