Version 3
Services API

Services API

Retrieve a Particular Service

GET /v2/services/:guid



GET /v2/services/b6ec5063-6c2c-43be-8d2f-266c352809ef


Name Description Valid Values Example Values
guid The guid of the Service


Name Description Default Valid Values Example Values
guid The guid of the service
label The name of the service
  • SomeMysqlService
description A short blurb describing the service
  • Mysql stores things for you
long_description A longer description of the service
  • Mysql is a database. It stores things. Use it in your apps...
info_url A url that points to an info page for the service
  • http://info.somemysqlservice.com
documentation_url A url that points to a documentation page for the service
  • http://docs.somemysqlservice.com
timeout A timeout used by the v1 service gateway client
active A boolean describing that the service can be provisioned by users false
bindable A boolean describing that the service can be bound to applications true
extra A JSON field with extra data pertaining to the service
  • {"providerDisplayName": "MyServiceProvider"}
unique_id A guid that identifies the service with the broker (not the same as the guid above)
tags A list of tags for the service []
  • database
  • mysql
requires A list of dependencies for services []
  • syslog_drain
provider The name of the service provider (used only by v1 service gateways)
  • MySql Provider
version The version of the service (used only by v1 service gateways)
  • 2.0
url The url of ther service provider (used only by v1 service gateways)
  • http://myql.provider.com
service_broker_guid The guid of the v2 service broker associated with the service
plan_updateable A boolean describing that an instance of this service can be updated to a different plan false


Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE3IiwiZW1haWwiOiJlbWFpbC0xN0Bzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDI1OTQ4NjU4fQ.2KxeR03XdxFyorefxsZl9V6dEafUs7GyxX7jgs6zQ8o
Host: example.org


curl "https://api.[your-domain.com]/v2/services/b6ec5063-6c2c-43be-8d2f-266c352809ef" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE3IiwiZW1haWwiOiJlbWFpbC0xN0Bzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDI1OTQ4NjU4fQ.2KxeR03XdxFyorefxsZl9V6dEafUs7GyxX7jgs6zQ8o" \
	-H "Host: example.org" \
	-H "Cookie: "



200 OK


  "metadata": {
    "guid": "b6ec5063-6c2c-43be-8d2f-266c352809ef",
    "url": "/v2/services/b6ec5063-6c2c-43be-8d2f-266c352809ef",
    "created_at": "2015-03-03T00:50:58Z",
    "updated_at": null
  "entity": {
    "label": "label-3",
    "provider": "provider-2",
    "url": "https://foo.com/url-5",
    "description": "desc-6",
    "long_description": null,
    "version": "version-2",
    "info_url": null,
    "active": true,
    "bindable": true,
    "unique_id": "c2a2a489-d780-409d-abd0-3b78103b2b8f",
    "extra": null,
    "tags": [

    "requires": [

    "documentation_url": null,
    "service_broker_guid": "b4062a06-040b-4114-b2aa-3d0faf6eee1b",
    "plan_updateable": false,
    "service_plans_url": "/v2/services/b6ec5063-6c2c-43be-8d2f-266c352809ef/service_plans"


Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: ef1bdfc6-4657-4ed1-aebb-9e573669b98a
Content-Length: 807
X-Content-Type-Options: nosniff