Version 3
Apps API

Apps API

Get App summary

GET /v2/apps/:guid/summary



GET /v2/apps/cd897c8c-3171-456d-b5d7-3c87feeabbd1/summary


Name Description Default Valid Values Example Values
guid The guid of the app for which summary is requested
name The name of the app.
memory The amount of memory each instance should have. In megabytes.
instances The number of instances of the app to run.
disk_quota The maximum amount of disk available to an instance of an app. In megabytes.
space_guid The guid of the associated space.
stack_guid The guid of the associated stack. Uses the default system stack.
state The current state of the app. One of STOPPED or STARTED. STOPPED
command The command to start an app after it is staged (e.g. 'rails s -p $PORT' or 'java com.org.Server $PORT').
buildpack Buildpack to build the app. 3 options: a) Blank means autodetection; b) A Git Url pointing to a buildpack; c) Name of an installed buildpack.
health_check_timeout Timeout for health checking of an staged app when starting up
environment_json Key/value pairs of all the environment variables to run in your app. Does not include any system or service variables.
detected_buildpack The autodetected buildpack that staged the app.
detected_buildpack_guid The guid of the autodetected admin buildpack that staged the app.
production Deprecated. true
  • true
  • false
console Open the console port for the app (at $CONSOLE_PORT). false
  • true
  • false
debug Open the debug port for the app (at $DEBUG_PORT). false
  • true
  • false
package_state The current state of the package. One of PENDING, STAGED or FAILED.
package_updated_at Time when the package was last updated
system_env_json environment_json for system variables, contains vcap_services by default, a hash containing key/value pairs of the names and information of the services associated with your app.
staging_task_id Staging task id
running_instances The number of instances of the app that are currently running.
available_domain List of available domains configured for the app
routes List of routes configured for the app
version Version guid of the app
services List of services that are bound to the app


Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE2IiwiZW1haWwiOiJlbWFpbC0xNkBzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDY2MDA4ODgyfQ.CUw8MYYD6_ZqXlBMn35feU7u_nWDby1svEUI4PvtLcM
Host: example.org


curl "https://api.[your-domain.com]/v2/apps/cd897c8c-3171-456d-b5d7-3c87feeabbd1/summary" -X GET \
	-H "Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoidWFhLWlkLTE2IiwiZW1haWwiOiJlbWFpbC0xNkBzb21lZG9tYWluLmNvbSIsInNjb3BlIjpbImNsb3VkX2NvbnRyb2xsZXIuYWRtaW4iXSwiYXVkIjpbImNsb3VkX2NvbnRyb2xsZXIiXSwiZXhwIjoxNDY2MDA4ODgyfQ.CUw8MYYD6_ZqXlBMn35feU7u_nWDby1svEUI4PvtLcM" \
	-H "Host: example.org" \
	-H "Cookie: "



200 OK


  "guid": "cd897c8c-3171-456d-b5d7-3c87feeabbd1",
  "name": "name-79",
  "routes": [
      "guid": "2d642293-7448-45c6-a864-937c77b9c09a",
      "host": "host-1",
      "port": null,
      "path": "",
      "domain": {
        "guid": "02e200d3-5b18-497b-aafd-17fc3bece05f",
        "name": "domain-1.example.com"
  "running_instances": 0,
  "services": [
      "guid": "307f8c47-7796-4d90-bd40-6a56764e37b3",
      "name": "name-82",
      "bound_app_count": 1,
      "last_operation": null,
      "dashboard_url": null,
      "service_plan": {
        "guid": "a7229730-4c4a-418c-a449-9d9f1f2fb3c2",
        "name": "name-83",
        "service": {
          "guid": "724a9245-900e-47cb-b924-0a7a98dea977",
          "label": "label-1",
          "provider": null,
          "version": null
  "available_domains": [
      "guid": "02e200d3-5b18-497b-aafd-17fc3bece05f",
      "name": "domain-1.example.com",
      "owning_organization_guid": "58a46adc-2e73-4f9c-b7ba-5e72e875cd18"
      "guid": "f067af33-4141-4e69-bbd5-d7b3e01140fa",
      "name": "customer-app-domain1.com",
      "router_group_guid": null,
      "router_group_type": null
      "guid": "ccdb1696-d3e3-4786-a9c1-11bc64b2090a",
      "name": "customer-app-domain2.com",
      "router_group_guid": null,
      "router_group_type": null
  "production": false,
  "space_guid": "1053174d-eb79-4f16-bf82-9f83a52d6e84",
  "stack_guid": "aff73b55-7767-4928-b0ce-502cca863be0",
  "buildpack": null,
  "detected_buildpack": null,
  "detected_buildpack_guid": null,
  "environment_json": null,
  "memory": 1024,
  "instances": 1,
  "disk_quota": 1024,
  "state": "STOPPED",
  "version": "d457b51a-d7cb-494d-b39e-3171ec75bd60",
  "command": null,
  "console": false,
  "debug": null,
  "staging_task_id": null,
  "package_state": "PENDING",
  "health_check_type": "port",
  "health_check_timeout": null,
  "staging_failed_reason": null,
  "staging_failed_description": null,
  "diego": false,
  "docker_image": null,
  "package_updated_at": "2016-06-08T16:41:22Z",
  "detected_start_command": "",
  "enable_ssh": true,
  "docker_credentials_json": {
    "redacted_message": "[PRIVATE DATA HIDDEN]"
  "ports": null


Content-Type: application/json;charset=utf-8
X-VCAP-Request-ID: 59ca0582-092c-4355-a2ae-d8752f5def54
Content-Length: 1750
X-Content-Type-Options: nosniff