---
title: "Usage graphs · API | Rdp.Vision"
description: "GET /servers/{id}/graphs/{timeframe}: CPU, memory and network over time."
url: https://rdp.vision/docs/api/servers/graphs
---

Open in AI

[ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Fgraphs.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)[Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Frdp.vision%2Fdocs%2Fapi%2Fservers%2Fgraphs.md%20and%20help%20me%20use%20the%20Rdp.Vision%20API.)

Servers

# Usage graphs

CPU, memory and network over time.

GET`/servers/{id}/graphs/{timeframe}`

## Authorization

`Authorization`header required

`Bearer rv_…`, a key with the `read` scope. [About keys](https://rdp.vision/docs/api/authentication)

## Path parameters

`id`string (uuid) required

The server id from List servers.

`timeframe`string required

How far back.

One of `hour``day``week``month`

## Response

`points[].t`integer

Unix time.

`points[].cpu`number

CPU in %.

`points[].mem`number

Memory used, GB.

`points[].mem_total`number

Memory, GB.

`points[].net_in`number

Mbit/s in.

`points[].net_out`number

Mbit/s out.

## Status codes

- 200 | Success.
- 401 | No key, a wrong key, or a revoked or expired one.
- 503 | The data centre didn’t answer in time. Safe to retry.
- 429 | More than 120 requests a minute with one key, or too many wrong keys from one address.

Request

curl "https://rdp.vision/api/v1/servers/3f6c2a8e-91d4-4b7a-a5e2-7c0d9b1f4e36/graphs/day" \\
  -H "Authorization: Bearer $RDPVISION\_KEY"

Response

{
  "points": \[
    {
      "t": 1794436800,
      "cpu": 4.2,
      "mem": 2.1,
      "mem\_total": 6,
      "net\_in": 0.8,
      "net\_out": 0.3
    }
  \]
}