---
title: "Fetch the next screen"
method: GET
path: "/api/display"
tags: ["Device API"]
---

# Fetch the next screen

`GET /api/display`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/display`
- Auth: none declared. Required headers: `Access-Token`

## Headers

- `Access-Token` string, required
- `Battery-Voltage` number
- `Percent-Charged` number
- `Battery-Count` number
- `Battery-Charging` number
- `Battery-Health` number
- `Battery-Current` number
- `Battery-Temp` number
- `Battery-Capacity` number
- `USB-Connected` string
- `WiFi-Band` string
- `Panel-Rev` string
- `FW-Version` string
- `FW-Commit` string
- `RSSI` number
- `Height` string
- `Width` string
- `Special-Function` string
- `BASE64` boolean
- `Sensors` string
- `Image-Cached` string
- `Wake-Time` integer

## Response `200`

Success

- object
  - `status` integer
  - `image_url` string, nullable
  - `filename` string, nullable
  - `refresh_rate` integer
  - `reset_firmware` boolean
  - `update_firmware` boolean
  - `firmware_url` string, nullable
  - `special_function` string
  - `action` string, nullable

---

[API](https://skmtc.dev/trmnl/apis/trmnl-api.md) · [All operations](https://skmtc.dev/trmnl/apis/trmnl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trmnl/apis/trmnl-api/revisions/66179e6d663b?raw)