---
title: "List branch metadata"
method: GET
path: "/v2/storage/branch/{branchId}/metadata"
tags: ["Metadata"]
---

# List branch metadata

`GET /v2/storage/branch/{branchId}/metadata`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/branch/{branchId}/metadata`
- 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/metadata/get.ts> (a function with typed inputs; its response is checked against the schema)

Metadata can be listed for a branch.

All requests must include the branch (`/branch/{branchId}`) in the URL. This is also true for default (production) branch.
You can find out the id of your default branch by calling [List Branches](#tag/Development-Branches) and finding branch with attribute `isDefault` set to `true`.
Or you can use placeholder `default` to use with project's default branch.

## Path parameters

- `branchId` string, required

## Response `200`

Branch metadata list.

- MetadataItemWithoutProviderResponse[]
  - `id` string, required: Metadata record identifier
  - `key` string, required: Metadata key
  - `value` string, nullable, required: Metadata value
  - `timestamp` string, required: When the metadata was created or last updated, 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)