---
title: "get a service binding"
method: GET
path: "/v2/service_instances/{instance_id}/service_bindings/{binding_id}"
tags: ["ServiceBindings"]
---

# get a service binding

`GET /v2/service_instances/{instance_id}/service_bindings/{binding_id}`

## Path parameters

- `instance_id` string, required
- `binding_id` string, required

## Query parameters

- `service_id` string
- `plan_id` string

## Headers

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

## Response `200`

OK

- ServiceBindingResource
  - `metadata` ServiceBindingMetadata
    - `expires_at` string
    - `renew_before` string
  - `credentials` Object
  - `syslog_drain_url` string
  - `route_service_url` string
  - `volume_mounts` ServiceBindingVolumeMount[]
    - `driver` string, required
    - `container_dir` string, required
    - `mode` 'r' | 'rw', required
    - `device_type` 'shared', required
    - `device` ServiceBindingVolumeMountDevice, required
      - `volume_id` string, required
      - `mount_config` Object
      - `device_config` Object
  - `endpoints` ServiceBindingEndpoint[]
    - `host` string, required
    - `ports` string[], required
    - `protocol` 'tcp' | 'udp' | 'all'
  - `parameters` Object

## Other responses

- `404` — Not Found

## Changes

- **2026-07-17** `8e8ca70f8e59` — 1 info
  - added the optional property `volume_mounts/items/device/device_config` to the response with the `200` status
- **2020-05-18** `8cf18c79937e` — 1 info
  - added the optional property `metadata/renew_before` to the response with the `200` status
- **2020-05-12** `c02c8ad06b20` — 1 warning
  - removed the optional property `metadata/renew_before` from the response with the `200` status
- **2020-04-28** `25dd370ccbb1` — 1 info
  - added the optional property `metadata/renew_before` to the response with the `200` status
- **2020-03-06** `bb48766a73bc` — 1 warning
  - removed the optional property `metadata/renew_before` from the response with the `200` status

[Full history](https://skmtc.dev/cloudfoundry/apis/open-service-broker-api/changes/v2/service_instances/:instance_id/service_bindings/:binding_id/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/8e8ca70f8e59/schema)