---
title: "Search snapshot resources with filters"
method: POST
path: "/backup-and-dr/snapshots/{snapshot_id}/resources/search"
---

# Search snapshot resources with filters

`POST /backup-and-dr/snapshots/{snapshot_id}/resources/search`

## Request

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

Advanced search endpoint for querying snapshot resources with multiple filters

## Path parameters

- `snapshot_id` string, uuid, required

## Request body

- ResourceSearchRequest
  - `query` ResourceQueryParams
    - `filters` object[]: Array of filters to apply
      - `key` 'asset_type' | 'region', required
      - `values` string[], required
    - `search` string: Search text for resource name or ID
  - `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 (empty = all available facets)

## Response `200`

Resource list

- ResourceListResponse
  - `data` SnapshotResource[]
    - `snapshot_id` string, uuid, required
    - `account_id` string, required
    - `integration_id` string, required
    - `frn` string, required
    - `resource_id` string, required
    - `asset_id` string
    - `arn` string
    - `provider` string, required
    - `service` string
    - `asset_type` string, required
    - `region` string, required
    - `name` string
    - `tf_object` string, required: Complete Terraform representation
    - `console_url` string
    - `account_name` string
    - `provider_id` string
    - `delete_command` string
    - `inventory_update_time` string, date-time
    - `resource_creation_date` string, date-time
    - `first_seen` string
    - `resource_status` string
    - `tagging_status` string
    - `provider_type` string
    - `provider_sub_type` string
    - `stack_id` string
    - `stack_name` string
    - `vcs_repo` string
    - `vcs_provider` string
    - `vcs_code_link` string
    - `state` string
    - `iac_type` string
    - `prev_state` string
    - `last_resource_state_change` string, date-time
    - `is_excluded` boolean
    - `is_locked` boolean
    - `is_out_of_sync` boolean
    - `is_event_driven` boolean
    - `ignored_drift` boolean
    - `drift` unknown[]: Complex nested drift structure
      - unknown
    - `tags` string: Raw tags string
    - `tags_list` string[]: Array of formatted tag strings
    - `classifications` string[]: Array of classification IDs
    - `monthly_cloud_cost_usd` number, float
    - `monthly_state_cost_usd` number, float
    - `discovery_type` 'scope' | 'dependency': 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
  - `summary` object
    - `total_resources` integer
    - `by_type` object
    - `by_region` object
  - `facets` Facet[]: Available filter options with counts
    - `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

---

[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)