---
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`

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.net/firefly/apis/backup-dr-api.md) · [All operations](https://skmtc.net/firefly/apis/backup-dr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/backup-dr-api/revisions/ff4cd0352ad5/schema)