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

# Partner event types

> Event envelope and emitted lifecycle notifications.

Webhook deliveries and `GET /partner/v1/events` use the same event envelope:

```json theme={null}
{
  "id": "<event UUID>",
  "type": "offer.available",
  "partnerId": "<partner UUID>",
  "subject": "offer/<offer UUID>",
  "occurredAt": "2026-11-22T15:00:00.000Z",
  "data": { "obligationId": "<obligation UUID>", "offer": {} }
}
```

`data` varies by type. Consumers should ignore unknown additional fields and handle event IDs idempotently.

| Event | When it is emitted |
| - | - |
| `integration.test` | A test delivery is requested |
| `submission.received` | A new partner submission is stored |
| `submission.approved` | Operator approves intake and creates an obligation |
| `submission.rejected` | Operator rejects intake with a reason |
| `obligation.created` | An approved obligation is created |
| `offer.available` | An offer is published or requoted |
| `offer.accepted` | The business accepts the offer |
| `offer.expired` | An unaccepted offer expires or is replaced by a new quote |
| `offer.withdrawn` | An operator withdraws a live offer |
| `payment.requested` | Acceptance requests an advance from funded capacity |
| `payment.sent` | A reconciled payout is marked sent, or a development simulation marks it sent |
| `payment.received` | A payer repayment is recorded; may be partial |
| `obligation.settled` | Repayment closes the obligation |

Development simulations can include `simulated: true` in event data. An `offer.accepted` or `payment.requested` event is not confirmation that the recipient's bank has received money. See [banking](https://docs.already.finance/money/banking.md).


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