# Host disk usage API call

**URL:** <https://community.dynatrace.com/t/host-disk-usage-api-call/43335>\
**Category:** Dynatrace API\
**Tags:** dynatrace-api\
**Created:** [December 21, 2023, 2:59pm UTC](https://community.dynatrace.com/t/host-disk-usage-api-call/43335 "2023-12-21T14:59:30Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![Itani\_ML](https://avatars.discourse-cdn.com/v4/letter/i/848f3c/32.png) [@Itani\_ML](https://community.dynatrace.com/u/Itani_ML)\
**Post date:** [December 21, 2023, 2:59pm UTC](https://community.dynatrace.com/t/host-disk-usage-api-call/43335/1 "2023-12-21T14:59:30Z")

</div>

Hi, I am trying to use an API request to get a server disk usage percentage. How can I achieve this?

---

<div class="post-metadata">

**Author:** ![AntonPineiro](https://dub1.discourse-cdn.com/dynatrace/user_avatar/community.dynatrace.com/antonpineiro/32/49_2.png) [@AntonPineiro](https://community.dynatrace.com/u/AntonPineiro)\
**Post date:** [December 21, 2023, 3:49pm UTC](https://community.dynatrace.com/t/host-disk-usage-api-call/43335/2 "2023-12-21T15:49:47Z")

</div>

Hi,

You can go to data explorer and select metric you and instered (builtin:host.disk.usedPct in this case) and filter server by name.

After that, press “…” and select “Copy Request”:

 ![AntonPineiro_0-1703173734623.png](https://global.discourse-cdn.com/dynatrace/original/3X/3/5/3505e294e3d4226520b16be4f42b40e65dac7bc7.png)

And you have an example to get that data.

You need to generate a token with correct permissions in advance.

Best regards

---

<div class="post-metadata">

**Author:** ![radek\_jasinski](https://dub1.discourse-cdn.com/dynatrace/user_avatar/community.dynatrace.com/radek_jasinski/32/10432_2.png) [@radek\_jasinski](https://community.dynatrace.com/u/radek_jasinski)\
**Post date:** [December 21, 2023, 9:50pm UTC](https://community.dynatrace.com/t/host-disk-usage-api-call/43335/3 "2023-12-21T21:50:33Z")

</div>

[@Itani\_ML](https://community.dynatrace.com/user/70129)

Of course, I also recommend using API Explorer, which will allow you to easily prepare and check a query to retrieve the metric of your choice.

> **[Dynatrace API](https://docs.dynatrace.com/docs/dynatrace-api)**
>
> Find out what you need to use the Dynatrace API.

You can find the metrics where the [@AntonPineiro](https://community.dynatrace.com/user/58682)&nbsp;pointed out.

Radek

---

<div class="post-metadata">

**Author:** ![Itani\_ML](https://avatars.discourse-cdn.com/v4/letter/i/848f3c/32.png) [@Itani\_ML](https://community.dynatrace.com/u/Itani_ML)\
**Post date:** [December 23, 2023, 1:27pm UTC](https://community.dynatrace.com/t/host-disk-usage-api-call/43335/4 "2023-12-23T13:27:06Z")

</div>

Thanks you, it really worked. One last question, with this request, is it possible to only filter out the value?

Below is my request and I am running it from Bamboo, I only want to get the value of the disk as the output

curl -X GET “https://{environmentid}.live.dynatrace.com/api/v2/metrics/query?metricSelector=(builtin:host.disk.free:filter(and(or(in("dt.entity.host\”,entitySelector(\“type(~\“HOST~\”),entityName.equals(~\“dhdelasticls01.discsrv.co.za~\”)\”))))):splitBy():sort(value(auto,descending))):limit(100):names&from=-2h&to=now" -H “accept: application/json” -H “Authorization: Api-Token XXXX-XXXX”

---

<div class="post-metadata">

**Author:** ![AntonPineiro](https://dub1.discourse-cdn.com/dynatrace/user_avatar/community.dynatrace.com/antonpineiro/32/49_2.png) [@AntonPineiro](https://community.dynatrace.com/u/AntonPineiro)\
**Post date:** [December 24, 2023, 12:14pm UTC](https://community.dynatrace.com/t/host-disk-usage-api-call/43335/5 "2023-12-24T12:14:49Z")

</div>

Hi,

If you change visualization to “Single value”:

 ![AntonPineiro_0-1703419966595.png](https://global.discourse-cdn.com/dynatrace/original/3X/8/a/8a78ff61995951290a9fae2f9d4e61c6da6a6253.png)

Notice “_&resolution=Inf_” is added in the end when you copy request from wizard. For example:

```markup
curl -X GET "https://{environment_id}.live.dynatrace.com/api/v2/metrics/query?metricSelector=(builtin:host.disk.usedPct:filter(and(or(in(\"dt.entity.host\",entitySelector(\"type(host),entityName.equals(~\"XXXX~\")\"))))):splitBy():sort(value(auto,descending))):names&from=-2h&to=now&resolution=Inf" -H "accept: application/json" -H "Authorization: Api-Token XXXX-XXXX"

```

Best regards
