---
title: "Search component configurations by metadata"
method: GET
path: "/v2/storage/branch/{branchId}/search/component-configurations"
tags: ["Search"]
---

# Search component configurations by metadata

`GET /v2/storage/branch/{branchId}/search/component-configurations`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/branch/{branchId}/search/component-configurations`
- Auth: one of:
  - API key in header `X-StorageApi-Token`
  - API key in header `X-KBC-ManageApiToken`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/keboola/apis/keboola-storage-api/docs/v2/storage/branch/:branchId/search/component-configurations/get.ts> (a function with typed inputs; its response is checked against the schema)

Search all component configurations accessible by the token by any combination of
`idComponent`, `configurationId` and `metadataKeys`. Available only in branch context.

By default, each matching configuration is returned with just its `idComponent` and
`configurationId`. Pass `include=filteredMetadata` to also return the metadata entries that
matched the search.

## Path parameters

- `branchId` string, required

## Query parameters

- `idComponent` string
- `configurationId` string
- `metadataKeys` string[]
- `include` string

## Response `200`

List of component configurations matching the search criteria.

- object[]
  - `idComponent` string, required
  - `configurationId` string, required
  - `metadata` ConfigurationMetadataResponse[]: Metadata of the configuration matching the searched keys. Present only with `include=filteredMetadata`.
    - `id` string, required: Metadata entry id.
    - `key` string, required: Metadata key.
    - `value` string, required: Metadata value.
    - `timestamp` string, required: When the entry was last set, ISO 8601 with a `+hhmm` offset.

---

[API](https://skmtc.dev/keboola/apis/keboola-storage-api.md) - [All operations](https://skmtc.dev/keboola/apis/keboola-storage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keboola/apis/keboola-storage-api/revisions/34b5ceac0317?raw)