# Add ACH Block Filter

Adds a filter to an ACH receiving block. The filter admits one originator by its Company ID, optionally up to `max_amount_usdc`. A filter's cap cannot be changed: remove the filter and add a new one for the same Company ID. Between the two calls, that originator's entries are refused.

Endpoint: POST /api/v2/pockets/{pocket_id}/ach-receiving-blocks/{block_id}/filters/
Version: Version: 22fbfcad
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer

## Path parameters:

  - `pocket_id` (string, required)

  - `block_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.

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

  - `label` (any)
    A name for the originator. Cannot be changed later.

  - `max_amount_usdc` (any)
    The largest entry admitted, in cents, inclusive. Absent admits any amount.

## Response 201:

  - `201` (unknown)
    Successful Response

## Response 201 fields (application/json):

  - `id` (string, required)

  - `block_id` (string, required)

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

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

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

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

  - `max_amount.currency` (string, required)

  - `max_amount.formatted` (string)

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

  - `time_created` (string, required)

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

  - `type` (string, required)

  - `instance` (string, required)

  - `detail` (string, required)

  - `trace_id` (any)

## 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)
    Validation Error

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `detail.input` (any)

  - `detail.ctx` (object)

## Response 404 examples:

  - `Not found, or removed` (unknown)

## Response 409 examples:

  - `Active filter already exists for that Company ID` (unknown)

  - `id reused with different parameters` (unknown)

  - `Duplicate request` (unknown)

