---
title: "Create accrual run"
method: POST
path: "/api/v1/accrual-runs"
tags: ["Accounting"]
---

# Create accrual run

`POST /api/v1/accrual-runs`

Queues an accrual batch for a business date and returns available journal/outbox reference data.

## Request body

- CreateAccrualRunHumaInputBody
  - `businessDate` string, date, required — Business date (YYYY-MM-DD) the accrual batch is queued for.
  - `loanProductIds` string[], nullable — Optional loan product identifiers to scope the run.
  - `mode` string, required — Accrual run mode (e.g. daily).

## Response `201`

Created

- AccrualRunHumaBody
  - `businessDate` string, required — Business date (YYYY-MM-DD, UTC) the run was queued for.
  - `correlationId` string, required — Correlation identifier linking the run to its journal/outbox lineage and downstream events.
  - `id` string, required — Server-assigned UUID of the queued accrual run.
  - `journalReferenceId` string, required — UUID of the journal reference recording this run's posting lineage.
  - `outboxEventId` string — UUID of the emitted outbox event; omitted when no outbox event was recorded.
  - `status` string, required — Lifecycle status of the queued run (e.g. queued).

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)