# PayRun.paid

URL: /business/events/PayRun.paid · Id: `event:PayRun.paid`

> Emitted each time a Pay Run is paid.

[PayRun.pay](/business/nouns/pay-run/pay) emits `PayRun.paid` when it completes on a [Pay Run](/business/nouns/pay-run).

| Property | Value |
| --- | --- |
| Emitted by | [PayRun.pay](/business/nouns/pay-run/pay) |
| Noun | [Pay Run](/business/nouns/pay-run) |
| Moves | [Pay Run](/business/nouns/pay-run) `approved` to `paid` |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [PayRun.pay](/business/nouns/pay-run/pay) returns, and `previous` holds the state it left.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `PayRun.paid`. |
| `at` | `datetime` | Yes | When it happened. |
| `seq` | `integer` | No | Its position in the namespace, one more than the Event before; any seq is a cursor into the history. |
| `data` | `json` | Yes | The Thing as the Action left it. |
| `data.payRun` | [Pay Run](/business/nouns/pay-run) | Yes | The paid Pay Run. |
| `data.payRun.company` | [Company](/business/nouns/company) | Yes | The employer of record for everyone it pays. |
| `data.payRun.periodStart` | `date` | Yes | The first day of the pay period. |
| `data.payRun.periodEnd` | `date` | Yes | The last day of the pay period. |
| `data.payRun.payDate` | `date` | Yes | The day net pay reaches each employee’s bank. |
| `data.payRun.kind` | `string` | Yes | A `regular` run on the pay schedule, or an `offCycle` run for a bonus, a correction or final pay. |
| `data.payRun.humans` | list of [Human](/business/nouns/human) | No | The employees it pays. |
| `data.payRun.gross` | `money` | No | Pay before withholding and deductions, for everyone in the run. |
| `data.payRun.withheld` | `money` | No | Income and payroll taxes withheld from employees’ pay. |
| `data.payRun.deductions` | `money` | No | Benefit and retirement deductions the employees elected. |
| `data.payRun.employerTax` | `money` | No | Payroll taxes the Company owes on top of gross pay. |
| `data.payRun.net` | `money` | No | What reaches the employees’ banks: gross less withholding and deductions. |
| `data.payRun.status` | `string` | Yes | Where the Pay Run stands; only an `approved` run is paid. |
| `data.transaction` | [Transaction](/business/nouns/transaction) | Yes | The funding Transaction. |
| `data.previous.status` | `string` | Yes | The `status` before this Event: `approved`. |

### Example
```json
{
  "$id": "https://api.sb/kilnbakery.com/events/event_1",
  "$type": "Event",
  "name": "PayRun.paid",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "payRun": {
      "$id": "https://api.sb/kilnbakery.com/pay-runs/pay_run_1",
      "$type": "PayRun",
      "company": "company_1",
      "periodStart": "2026-10-22",
      "periodEnd": "2026-10-22",
      "payDate": "2026-10-22",
      "kind": "regular",
      "humans": [
        "human_1"
      ],
      "gross": {
        "amount": 9,
        "currency": "USD"
      },
      "withheld": {
        "amount": 9,
        "currency": "USD"
      },
      "deductions": {
        "amount": 9,
        "currency": "USD"
      },
      "employerTax": {
        "amount": 9,
        "currency": "USD"
      },
      "net": {
        "amount": 9,
        "currency": "USD"
      },
      "status": "paid"
    },
    "transaction": {
      "$id": "https://api.sb/kilnbakery.com/transactions/transaction_1",
      "$type": "Transaction",
      "kind": "charge",
      "amount": {
        "amount": 9,
        "currency": "USD"
      }
    },
    "previous": {
      "status": "approved"
    }
  },
  "seq": 1
}
```