Version 3
Service Usage Events (experimental) API

Service Usage Events (experimental) API

List Service Usage Events

GET /v2/service_usage_events

Events are sorted by internal database IDs. This order may differ from created_at. Events close to the current time should not be processed because other events may still have open transactions that will change their order in the results.


Name Description Default Valid Values Example Values
guid The guid of the event.
state The desired state of the service.
org_guid The GUID of the organization.
space_guid The GUID of the space.
space_name The name of the space.
service_instance_guid The GUID of the service instance.
service_instance_name The name of the service instance.
service_instance_type The type of the service instance.
  • managed_service_instance
  • user_provided_service_instance
service_plan_guid The GUID for the service plan.
service_plan_name The name for the service plan.
service_guid The GUID of the service.
created_at The timestamp of the event creation.
serivce_label The name of the service.


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: service_instance_type
  • 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
after_guid Restrict results to Service Usage Events after the one with the given guid



Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTIyMiIsImVtYWlsIjoiZW1haWwtMTU0QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MjQ0NzE2OTh9.x04s5Bem0VS7xQSPBXfd_9kum4HC9hcz47gU0pG6mGE
Host: example.org


GET /v2/service_usage_events?results-per-page=1&after_guid=6e7889ce-176d-49bb-857c-fd0e6d4d7994

Query Parameters

results-per-page: 1
after_guid: 6e7889ce-176d-49bb-857c-fd0e6d4d7994


curl "https://api.[your-domain.com]/v2/service_usage_events?results-per-page=1&after_guid=6e7889ce-176d-49bb-857c-fd0e6d4d7994" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTIyMiIsImVtYWlsIjoiZW1haWwtMTU0QHNvbWVkb21haW4uY29tIiwic2NvcGUiOlsiY2xvdWRfY29udHJvbGxlci5hZG1pbiJdLCJhdWQiOlsiY2xvdWRfY29udHJvbGxlciJdLCJleHAiOjE0MjQ0NzE2OTh9.x04s5Bem0VS7xQSPBXfd_9kum4HC9hcz47gU0pG6mGE" \
	-H "Host: example.org" \
	-H "Cookie: "



Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 5fe49433-d320-46b5-b8c2-48e9937ec689
Content-Length: 1053
X-Content-Type-Options: nosniff


200 OK


  "total_results": 2,
  "total_pages": 2,
  "prev_url": null,
  "next_url": "/v2/service_usage_events?after_guid=6e7889ce-176d-49bb-857c-fd0e6d4d7994&order-direction=asc&page=2&results-per-page=1",
  "resources": [
      "metadata": {
        "guid": "4743e3f1-7989-4591-a25b-cf5cb45d0c89",
        "url": "/v2/service_usage_events/4743e3f1-7989-4591-a25b-cf5cb45d0c89",
        "created_at": "2015-02-13T22:34:58Z"
      "entity": {
        "state": "CREATED",
        "org_guid": "guid-b469a85f-4cf5-4475-9f8c-0928f2424509",
        "space_guid": "guid-588d5f63-d63b-4945-89d7-d0cb6cd2a081",
        "space_name": "name-1367",
        "service_instance_guid": "guid-d4d10771-4b35-48b0-9267-1bb6fdef5061",
        "service_instance_name": "name-1368",
        "service_instance_type": "type-8",
        "service_plan_guid": "guid-af7df924-cec3-49c7-b037-7d04af36baf8",
        "service_plan_name": "name-1369",
        "service_guid": "guid-9861f80c-1dd1-4d85-a190-6ac3f0c1e2b2",
        "service_label": "label-41"