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

# Originator Statuses

> Lifecycle of an originator, what each status means, who moves it, and how to observe changes.

Lead and you share control of originator status. A new originator starts in `pending`, and Lead moves it to `active` or `rejected` after review. After it is `active`, you move it between `active` and `inactive` and you cancel it. Lead can suspend an active originator at any time.

## Lifecycle

The diagram shows every status and transition.

```mermaid theme={null}
flowchart LR
    pending --> active
    pending --> rejected
    active <--> inactive
    active --> suspended
    suspended --> active
    active --> canceled
    inactive --> canceled
```

## Statuses

The table lists each status.

| Status | Description | Set by |
| - | - | - |
| `pending` | The originator exists and is awaiting Lead's review. It can't originate. | Lead, on create. |
| `active` | The originator can originate ACH. Account numbers can send under it. | Lead, after review. You, from `inactive`. |
| `inactive` | You paused the originator. It can't originate. Account numbers that name it can't send ACH until it is active again. | You. |
| `rejected` | Lead did not approve the originator. It can't originate. | Lead. |
| `suspended` | Lead suspended the originator. It can't originate. Contact Lead. | Lead. |
| `canceled` | The originator is permanently closed. You can't undo this. | You. |

## Transitions

The table lists which endpoint makes each transition.

| Endpoint | From | To |
| - | - | - |
| `POST /v2/originators/{originator_id}/deactivate` | `active` | `inactive` |
| `POST /v2/originators/{originator_id}/activate` | `inactive` | `active` |
| `POST /v2/originators/{originator_id}/cancel` | `active` or `inactive` | `canceled` |

The three endpoints take no request body but require an `Idempotency-Key`. Calling one on an originator already in the target status returns `200` with the current object. You can't change status with PATCH, and you can't activate a `pending`, `rejected`, `suspended`, or `canceled` originator.

## What a status means for ACH

Only an `active` originator originates. Lead rejects an outgoing entry from an account number whose `ach_controls.originator_id` names an originator in any other status. Entries already submitted to the Fed aren't affected by a later status change. Returns on them still post.

## Observing changes

You can learn about changes these ways:

* **No webhooks.** Status changes on an originator don't emit events.
* **Polling.** `GET /v2/originators/{originator_id}` returns the current status. Poll after create to learn when Lead's review is complete.

## Related

* [The Originator Object](https://docs.lead.bank/v2/products/originators/originator-object.md)
* [Originator Overview](https://docs.lead.bank/v2/products/originators/overview.md)
* [Account Number Statuses](https://docs.lead.bank/v2/products/account-number/statuses.md)
