# Get Deployment APM Resource Info

**GET /deployments/{deployment_id}/apm/{ref_id}**

Get info about an APM Resource belonging to a given Deployment.


## Servers
- https://api.elastic-cloud.com/api/v1: https://api.elastic-cloud.com/api/v1 ()



## Parameters

### Path parameters
- **deployment_id** (string)
  Identifier for the Deployment
- **ref_id** (string)
  User-specified RefId for the Resource (or '_main' if there is only one).

### Query parameters
- **show_metadata** (boolean)
  Whether to include the full cluster metadata in the response - can be large per cluster and also include credentials.
- **show_plans** (boolean)
  Whether to include the full current and pending plan information in the response - can be large per cluster.
- **show_plan_logs** (boolean)
  Whether to include with the current and pending plan information the attempt log - can be very large per cluster.
- **show_plan_history** (boolean)
  Whether to include with the current and pending plan information the plan history- can be very large per cluster.
- **show_plan_defaults** (boolean)
  If showing plans, whether to show values that are left at their default value (less readable but more informative).
- **show_settings** (boolean)
  Whether to show cluster settings in the response.
- **clear_transient** (boolean)
  If set (defaults to false) then removes the transient section from all child resources, making it safe to reapply via an update


## Responses
### 200
Standard response.

#### Body: application/json (object)
- **ref_id** (string)
  The locally-unique user-specified id of a Resource
- **elasticsearch_cluster_ref_id** (string)
  The Elasticsearch cluster that this resource depends on.
- **id** (string)
  The randomly-generated id of a Resource
- **region** (string)
  The region where this resource exists
- **info** (object)
  The overview information for the APM Server.

### 404
The Deployment specified by {deployment_id} cannot be found. (code: `deployments.deployment_not_found`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request

### 500
We have failed you. (code: `deployments.deployment_resource_no_longer_exists`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request


[Powered by Bump.sh](https://bump.sh)