---
title: "Read the result of a refresh"
method: GET
path: "/api/plugin_settings/{plugin_setting_id}/refreshes/{id}"
tags: ["Plugin Settings - Refresh"]
---

# Read the result of a refresh

`GET /api/plugin_settings/{plugin_setting_id}/refreshes/{id}`

## Request

- Base URL: `https://trmnl.com`
- URL: `https://trmnl.com/api/plugin_settings/{plugin_setting_id}/refreshes/{id}`
- Auth: HTTP bearer

## Path parameters

- `plugin_setting_id` string, required
- `id` string, required

## Response `200`

Returns the freshly fetched variables

- object
  - `data` object
    - `job_id` string
    - `status` 'complete'
    - `success` boolean
    - `variables` unknown
    - `schema` unknown
    - `polling_url` string, nullable
    - `warning` string: Present when the data is stale after a transform failure
    - `logs` unknown[]
      - unknown

## Other responses

- `202`: Refresh has not finished yet
- `401`: Unauthorized
- `404`: UUID belonging to another user
- `410`: Result aged out, or the job id was never issued

---

[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)
