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

Statuses

The table lists each status.

Transitions

The table lists which endpoint makes each transition. 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.