---
title: "Label Merchants"
method: POST
path: "/api/cron/label-merchants"
tags: ["cron"]
---

# Label Merchants

`POST /api/cron/label-merchants`

## 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/label-merchants`
- Auth: none declared

Label the merchant keys the sync queued (CLASSIFY_V2), in batches of 50,
under MERCHANT_LABEL_DAILY_CAP_GBP (app/services/classification/
label_job.py). Its own cron entry, outside the sync loop; leased.
Protected by X-Cron-Secret header.

## Headers

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

## Response `200`

Successful Response

- LabelMerchantsResponse
  - `status` string, required
  - `keys_considered` integer
  - `keys_ineligible` integer
  - `keys_sent` integer
  - `keys_labelled` integer
  - `calls` integer
  - `cost_gbp` number
  - `stopped_reason` string, nullable

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