---
title: "get the catalog of services that the service broker offers"
method: GET
path: "/v2/catalog"
tags: ["Catalog"]
---

# get the catalog of services that the service broker offers

`GET /v2/catalog`

## Headers

- `X-Broker-API-Version` string, required

## Response `200`

catalog response

- Catalog
  - `services` Service[]
    - `name` string, required
    - `id` string, required
    - `description` string, required
    - `tags` string[]
    - `requires` string[]
    - `bindable` boolean, required
    - `metadata` Metadata — See [Service Metadata Conventions](https://github.com/openservicebrokerapi/servicebroker/blob/master/profile.md#service-metadata) for more details.
    - `dashboard_client` DashboardClient
      - `id` string
      - `secret` string
      - `redirect_uri` string
    - `plan_updateable` boolean
    - `plans` Plan[], required
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `metadata` Metadata — See [Service Metadata Conventions](https://github.com/openservicebrokerapi/servicebroker/blob/master/profile.md#service-metadata) for more details.
      - `free` boolean
      - `bindable` boolean
      - `schemas` SchemasObject
        - `service_instance` ServiceInstanceSchemaObject
          - `create` SchemaParameters
            - `parameters` JSONSchemaObject
          - `update` SchemaParameters
            - `parameters` JSONSchemaObject
        - `service_binding` ServiceBindingSchemaObject
          - `create` SchemaParameters
            - `parameters` JSONSchemaObject

## Changes

- **2018-01-09** `48af75e14707` — 9 breaking
  - the `services/items/` response's property type changed from no type to `object` for status `200`
  - the `services/items/dashboard_client` response's property type changed from no type to `object` for status `200`
  - the `services/items/plans/items/` response's property type changed from no type to `object` for status `200`
  - the `services/items/plans/items/schemas` response's property type changed from no type to `object` for status `200`
  - …5 more
- **2017-12-18** `25da35d145fe` — 3 warning
  - added the new `route_forwarding` enum value to the `services/items/requires/items/` response property for the response status `200`
  - added the new `syslog_drain` enum value to the `services/items/requires/items/` response property for the response status `200`
  - added the new `volume_mount` enum value to the `services/items/requires/items/` response property for the response status `200`
- **2017-12-04** `72c4e57bd256` — 9 breaking, 5 warning, 3 info
  - the `services/items/` response's property type changed from `object` to no type for status `200`
  - the `services/items/dashboard_client` response's property type changed from `object` to no type for status `200`
  - the `services/items/plans/items/` response's property type changed from `object` to no type for status `200`
  - the `services/items/plans/items/schemas` response's property type changed from `object` to no type for status `200`
  - …13 more

[Change history](https://skmtc.dev/cloudfoundry/apis/open-service-broker-api/changes/v2/catalog/get.md)

---

[API](https://skmtc.dev/cloudfoundry/apis/open-service-broker-api.md) · [All operations](https://skmtc.dev/cloudfoundry/apis/open-service-broker-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudfoundry/open-service-broker-api/revisions/0caa6bfec4d2/schema)