Skip to main content
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. 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.