# Register ACH Block

Registers an ACH receiving block on a Pocket. From then on, incoming ACH entries in the block's direction are returned unless one of its filters admits the originator. Blocks can be registered only on Pockets of business customers, in either direction; a request for any other customer is rejected with a `422`. A Pocket has at most one active block per direction.

Endpoint: POST /api/v2/pockets/{pocket_id}/ach-receiving-blocks/
Version: Version: 3a6aa907
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer

## Path parameters:

  - `pocket_id` (string, required)

## Header parameters:

  - `x-jiko-idempotency` (string, required)
    A UUID you generate to identify this request. Reusing a value that was already sent is rejected as a duplicate request.

  - `x-jiko-signature` (string, required)
    Base64-encoded HMAC-SHA256 hash of `x-jiko-idempotency + request pathname + body`, keyed with your shared secret. See [Authentication](/products/partner-api/guides/building/auth) for the full algorithm and a code sample.

## Request fields (application/json):

  - `id` (any)
    An id you choose for the new resource. A retry with the same `id` and body returns the resource it created rather than creating another.

  - `direction` (string, required)
    The direction of incoming entries the block returns.
    Enum: "DEBIT", "CREDIT"

## Response 201:

  - `201` (unknown)
    Successful Response

## Response 201 fields (application/json):

  - `id` (string, required)

  - `pocket_id` (string, required)

  - `direction` (string, required)
    The direction of incoming entries the block returns.
    Enum: "DEBIT", "CREDIT"

  - `registered_by` (string, required)
    `JIKO` when Jiko placed it, otherwise the username of the Partner API user that did.

  - `time_created` (string, required)
    When the block was registered and took effect.

  - `filters` (array, required)
    The originators the block admits.

  - `filters.id` (string, required)

  - `filters.block_id` (string, required)

  - `filters.company_identification` (string, required)
    The originator's Company ID, matched exactly. Up to 10 characters.

  - `filters.label` (any)
    A name for the originator. Set at creation.

  - `filters.max_amount` (any)
    The largest entry admitted, inclusive. Absent admits any amount.

  - `filters.max_amount.value` (integer, required)
    USD values are always in cents.

  - `filters.max_amount.currency` (string, required)

  - `filters.max_amount.formatted` (string)

  - `filters.created_by` (string, required)
    `JIKO` when Jiko placed it, otherwise the username of the Partner API user that did.

  - `filters.time_created` (string, required)

## Response 409:

  - `409` (unknown)
    Conflict

## Response 409 fields (application/json):

  - `type` (string, required)

  - `instance` (string, required)

  - `detail` (string, required)

  - `trace_id` (any)

## Response 422:

  - `422` (unknown)
    Unprocessable Content

## Response 422 fields (application/json):

  - `type` (string, required)

  - `instance` (string, required)

  - `detail` (string, required)

  - `trace_id` (any)

## Response 409 examples:

  - `Active block already exists in that direction` (unknown)

  - `id reused with different parameters` (unknown)

  - `Duplicate request` (unknown)

## Response 422 examples:

  - `Customer is not a business` (unknown)