---
title: "Manually trigger a settlement run"
method: POST
path: "/v1/settlement/run"
tags: ["Settlement"]
---

# Manually trigger a settlement run

`POST /v1/settlement/run`

Runs the end-of-day settlement for a specified date on demand.
This is idempotent – if the date has already been successfully settled,
the existing record is returned without reprocessing.

**Use cases**:
- Re-running a failed batch (e.g. after a database outage).
- Settling a back-date after delayed transaction processing.
- Smoke-testing the settlement pipeline in staging.

The scheduled job automatically covers yesterday at 23:59 UTC;
this endpoint is for operational override only.

## Query parameters

- `date` string, date

## Response `200`

Settlement run completed (or already completed for this date)

## Other responses

- `400` — Invalid date format
- `500` — Settlement run failed – error details in response

---

[API](https://skmtc.net/reflexpay/apis/idaas-identity-as-a-service-api.md) · [All operations](https://skmtc.net/reflexpay/apis/idaas-identity-as-a-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/reflexpay/idaas-identity-as-a-service-api/revisions/db1f954badfb/schema)