---
title: "Refresh Pmi"
method: POST
path: "/api/cron/refresh-pmi"
tags: ["cron"]
---

# Refresh Pmi

`POST /api/cron/refresh-pmi`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/cron/refresh-pmi`
- Auth: none declared

Refresh cached PMI property valuations (quarterly staleness — safe to
schedule monthly; no-ops when nothing is stale). Stops cleanly on the
monthly credit cap. Protected by X-Cron-Secret header.

## Headers

- `X-Cron-Secret` string
- `x-cron-secret` string

## Response `200`

Successful Response

- PmiRefreshResponse
  - `status` string, required
  - `uprns_checked` integer, required
  - `refreshed` integer, required
  - `credit_capped` boolean, required
  - `errors` integer, required
  - `verdicts_refreshed` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/earmarkiq/apis/earmark-api.md) · [All operations](https://skmtc.dev/earmarkiq/apis/earmark-api/llms.txt) · [OpenAPI document](https://skmtc.dev/earmarkiq/apis/earmark-api/revisions/4a2c41907105?raw)