---
title: "Search preview resources with filters"
method: POST
path: "/backup-and-dr/policies/preview/{preview_id}/search"
---

# Search preview resources with filters

`POST /backup-and-dr/policies/preview/{preview_id}/search`

## Request

- Base URL: `https://api.firefly.ai/v2`
- URL: `https://api.firefly.ai/v2/backup-and-dr/policies/preview/{preview_id}/search`
- Auth: none declared
- TypeScript: <https://skmtc.dev/firefly/apis/backup-dr-api/docs/backup-and-dr/policies/preview/:preview_id/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Advanced search endpoint for querying preview resources with multiple filters and facets

## Path parameters

- `preview_id` string, required: Preview ID returned from preview request

## Request body

- PreviewResourceSearchRequest
  - `query` PreviewResourceQueryParams
    - `filters` object[]: Array of filters to apply
      - `key` 'asset_type' | 'region' | 'discovery_type', required
      - `values` string[], required
    - `search` string: Search text for resource name or FRN
  - `page` integer
  - `page_size` integer
  - `facet_page` integer: Page number for facet values pagination
  - `facet_page_size` integer: Page size for facet values pagination
  - `facet_fields` string[]: Specific facet fields to return

## Response `200`

Preview resources search results

- PreviewResourceSearchResponse
  - `data` PreviewResource[]
    - `frn` string, required: Firefly Resource Name (unique resource identifier)
    - `asset_type` string, required: Resource asset type
    - `asset_name` string, required: Resource name
    - `region` string, required: AWS region
    - `provider` string, required: Cloud provider (e.g., aws, gcp, azure)
    - `service` string: Cloud service (e.g., ec2, s3)
    - `tags_list` string[]: Resource tags
    - `created_at` string, date-time, nullable: Resource creation timestamp
    - `discovery_type` 'scope' | 'dependency', required: Indicates how the resource was discovered - "scope" (matched by application scope) or "dependency" (found via traversal)
    - `parent_frn` string, nullable: The FRN of the parent resource if this resource was discovered as a dependency
  - `pagination` Pagination
    - `page` integer, required
    - `page_size` integer, required
    - `total` integer, required
    - `has_next` boolean, required
    - `has_prev` boolean, required
  - `facets` Facet[]
    - `field` string, required: The name of the field (e.g., 'integration_id', 'region', 'status')
    - `size` integer, required: The total number of unique values for this field
    - `pagination` Pagination, required
      - `page` integer, required
      - `page_size` integer, required
      - `total` integer, required
      - `has_next` boolean, required
      - `has_prev` boolean, required
    - `values` FacetValue[], required: Array of available values with their occurrence counts
      - `value` string: The value of the facet (e.g., 'us-east-1', 'Active')
      - `count` integer: Number of items that match this value

## Other responses

- `400`: Invalid request
- `404`: Preview not found
- `500`: Internal server error

---

[API](https://skmtc.dev/firefly/apis/backup-dr-api.md) - [All operations](https://skmtc.dev/firefly/apis/backup-dr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/firefly/apis/backup-dr-api/revisions/ff4cd0352ad5?raw)