> ## Documentation Index > Fetch the complete documentation index at: https://docs.tolmo.com/llms.txt > Use this file to discover all available pages before exploring further. # List finding filter facets > Return the available filter values (status, severity, and related dimensions) with their counts for the current query, for building filter UIs without a second full scan. Applies the same visibility rules as listing findings. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/orgs/{orgSlug}/findings/facets openapi: 3.0.3 info: title: Tolmo API version: 1.0.0 description: >- The Tolmo REST API. Every endpoint is scoped to one organization and authenticated with an API token. servers: - url: https://api.tolmo.com description: Production security: - bearerAuth: [] paths: /api/v1/orgs/{orgSlug}/findings/facets: get: tags: - findings summary: List finding filter facets description: >- Return the available filter values (status, severity, and related dimensions) with their counts for the current query, for building filter UIs without a second full scan. Applies the same visibility rules as listing findings. operationId: apiListFindingsFacets parameters: - schema: type: string enum: - open - in_review - closed - acknowledged - false_positive - canceled in: query name: status required: false - schema: type: string enum: - critical - high - medium - low - info in: query name: severity required: false - schema: anyOf: - type: string enum: - open - in_review - closed - acknowledged - false_positive - canceled - type: array items: type: string enum: - open - in_review - closed - acknowledged - false_positive - canceled in: query name: statuses required: false - schema: anyOf: - type: string enum: - open - in_review - closed - acknowledged - false_positive - canceled - type: array items: type: string enum: - open - in_review - closed - acknowledged - false_positive - canceled in: query name: statusExcluded required: false - schema: anyOf: - type: string enum: - critical - high - medium - low - info - type: array items: type: string enum: - critical - high - medium - low - info in: query name: severities required: false - schema: anyOf: - type: string enum: - critical - high - medium - low - info - type: array items: type: string enum: - critical - high - medium - low - info in: query name: severityExcluded required: false - schema: anyOf: - type: string - type: array items: type: string in: query name: source required: false - schema: anyOf: - type: string - type: array items: type: string in: query name: sourceExcluded required: false - schema: anyOf: - type: string - type: array items: type: string in: query name: agent required: false - schema: anyOf: - type: string - type: array items: type: string in: query name: agentExcluded required: false - schema: type: string maxLength: 512 in: query name: q required: false - schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ in: query name: createdAfter required: false - schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ in: query name: createdBefore required: false - schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ in: query name: updatedAfter required: false - schema: type: string pattern: ^\d{4}-\d{2}-\d{2}$ in: query name: updatedBefore required: false - schema: type: boolean in: query name: includeDrafts required: false - schema: type: boolean in: query name: draftsOnly required: false - schema: type: string in: path name: orgSlug required: true responses: '200': description: Default Response content: application/json: schema: type: object properties: severities: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false statuses: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false sources: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false agents: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false createdBy: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false visibilities: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false categories: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false owasps: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false impactCategories: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false fixPriorities: type: array items: type: object properties: value: type: string label: type: string count: type: integer minimum: 0 maximum: 9007199254740991 required: - value - label - count additionalProperties: false required: - severities - statuses - sources - agents - createdBy - visibilities - categories - owasps - impactCategories - fixPriorities additionalProperties: false '403': description: Default Response content: application/json: schema: $ref: '#/components/schemas/HttpError' components: schemas: HttpError: type: object properties: statusCode: type: number code: type: string error: type: string message: type: string title: HttpError securitySchemes: bearerAuth: type: http scheme: bearer description: >- A Tolmo API token, sent as `Authorization: Bearer `. Either a user token (`usr_tok.*`, minted by `tolmo auth login`, scoped to your own permissions) or an org API token created in the Tolmo app, for CI and automation. ````