---
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.
      - `maintenance_info` MaintenanceInfo
        - `version` string, required
        - `description` string
      - `free` boolean
      - `bindable` boolean
      - `schemas` Schemas
        - `service_instance` ServiceInstanceSchema
          - `create` SchemaParameters
            - `parameters` JSONSchema — unresolved $ref
          - `update` SchemaParameters
            - `parameters` JSONSchema — unresolved $ref
        - `service_binding` ServiceBindingSchema
          - `create` SchemaParameters
            - `parameters` JSONSchema — unresolved $ref

## Changes

- **2019-05-29** `50d6a39faad0` — 1 info
  - added the optional property `services/items/plans/items/maintenance_info` to the response with the `200` status
- **2019-05-16** `455de227e749` — 1 warning
  - removed the optional property `services/items/plans/items/maintenance_info` from the response with the `200` status
- **2019-05-14** `2aba5b99264e` — 1 info
  - added the optional property `services/items/plans/items/maintenance_info` to the response with the `200` status
- **2018-03-02** `54be76963a72` — 3 breaking
  - the `services/items/plans/items/schemas/service_binding/create/parameters` response's property type changed from `object` to no type for status `200`
  - the `services/items/plans/items/schemas/service_instance/create/parameters` response's property type changed from `object` to no type for status `200`
  - the `services/items/plans/items/schemas/service_instance/update/parameters` response's property type changed from `object` to no type for status `200`
- **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

[Full 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/f5fcf232eed3/schema)