---
title: "Read an application refresh batch"
method: GET
path: "/v1/applications/refresh-batches/{batchId}"
tags: ["Applications"]
---

# Read an application refresh batch

`GET /v1/applications/refresh-batches/{batchId}`

## Request

- Base URL: `https://api.planwire.io`
- URL: `https://api.planwire.io/v1/applications/refresh-batches/{batchId}`
- Auth: API key in header `X-API-Key`

Returns customer-isolated progress plus paged per-reference outcomes. completed_with_errors means every item reached a terminal state but one or more failed, were unsupported, or were not found.

## Path parameters

- `batchId` string, uuid, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Batch progress and per-reference results.

## Other responses

- `400`: Invalid batch UUID.
- `401`: Missing or invalid API key.
- `402`: Paid plan required.
- `404`: Batch not found for this API key.

---

[API](https://skmtc.dev/planwire/apis/planwire-uk-planning-data-infrastructure-api.md) · [All operations](https://skmtc.dev/planwire/apis/planwire-uk-planning-data-infrastructure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/planwire/apis/planwire-uk-planning-data-infrastructure-api/revisions/4ccb7f811da9?raw)
