Version 3
App Usage Events API

App Usage Events API

List all App Usage Events

GET /v2/app_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 app or 'BUILDPACK_SET' when buildpack info has been set.
instance_count How many instance of the app.
memory_in_mb_per_instance How much memory per app instance.
  • 128
  • 256
  • 512
app_guid The GUID of the app.
app_name The name of the app.
org_guid The GUID of the organization.
space_guid The GUID of the space.
space_name The name of the space.
buildpack_guid The GUID of the buildpack used to stage the app.
buildpack_name The name of the buildpack or the URL of the custom buildpack used to stage the app.
  • https://example.com/buildpack.git
  • admin_buildpack
created_at The timestamp when the event is recorded. It is possible that later events may have earlier created_at values.


Name Description Valid Values Example Values
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 App Usage Events after the one with the given guid



Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTYwIiwiZW1haWwiOiJlbWFpbC01M0Bzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDE3NDYyMzU0fQ.qmQa5v0JfI_LQVQHW4VOA05FZslu8iWqrcGEtSiouXQ
Host: example.org


GET /v2/app_usage_events?results-per-page=1&after_guid=66c6a58a-fd88-4e27-a367-9c075a502891

Query Parameters

results-per-page: 1
after_guid: 66c6a58a-fd88-4e27-a367-9c075a502891


curl "https://api.[your-domain.com]/v2/app_usage_events?results-per-page=1&after_guid=66c6a58a-fd88-4e27-a367-9c075a502891" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTYwIiwiZW1haWwiOiJlbWFpbC01M0Bzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDE3NDYyMzU0fQ.qmQa5v0JfI_LQVQHW4VOA05FZslu8iWqrcGEtSiouXQ" \
	-H "Host: example.org" \
	-H "Cookie: "



Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 532935e2-53d2-4f25-bd12-2d4a38671a3a
Content-Length: 937
X-Content-Type-Options: nosniff


200 OK


  "total_results": 2,
  "total_pages": 2,
  "prev_url": null,
  "next_url": "/v2/app_usage_events?after_guid=66c6a58a-fd88-4e27-a367-9c075a502891&order-direction=asc&page=2&results-per-page=1",
  "resources": [
      "metadata": {
        "guid": "34166b75-e923-48e3-bc7e-8d9cef8552dc",
        "url": "/v2/app_usage_events/34166b75-e923-48e3-bc7e-8d9cef8552dc",
        "created_at": "2014-11-24T19:32:34+00:00"
      "entity": {
        "state": "STARTED",
        "memory_in_mb_per_instance": 564,
        "instance_count": 1,
        "app_guid": "guid-fab9bca8-32f9-412a-b5f7-33091d9c9603",
        "app_name": "name-403",
        "space_guid": "guid-aed7848a-506d-4737-bfe3-4ce23ed49be6",
        "space_name": "name-404",
        "org_guid": "guid-100f29fe-9ad0-4ddb-a83c-40875bb2aff3",
        "buildpack_guid": "guid-3cade142-0cda-4b2b-82ca-17bc15f0b2f6",
        "buildpack_name": "name-405"