Version 3
Service Plans API

Service Plans API

List all Service Plans

GET /v2/service_plans



GET /v2/service_plans


Name Description Valid Values Example Values
q Parameters used to filter the result set.
Format queries as <filter><op><value>
Valid ops: : >= <= < > IN
Valid filters: active, service_guid, service_instance_guid, service_broker_guid
  • q=filter:value
  • q=filter>value
  • q=filter IN a,b,c
page Page of results to fetch
results-per-page Number of results per page
order-direction Order of the results: asc (default) or desc
inline-relations-depth 0 - don't inline any relations and return URLs. Otherwise, inline to depth N.
orphan-relations 0 - de-duplicate object entries in response
exclude-relations comma-delimited list of relations to drop from response
include-relations comma-delimited list of the only relations to include in response


Name Description Default Valid Values Example Values
guid The guid of the service plan
name The name of the service plan
  • 100mb
free A boolean describing if the service plan is free
  • true
  • false
description A description of the service plan
  • Let's you put data in your database!
extra A JSON string with additional data about the plan
  • {"cost": "$2.00"}
unique_id A guid for the service plan in the service broker (not the same as the cloud controller guid)
public A boolean describing that the plan is visible to the all users true
service_guid The guid of the related service
  • deadbeef
active A boolean that determines whether plans can be used to create new instances.
  • true
  • false


Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE3MiIsImVtYWlsIjoiZW1haWwtMTE3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0Mzk0MjYxOTl9.odQcEUELeFzTVfCYQj77ZeAB_tOtvdJECVrp-lHmLLo
Host: example.org


curl "https://api.[your-domain.com]/v2/service_plans" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE3MiIsImVtYWlsIjoiZW1haWwtMTE3QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0Mzk0MjYxOTl9.odQcEUELeFzTVfCYQj77ZeAB_tOtvdJECVrp-lHmLLo" \
	-H "Host: example.org" \
	-H "Cookie: "



200 OK


  "total_results": 1,
  "total_pages": 1,
  "prev_url": null,
  "next_url": null,
  "resources": [
      "metadata": {
        "guid": "49cc1cf9-a77f-48f6-9741-cb0f2874e636",
        "url": "/v2/service_plans/49cc1cf9-a77f-48f6-9741-cb0f2874e636",
        "created_at": "2015-08-06T00:36:39Z",
        "updated_at": null
      "entity": {
        "name": "name-605",
        "free": false,
        "description": "desc-64",
        "service_guid": "8fbc435a-63de-44d8-970e-a6adc4e3bdcb",
        "extra": null,
        "unique_id": "82a2fb77-61e2-4aa4-b113-62b8d3f5cc0c",
        "public": true,
        "active": true,
        "service_url": "/v2/services/8fbc435a-63de-44d8-970e-a6adc4e3bdcb",
        "service_instances_url": "/v2/service_plans/49cc1cf9-a77f-48f6-9741-cb0f2874e636/service_instances"


Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 5bd3917f-3fa8-49ff-9769-7de94a38c1c2
Content-Length: 840
X-Content-Type-Options: nosniff