---
title: "On-Ledger Transfer Batch Screen"
method: POST
path: "/v1/tools/screen_onledger_transfer_batch"
tags: ["TODO_TAGS_REVIEW", "TODO_AP2_EXPORT_REVIEW"]
---

# On-Ledger Transfer Batch Screen

`POST /v1/tools/screen_onledger_transfer_batch`

## Request

- Base URL: `https://ainumbers.co`
- URL: `https://ainumbers.co/v1/tools/screen_onledger_transfer_batch`
- Auth: none declared

Batch-level pre-commit sanctions and purpose-code screen for a shared-ledger transfer batch, modeled on the shipped screen_tip20_transfer_batch pattern: per-transfer status, screening-list hits, purpose-code validity, a batch-clean verdict, and coverage gaps. Reuses the same purpose-code enum and screening-hit shape as check_purpose_code_requirement / check_screening_list_coverage rather than duplicating their logic. Zero-network; screens against supplied flagged-name lists only.

**Tool URL:** https://ainumbers.co/chaingraph/art-291-screen-onledger-transfer-batch.html

## Request body

- object
  - `profile` unknown, required
  - `screening_lists_meta` unknown, required
  - `transfers` unknown[], required
    - unknown

## Response `200`

Successful tool execution result

- object
  - `batch_clean` boolean
  - `coverage_gaps` unknown[]
    - unknown
  - `per_transfer` object[]
    - `hits` unknown[]
      - unknown
    - `index` integer
    - `purpose_code_ok` boolean
    - `status` string
  - `profile` string
  - `transfer_count` integer

---

[API](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite.md) · [All operations](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/llms.txt) · [OpenAPI document](https://skmtc.dev/ainumbers/apis/ainumbers-co-fintech-intelligence-suite/revisions/b462e4f5bb28?raw)