> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Travel Rule 转账列表 API > 通过 Didit 列出 Travel Rule 转账记录，包括状态、通道、VASP 交易对手名称、钱包地址和备注，可按方向、状态、通道或交易对手筛选。 列出 Travel Rule 转账 API 的提示词 将提示词复制到剪贴板 \

\`List my application's Travel Rule transfers.

Endpoint:
GET https://verification.didit.me/v3/travel-rule/transfers/

Authentication:
Use the x-api-key header with my Didit API key.

Query parameters (all optional; direction, status, rail and kind are case-sensitive and take comma-separated values to select several, while currency, start_date, end_date and counterparty take one value each):
\- direction - INBOUND, OUTBOUND (case-sensitive).
\- status - any transfer status, for example AWAITING_COUNTERPARTY or COUNTERPARTY_VASP_NOT_FOUND.
\- rail - INTERNAL, TRP, GTR, TRUST, VERIFYVASP, SYGNA, EMAIL, TEST_VASP.
\- kind - withdrawal (outbound), message (an inbound transfer a rail created from a counterparty's message: a TRP inquiry, the INTERNAL inbound leg, or a GTR, VerifyVASP or Sygna Bridge message), deposit (any other inbound transfer).
\- currency - the transaction's currency, case-insensitive.
\- start_date, end_date - YYYY-MM-DD, inclusive, on the transfer's creation day in UTC.
\- counterparty - the id of a directory entry or Didit network member from GET /v3/travel-rule/vasps/.
\- limit (default 50), offset.

What to read from each row:
\- id (the transfer), transaction_id, txn_id, txn_date, kind, direction, status, rail, asset, amount, deadline_at, created_at.
\- reason - why a COUNTERPARTY_VASP_NOT_FOUND or COUNTERPARTY_VASP_NOT_REACHABLE transfer is stuck, for example email_undeliverable or directory_match_no_route; empty for any other status.
\- originator_vasp, beneficiary_vasp - VASP names: my own legal name on my side; on the other side the directory entry, the Didit network member, the TRP sender, the Didit Test VASP in sandbox, or the name the transfer declared. Empty when none is known.
\- originator_wallet, beneficiary_wallet, originator_memo, beneficiary_memo, originator_wallet_type, beneficiary_wallet_type (vasp | self_hosted | own).
\- matched_transaction_id - the other side of a deposit matched by hand.
Rows never carry person data. For a transfer's full detail, read the transaction with GET /v3/transactions/{transaction_id}/.

Failure modes:
\- 400 - a filter value is not valid, for example {"direction": ["Unknown value(s): inbound."]}, {"start_date": ["Use the YYYY-MM-DD format."]} or {"counterparty": ["Use a valid id."]}.

Full guide: /transaction-monitoring/travel-rule.`

