---
title: Get host memory used for an application
source: https://docs.newrelic.com/docs/apis/rest-api-v2/application-examples-v2/get-host-memory-used-application
---

You can use the New Relic REST API (v2) to obtain the average memory usage for your application on a single host. This value appears on the [APM **Summary** page](https://docs.newrelic.com/docs/apm/applications-menu/monitoring/apm-overview-page) in the **Hosts** table, in the column labeled **Memory**, or in the corresponding chart.

> #### ⚠️ IMPORTANT
>
> While the examples utilize New Relic's REST API v2, we recommend using [NRQL functions](https://docs.newrelic.com/docs/nrql/get-started/introduction-nrql-new-relics-query-language/) for executing metric timeslice queries. Each API value can be mapped to an equivalent NRQL function. To learn how to create NRQL queries based on these API examples, refer to our [documentation](https://docs.newrelic.com/docs/apis/rest-api-v2/migrate-to-nrql/).

## Get memory usage for a host

To obtain the average Memory usage for one of your app's hosts, use the following command to obtain the metric `names[]=Memory/Physical` with `values[]=percent`.

```bash
curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/hosts/$HOST_ID/metrics/data.json" \
     -H "Api-Key:$API_KEY" -i \
     -d 'names[]=Memory/Physical&values[]=used_mb_by_host&summarize=true'
```

-   Replace `$APP_ID` and `$API_KEY` with your [app ID](https://docs.newrelic.com/docs/apm/apis/requirements/identification-code) and your [API key](https://docs.newrelic.com/docs/apis/rest-api-v2/getting-started/introduction-new-relic-rest-api-v2#api_key).
-   Replace `$HOST_ID` with the [host id](https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/listing-host-instance-application-server-ids#locating_host_id) of your target host.

This example shows the time range for the [default time period](https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/specifying-time-range-v2) (last 30 minutes). For additional detail:

-   Remove the `summarize=true` to obtain detailed [time series data.](https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/calculating-average-metric-values-summarize)
-   Specify a different [time range](https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/specifying-time-range-v2).

To obtain the same information from the [New Relic API Explorer (v2)](https://api.newrelic.com/docs):

1.  Select [**Application Hosts > GET Metric Data**](https://api.newrelic.com/docs/#/Applications/get_applications__application_id__hosts__host_id__metrics_data_json), and include your [API key](https://docs.newrelic.com/docs/apis/rest-api-v2/getting-started/introduction-new-relic-rest-api-v2#api_key).
2.  Add your [application ID](https://docs.newrelic.com/docs/apm/apis/requirements/identification-code), [host id](https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/listing-host-instance-application-server-ids#locating_host_id), and the `names[]=Memory/Physical` and `values[]=used_mb_by_host` metrics in the appropriate fields.

## Get memory usage for the entire app [#api-call]

To obtain the average Memory usage for your application, use a command similar to the one in the previous example, but remove the reference to **hosts** and `$HOST_ID`. Replace `$APP_ID` and `$API_KEY` with your [app ID](https://docs.newrelic.com/docs/apm/apis/requirements/identification-code) and your [API key](https://docs.newrelic.com/docs/apis/rest-api-v2/getting-started/introduction-new-relic-rest-api-v2#api_key).

```bash
curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.json" \
     -H "Api-Key:$API_KEY" -i \
     -d 'names[]=Memory/Physical&values[]=total_used_mb&summarize=true'
```

For additional detail:

-   Remove the `summarize=true` to obtain detailed [time series data.](https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/calculating-average-metric-values-summarize)
-   Specify a different [time range](https://docs.newrelic.com/docs/apis/rest-api-v2/requirements/specifying-time-range-v2).

To obtain the same information from the [New Relic API Explorer (v2)](https://api.newrelic.com/docs):

1.  Select [**Applications > GET Metric Data**](https://api.newrelic.com/docs/#/Applications/get_applications__application_id__metrics_data_json), and include your [API key](https://docs.newrelic.com/docs/apis/rest-api-v2/getting-started/introduction-new-relic-rest-api-v2#api_key).
2.  Add your [application ID](https://docs.newrelic.com/docs/apm/apis/requirements/identification-code) and the `names[]=Memory/Physical` and `values[]=total_used_mb` metrics in the appropriate fields.