> ## Documentation Index
> Fetch the complete documentation index at: https://docs.already.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit obligations

> Payload, idempotency, evidence, and review semantics.

Use `POST /partner/v1/obligation-submissions` with a partner key that has `obligations:write`. Send one candidate per payment obligation. A required `Idempotency-Key` of 4–200 characters protects retries: resending the same key for the same partner returns the existing submission with `idempotentReplay: true`.

| Field | Required | Meaning |
| - | - | - |
| `externalId` | Yes | Stable reference in your system |
| `externalVersion` | No | Your source version; defaults to `1` |
| `type` | No | Source type; defaults to `invoice` |
| `beneficiary.email` | Yes | Business contact email |
| `beneficiary.name` | No | Display name |
| `payerName` | Yes | Party owing the payment |
| `faceAmount` | Yes | Positive amount in major currency units, such as `2040` for \$2,040 |
| `currency` | No | Defaults to `USD` |
| `issuedAt` | No | `YYYY-MM-DD` |
| `dueAt` | Yes | `YYYY-MM-DD` |
| `evidence.type`, `evidence.reference` | Yes | Evidence category and stable source reference |

The API validates presence and format. Already's operator review determines whether the evidence is sufficient, the payer is acceptable, and funding capacity exists. The API returns HTTP `201` for a new submission, `200` for an idempotent replay, and `422` for an invalid submission. The initial status is `received`.

An operator may approve or reject a submission. Approval creates an obligation and a separate offer. Rejection includes a reason in the submission record and emits `submission.rejected` to the partner. See [event types](https://docs.already.finance/reference/events.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.