\
粘贴到 ## OpenAPI ````yaml zh/openapi-25.json GET /v3/travel-rule/transfers/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 身份证件验证 API。使用 x-api-key 请求头进行身份验证。 servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/travel-rule/transfers/: get: tags: - Travel Rule summary: 列出 Travel Rule 转账 description: >- 您的应用的 Travel Rule 转账记录，按最新优先排序，使用 `limit`（默认 50）和 `offset` 进行分页。行记录仅包含 VASP 名称、钱包和备注，绝不包含个人数据。使用逗号分隔的值可选择多个。未知值将返回 400 并指明参数，例如 `{"direction": ["Unknown value(s): inbound."]}`。 operationId: listTravelRuleTransfers parameters: - name: direction in: query required: false schema: type: string description: INBOUND、OUTBOUND 或两者以逗号分隔。区分大小写。 - name: status in: query required: false schema: type: string description: 一个或多个转账状态，以逗号分隔。 - name: rail in: query required: false schema: type: string description: >- INTERNAL、TRP、GTR、TRUST、VERIFYVASP、SYGNA、EMAIL、TEST_VASP 中的一个或多个，以逗号分隔。 - name: kind in: query required: false schema: type: string description: withdrawal、deposit 或 message，以逗号分隔。 - name: currency in: query required: false schema: type: string description: 交易的币种，不区分大小写。 - name: start_date in: query required: false schema: type: string format: date description: 在此日期（UTC）或之后创建的转账，格式为 YYYY-MM-DD。 - name: end_date in: query required: false schema: type: string format: date description: 在此日期（UTC）或之前创建的转账，格式为 YYYY-MM-DD。 - name: counterparty in: query required: false schema: type: string format: uuid description: >- 来自 GET /v3/travel-rule/vasps/ 的名录条目或 Didit 网络成员的 `id`：用于获取您与该交易对手之间的转账。无效的 id 值将返回 400。 - name: limit in: query required: false schema: type: integer minimum: 1 description: 页面大小，默认为 50。 - name: offset in: query required: false schema: type: integer minimum: 0 description: 要跳过的行。 responses: '200': description: 一页转账。 content: application/json: schema: type: object properties: count: type: integer next: type: string nullable: true previous: type: string nullable: true results: type: array items: $ref: '#/components/schemas/TravelRuleTransferRow' example: count: 1 next: null previous: null results: - id: 5b0f6c2e-2a4d-4f0e-9a41-0c3f9a7e1d22 transaction_id: a3c1e8f4-7b62-4d1a-8e0b-2f9d6c4b7a10 txn_id: wd-2026-10-19-0042 txn_date: '2026-10-19T08:41:12Z' kind: withdrawal direction: OUTBOUND status: AWAITING_COUNTERPARTY rail: TRP asset: ETH amount: '1.25' originator_vasp: Origin CASP SL beneficiary_vasp: Example Counterparty VASP originator_wallet: '0x77ccff0cc624a53cd8b8d8703ced826710211ec7' beneficiary_wallet: '0xede2d7e4f5b097e6391ab6bbcf2f47a53f4778cb' originator_memo: '' beneficiary_memo: '' originator_wallet_type: vasp beneficiary_wallet_type: vasp matched_transaction_id: null deadline_at: '2026-10-21T08:41:13Z' created_at: '2026-10-19T08:41:13Z' '400': description: 过滤器值无效。 content: application/json: example: start_date: - Use the YYYY-MM-DD format. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/travel-rule/transfers/?direction=OUTBOUND&status=AWAITING_COUNTERPARTY' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.travel_rule.transfers.list(): print(item) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); for await (const item of didit.travelRule.transfers.list()) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.TravelRule.Transfers.ListAutoPaging(ctx, didit.TravelRuleTransfersListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); for (var item : client.travelRule().transfers().list()) { System.out.println(item); } - lang: php label: PHP source: |- travelRule->transfers->list() as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.travel_rule.transfers.list.auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); await foreach (var item in await client.TravelRule.Transfers.ListAsync()) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: TravelRuleTransferRow: type: object description: 转账列表中显示的一笔 Travel Rule 转账：仅包含 VASP 名称、钱包和备注，绝不包含汇款人或收款人的个人数据。 properties: id: type: string format: uuid description: 转账的 id。 transaction_id: type: string format: uuid description: 此转账所属的 Didit 交易。 txn_id: type: string nullable: true description: 您为该交易指定的自身 ID。Didit 为您登记的转账（例如 Didit Test VASP 入账转账）将带有生成的 ID。 txn_date: type: string format: date-time kind: type: string enum: - withdrawal - deposit - message description: >- withdrawal：出账。message：通道根据交易对手的消息创建的入账转账（TRP 查询、INTERNAL 入账分支，或 GTR、VerifyVASP 或 Sygna Bridge 消息）。deposit：任何其他入账转账。 direction: type: string enum: - INBOUND - OUTBOUND status: type: string enum: - AWAITING_COUNTERPARTY - ON_HOLD - COMPLETED - FINISHED - CANCELLED - EXPIRED - COUNTERPARTY_MISMATCHED_DATA - COUNTERPARTY_VASP_NOT_FOUND - COUNTERPARTY_VASP_NOT_REACHABLE - UNCONFIRMED_OWNERSHIP - COUNTERPARTY_VASP_GENERAL_DECLINE - NOT_ENOUGH_COUNTERPARTY_DATA - NOT_APPLICABLE reason: type: string description: >- `COUNTERPARTY_VASP_NOT_FOUND` 或 `COUNTERPARTY_VASP_NOT_REACHABLE` 转账受阻的原因，取值与转账自身的 `reason` 相同，因此列表无需逐一打开每笔转账即可区分合规邮件退信与无路由的交易对手。任何其他状态下为 `""`。参见[转账受阻的原因](/zh/transaction-monitoring/travel-rule#为什么转账会卡住)。 rail: type: string nullable: true enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL - TEST_VASP - null asset: type: string description: 交易的币种。 amount: type: string description: 普通小数形式的金额，例如 "1.25"。 originator_vasp: type: string description: >- 出向：您 VASP 的法定名称。入向：交易对手的名称，来自其目录条目、Didit 网络成员、TRP 发送方、Didit Test VASP 或转账声明的名称。未知时为空。 beneficiary_vasp: type: string description: 出向：以相同方式计算得出的交易对手名称。入向：您 VASP 的法定名称。 originator_wallet: type: string beneficiary_wallet: type: string originator_memo: type: string description: Memo 或目标标签，在没有该项的链上为空。 beneficiary_memo: type: string originator_wallet_type: type: string enum: - vasp - self_hosted - own description: vasp、self_hosted（声明为非托管）或 own（您的地址簿中记录为属于您的钱包）。您自己的一方始终为 vasp。 beneficiary_wallet_type: type: string enum: - vasp - self_hosted - own matched_transaction_id: type: string format: uuid nullable: true description: 您手动与已声明转账相匹配的充值交易另一方。 deadline_at: type: string format: date-time nullable: true description: >- 如果转账仍在等待其交易对手，该转账过期的时间。针对您使用 `POST /v3/transactions/` 创建且需要进行交换的出账或入账的每一笔转账进行设置。低于阈值、不适用 Travel Rule 的闪电网络支付，以及交易对手联系到您时 Didit 创建的入账转账（入账 TRP 问询、网络消息或 INTERNAL 入账环节）时为 null。 created_at: type: string format: date-time securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 您的应用 API 密钥，可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域：针对每个资源设为无权限、只读或读写，限定于特定工作流或已通过的会话、限定于 IP 地址列表，以及设置到期日期。401 表示密钥错误、已撤销或已过期；403 表示未发送密钥、密钥无权访问该资源或操作，或请求来自其 IP 列表之外的地址；在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null；没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.