> ## 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. # 获取 VASP 目录条目 API：Travel Rule 路由 > 通过 ID 读取 Didit Travel Rule 目录或 Didit 网络中的单个 VASP，并查看您的应用可用的路由。 获取 VASP 目录条目 API 提示词 将提示词复制到剪贴板 
  \`Read one VASP of the Travel Rule directory by the id GET /v3/travel-rule/vasps/ returned.

  Endpoint:
  GET [https://verification.didit.me/v3/travel-rule/vasps/\{vasp\_id}/](https://verification.didit.me/v3/travel-rule/vasps/\{vasp_id}/)

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

  The response is the same object as one row of the search: kind, name, lei, jurisdiction, domains, reachable, aliases, networks, routes, umbrella, entities, contacts and the due-diligence fields. Read routes\[] for what my application can use today: an unavailable network route carries its reason (no\_membership or network\_switched\_off). On a sandbox application every route is unavailable with reason sandbox\_application, because sandbox sends only to the Didit Test VASP.

  Due diligence on the same id:

  * dd\_score (0-100, higher is safer), risk\_level, dd\_score\_breakdown, responsiveness and essential\_checks - the shared assessment. Didit network members are not scored.
  * decision, entity\_screening, questionnaires - my application's own records, private to it. Manage them with GET/PUT/DELETE /v3/travel-rule/vasps/{vasp_id}/decision/, GET/POST /v3/travel-rule/vasps/{vasp_id}/screening/ and GET/POST /v3/travel-rule/vasps/{vasp_id}/questionnaires/.
  * My Travel Rule transfers with this VASP: GET /v3/travel-rule/transfers/?counterparty={vasp_id}.

  Failure modes:

  * 404 - no directory entry or listed Didit network member has this id.

  Full guide: /transaction-monitoring/travel-rule#directory.\`
粘贴到 ## OpenAPI ````yaml zh/openapi-25.json GET /v3/travel-rule/vasps/{vasp_id}/ 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/vasps/{vasp_id}/: get: tags: - Travel Rule summary: 获取 VASP 名录条目 description: 根据搜索返回的 ID 查询到的一个名录条目或 Didit 网络成员，包含相同字段以及您的应用访问该条目的可用路由。 operationId: getTravelRuleVasp parameters: - name: vasp_id in: path required: true schema: type: string format: uuid description: GET /v3/travel-rule/vasps/ 中某一行记录的 id。 responses: '200': description: 条目。 content: application/json: schema: $ref: '#/components/schemas/VaspDirectoryEntry' '404': description: 没有具有此 id 的条目或已列出的 Didit 网络成员。 content: application/json: schema: type: object properties: detail: type: string example: detail: No directory entry has this id. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET https://verification.didit.me/v3/travel-rule/vasps/{vasp_id}/ \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.travel_rule.retrieve_vasp( "11111111-2222-3333-4444-555555555555", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.travelRule.retrieveVasp("11111111-2222-3333-4444-555555555555"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.TravelRule.RetrieveVASP(ctx, \"11111111-2222-3333-4444-555555555555\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.travelRule().retrieveVasp("11111111-2222-3333-4444-555555555555"); System.out.println(result); - lang: php label: PHP source: >- travelRule->retrieveVasp('11111111-2222-3333-4444-555555555555'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.travel_rule.retrieve_vasp("11111111-2222-3333-4444-555555555555") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.TravelRule.RetrieveVaspAsync("11111111-2222-3333-4444-555555555555"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: VaspDirectoryEntry: type: object description: >- 名录中的 VASP 或 Didit 网络的成员，包含您的应用与其建立的路由。仅当客户的应用处于生产环境、启用了 Travel Rule、其资料可被发现、拥有法定名称及已确认的合规邮箱，且 Didit 未将该应用标记为测试、演示或内部应用时，该客户才是 Didit 网络的成员。每一行还包含共享的尽职调查评估（dd_score、risk_level、responsiveness、essential_checks）以及您应用自身的决策、主体筛查和问卷，其他任何客户都无法查看这些内容。 properties: id: type: string format: uuid description: 条目 ID，用于 GET /v3/travel-rule/vasps/{vasp_id}/。 kind: type: string enum: - directory - didit description: directory 表示共享目录条目；didit 表示 Didit 网络成员。 name: type: string lei: type: string jurisdiction: type: string description: 数据源所提供的 ISO 3166 国家/地区代码。 domains: type: array items: type: string description: VASP 的 Web 域名。对于 Didit 网络成员始终为空。 reachable: type: boolean description: >- 您的应用是否有通往该 VASP 或其某个品牌实体的可用路由。对于 Didit 网络成员始终为 true，但在沙盒应用中除外（沙盒应用中每行均为 false）。 aliases: type: array items: type: object properties: name: type: string kind: type: string enum: - trading_name - other_legal_name - network_name - attribution - merged - staff description: >- trading_name、other_legal_name（来自全球 LEI 登记簿）、network_name（Travel Rule 网络上的名称）、attribution（区块链分析机构为该 VASP 钱包标注的实体名称）、merged（合并到此项的重复条目的名称）或 staff。 description: 用于查找该 VASP 的其他名称。 networks: type: array items: type: object description: >- 该 VASP 在 Travel Rule 网络成员名录中的当前条目。TRISA 条目说明了该 VASP 在 TRISA 上的身份；Didit 没有 TRISA 渠道，因此它绝不是一个路由。 properties: network: type: string enum: - GTR - TRUST - VERIFYVASP - SYGNA - TRISA code: type: string description: 该 VASP 在该网络上的标识符。 listed_name: type: string description: 网络列出该 VASP 所使用的名称。 country: type: string description: 网络列出的国家/地区（若有提供）。 verified_at: type: string format: date-time nullable: true description: Didit 工作人员验证该条目的时间。对于从公共目录读取的条目，该值为 null。 last_seen_at: type: string format: date-time nullable: true description: 数据源最后一次显示该收录信息的时间。数据源连续三周未显示的收录信息将被移除。 source: type: string enum: - trisa_directory - staff description: 词条的来源：公开的 TRISA 目录，或 Didit 工作人员。 routes: type: array items: type: object description: >- 您的应用向该 VASP 传递 Travel Rule 数据的一种方式，按调度尝试的顺序排列。网络路由需要该网络上的成员资格：您自己的（在 Marketplace 中连接）或 Didit 拥有的（一旦 Didit 拥有）。如果没有它，该路由将被列为不可用并附带原因，绝不会作为联系该 VASP 的方式。 properties: rail: type: string enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL status: type: string enum: - available - unavailable reason: type: string enum: - '' - no_membership - network_switched_off - sandbox_application description: >- 不可用路由无法使用的原因：no_membership（您和 Didit 均未加入该网络）、network_switched_off（您在设置中关闭了该网络）或 sandbox_application（沙盒应用仅发送至 Didit Test VASP，因此没有可用的路由）。路由可用时为空。 via: type: string enum: - '' - own_membership - didit_membership - directory - contact - didit_network description: >- 可用路由的达成方式：网络轨道的 own_membership 或 didit_membership，经目录验证的 TRP endpoint 的 directory，EMAIL 轨道的 contact，Didit 网络成员的 didit_network。当路由不可用时为空。 umbrella: type: object nullable: true description: 该条目所属受监管实体的品牌。不属于任何受监管实体时为 null。 properties: id: type: string format: uuid name: type: string entities: type: array items: type: object description: 品牌的受监管实体：接收转账的法定实体。 properties: id: type: string format: uuid name: type: string lei: type: string jurisdiction: type: string reachable: type: boolean description: 您的应用是否有通往该目标的可用路由。 description: >- 对于品牌，指接收其转账的受监管实体。指定该品牌的转账会路由至其声明管辖区内可达的实体（beneficiary_data.counterparty_vasp_jurisdiction），否则路由至与目标钱包关联的、由区块链分析归因确定的实体，未声明管辖区时则路由至唯一可达的实体。若两个实体匹配度相同，系统绝不会进行主观推测。 contacts: type: array items: type: object description: EMAIL 渠道可以写入的合规联系人。 properties: id: type: string format: uuid email: type: string format: email name: type: string source: type: string enum: - staff - application - learned description: >- staff：由 Didit 维护；application：由您的应用添加；learned：通过其响应链接回复了 Travel Rule 请求的地址。 scope: type: string enum: - platform - application description: 平台联系人用于所有 Didit 客户的转账；应用联系人仅对您的应用私有，应用只能查看自己的联系人。 verified_at: type: string format: date-time nullable: true description: 该地址的人员回复请求的时间。尚未回复时为 Null。 description: 平台针对该 VASP 的联系方式以及您应用自身的联系方式。 dd_status: type: string enum: - NOT_STARTED - IN_PROGRESS - COMPLETED - REJECTED description: 该条目的 Didit 验证状态，由 dd_score 的验证组件进行评分。对于 Didit 网络成员，始终为 COMPLETED。 dd_score: type: integer nullable: true minimum: 0 maximum: 100 description: >- 名录条目的共享尽职调查评分，范围为 0 到 100，分数越高越安全（参见 dd_score_semantic）：即 dd_score_breakdown 中各项分数的总和。Didit 网络成员不进行评分，该值为 null。尚未评估的条目（dd_assessed_at 为 null）显示为 0 且 risk_level 为空，因此请读取 risk_level 而不是原始分数。 reachable_rails: type: array items: type: string enum: - INTERNAL - TRP - GTR - TRUST - VERIFYVASP - SYGNA - EMAIL description: 条目上记录的 Rails。请读取路由以了解您的应用当前可以使用的内容。 is_didit_customer: type: boolean description: >- 对于 Didit 网络的成员（其 dd_status 始终为 COMPLETED，dd_score 为 null 且 risk_level 为空）以及与 Didit 客户关联的目录条目，该值为 true。 dd_score_breakdown: type: object description: >- dd_score 的每个组成部分对应一个对象。组成部分、其权重（最大值）及其原因代码：jurisdiction, 25 (jurisdiction_not_high_risk, jurisdiction_high_risk, jurisdiction_unknown)；verification, 15 (dd_status_completed, dd_status_in_progress, dd_status_not_started, dd_status_rejected)；protocol, 15 (native_rail, email_only, no_rail)；lei, 10 (lei_valid, lei_missing)；history, 10 (history, no_history)；essentials, 15 (essential_checks, no_essential_checks)；responsiveness, 10 (responsive, unresponsive, responsiveness_unknown)。对于 Didit 网络成员，该字段为空。 additionalProperties: type: object properties: points: type: number description: 该组件贡献的点数，保留一位小数。 max: type: integer description: 组件的权重：其最多能贡献的分数。 reason: type: string description: 组件判定结果的机器可读代码。 detail: type: string description: 单行英文说明。 dd_assessed_at: type: string format: date-time nullable: true description: >- 上次计算 dd_score、risk_level 和 responsiveness 的时间：在与该条目的交互完成、结束、过期、不匹配或被拒绝后，在 Didit 刷新或整理该条目时，以及在每周目录刷新时。对于 Didit 网络成员为 Null。 dd_score_semantic: type: string enum: - higher_is_safer description: dd_score 的取向：始终为 higher_is_safer。 risk_level: type: string enum: - LOW - MEDIUM - HIGH - '' description: >- dd_score 所在的区间：LOW（70 或以上）、MEDIUM（40 至 69）或 HIGH（低于 40）。对于 Didit 网络成员以及尚未评估的条目为空。可使用 risk 对其进行过滤。您自己标记的筛查绝不会更改此共享值：而是在您的规则中将 counterparty_risk_level 置为 HIGH。 responsiveness: type: object description: >- 该 VASP 是否响应 Travel Rule 请求：过去 90 天内 Didit 客户向其发起的请求中得到响应的比例。仅计入通过网络或协议轨道发送的请求，或通过电子邮件发送至共享地址（词条的合规邮箱或平台联系人）的请求；发送至客户手动输入的地址或客户私人联系人的请求一律不计入。过期的请求视为未响应；完成的交换、拒绝或数据不匹配均视为已响应；取消的请求或无法连通的轨道两者皆非。对于 Didit 网络成员，始终为 UNKNOWN 且计数为零。 properties: status: type: string enum: - RESPONSIVE - UNRESPONSIVE - UNKNOWN description: >- 在时间窗口内已决策请求少于 5 个时为 UNKNOWN；其中得到应答的请求少于百分之十时为 UNRESPONSIVE；否则为 RESPONSIVE。 answered: type: integer description: 窗口期内 VASP 已回复的已决策请求。 total: type: integer description: 窗口期内的已决策请求：已回复加上已过期。 computed_at: type: string format: date-time nullable: true essential_checks: type: object description: >- 目录条目的基本核验报告，仅根据平台验证的来源生成：注册（官方登记簿列出了该 VASP：欧盟临时 MiCA 登记簿、公共 TRISA 目录或全球 LEI 登记簿）、许可证（MiCA 授权已有记录且当前有效）、域名（条目的域名与其 TRP endpoint 或其登记簿提供的网站相匹配）和 LEI（其 LEI 记录处于活跃状态、已签发且与条目的名称和国家/地区一致）。dd_score 的基本核验部分是通过的已判定检查项所占的比例。在每周目录刷新首次检查该条目之前为空，并且对于 Didit 网络成员始终为空。 properties: level: type: string enum: - essential checked_at: type: string format: date-time checks: type: array items: type: object properties: id: type: string enum: - registration - licence - domain - lei status: type: string enum: - pass - fail - unknown description: 当记录中没有任何来源可以对该检查作出判定时为 unknown。 reason: type: string description: 判定结果的机器可读代码。 detail: type: string description: 单行英文说明。 passed: type: integer failed: type: integer unknown: type: integer total: type: integer decision: allOf: - $ref: '#/components/schemas/TravelRuleCounterpartyDecision' nullable: true description: >- 您的应用针对该 VASP 的决策，或者对于未单独设置决策的实体而言为其品牌的决策（inherited_from 会指明品牌名称）。无决策时为 null。仅对您的应用私有。 entity_screening: allOf: - $ref: '#/components/schemas/TravelRuleCounterpartyScreening' nullable: true description: 您的应用针对该 VASP 最新的制裁与负面新闻筛查记录。若您从未筛查过该 VASP 则为 null。仅对您的应用私有。 questionnaires: type: array items: $ref: '#/components/schemas/TravelRuleCounterpartyQuestionnaire' description: 您的应用与该 VASP 之间的尽职调查问卷，按最新优先排序。仅对您的应用私有。 example: id: 0d6f3c2a-6a1e-4c55-9a39-1f2b0c7d8e91 kind: directory name: Example Counterparty VASP lei: 529900EXAMPLECPTY001 jurisdiction: DE domains: - counterparty.example reachable: true aliases: - name: Example Counterparty kind: trading_name networks: - network: GTR code: EXAMPLE01 listed_name: Example Counterparty VASP country: DE verified_at: '2026-10-12T09:30:00Z' last_seen_at: '2026-10-12T09:30:00Z' source: staff routes: - rail: GTR status: unavailable reason: no_membership via: '' - rail: EMAIL status: available reason: '' via: contact umbrella: null entities: [] contacts: - id: 6c1f9b8e-2d4a-4f7e-8b3c-5a9d0e1f2a3b email: travelrule@counterparty.example name: Travel Rule desk source: staff scope: platform verified_at: null dd_status: NOT_STARTED dd_score: 62 dd_score_breakdown: jurisdiction: points: 25 max: 25 reason: jurisdiction_not_high_risk detail: DEU is not on the high-risk jurisdiction list verification: points: 3.8 max: 15 reason: dd_status_not_started detail: due diligence status NOT_STARTED protocol: points: 6 max: 15 reason: email_only detail: reachable over the email fallback only lei: points: 10 max: 10 reason: lei_valid detail: valid LEI on record history: points: 5 max: 10 reason: no_history detail: no exchange history essentials: points: 7.5 max: 15 reason: no_essential_checks detail: no decided essential check yet responsiveness: points: 5 max: 10 reason: responsiveness_unknown detail: 0 decided recent requests, too few to judge dd_assessed_at: '2026-10-12T09:30:00Z' dd_score_semantic: higher_is_safer risk_level: MEDIUM responsiveness: status: UNKNOWN answered: 0 total: 0 computed_at: '2026-10-12T09:30:00Z' essential_checks: {} reachable_rails: - GTR - EMAIL is_didit_customer: false decision: decision: APPROVED reason: Licensed in DE, questionnaire reviewed decided_by: '' updated_at: '2026-10-14T10:05:00Z' inherited_from: null entity_screening: id: 7a1d2c3b-4e5f-4a6b-8c7d-9e0f1a2b3c4d status: Approved total_hits: 0 score: null screened_at: '2026-10-14T09:58:00Z' fresh: true flagged: false questionnaires: - id: 8b7a6c5d-4e3f-4a2b-9c1d-0e9f8a7b6c5d status: ANSWERED form_version: '1' sent_to: travelrule@counterparty.example sent_at: '2026-09-02T08:00:00Z' expires_at: '2026-10-02T08:00:00Z' answered_at: '2026-09-04T15:20:00Z' valid_until: '2027-09-04T15:20:00Z' current: true answers: legal_name: >- Example Counterparty VASP, incorporated in the example jurisdiction. licensing: >- Crypto-asset service provider authorised under MiCA by its national regulator, licence active. jurisdictions: EU and EEA. We do not serve the United States. aml_program: >- Written AML/CFT policy, annual independent review, last completed in March 2026. compliance_officer: >- Head of Compliance, reachable at compliance@counterparty.example. sanctions_screening: >- Customers at onboarding and daily; counterparties on every transfer. transaction_monitoring: >- Rule-based monitoring with analyst review; suspicious activity reports filed with the FIU. travel_rule: TRP and email; we answer requests within one business day. custody: >- Segregated customer wallets held with a qualified custodian, insured. ownership: >- No shareholder holds 25 percent or more; parent company Example Holding Group. record_keeping: >- Five-year record-keeping for Travel Rule and transaction data, as our regulator requires. data_protection: Encrypted at rest and in transit, stored in the EU. TravelRuleCounterpartyDecision: type: object description: >- 您的应用针对交易对手 VASP 的决策。仅对您的应用私有：绝不会修改共享的目录条目，其他客户也绝不会看到该决策。它仅通过您的交易规则生效（counterparty_dd_status 规则字段以及 travel-rule-counterparty-blocked 和 travel-rule-counterparty-restricted 预设）；绝不会更改转账的路由方式。 properties: decision: type: string enum: - APPROVED - RESTRICTED - BLOCKED description: APPROVED：您的团队已放行该交易对手。RESTRICTED：审核后可继续向其转账。BLOCKED：您的团队已拒绝该交易对手。 reason: type: string maxLength: 255 description: 您提供的自由文本原因，无原因时为空。 decided_by: type: string description: 做出或最后更改该决策的控制台用户。当由 API 密钥做出时为空。 updated_at: type: string format: date-time inherited_from: type: object nullable: true description: 由于您未对该实体本身做出决策，因此该实体遵循其决策的品牌。当决策为交易对手自身的决策时为 null。 properties: id: type: string format: uuid name: type: string TravelRuleCounterpartyScreening: type: object description: 针对交易对手实体进行的一次制裁和负面新闻筛查，为您的应用运行并向您的应用计费。仅对您的应用可见：其他客户绝不可见。 properties: id: type: string format: uuid status: type: string enum: - Approved - In Review - Declined description: 已通过：无需要注意的可能匹配项。审核中或已拒绝：存在可能的制裁或负面新闻匹配项。 total_hits: type: integer description: 筛查返回的可能匹配项数量。 score: type: number nullable: true description: 可能匹配项中的最高风险评分。未匹配到任何内容时为 Null。 screened_at: type: string format: date-time fresh: type: boolean description: 筛查时间是否短于 fresh_days（30 天）。处于有效期内的筛查会被复用，而不会再次计费。 flagged: type: boolean description: >- 当筛查是最新的且其状态为 In Review 或 Declined 时为 true。当您最新的筛查被标记且交易对手筛查保持开启时，在您的规则中 counterparty_risk_level 为 HIGH。 TravelRuleCounterpartyQuestionnaire: type: object description: 您的应用向交易对手发送的一份尽职调查问卷：Didit 的标准问卷，通过电子邮件发送至记录在案的合规地址，并附带一次性作答链接。仅对您的应用可见。 properties: id: type: string format: uuid status: type: string enum: - SENT - ANSWERED - EXPIRED description: >- SENT：等待回答。ANSWERED：交易对手已回答所有问题。EXPIRED：回答链接在未回答的情况下已关闭（已过截止时间，或被较新的问卷替代），或者回答已超过 valid_until。 form_version: type: string description: 答案所属的 Didit 标准问卷版本。目前为 1。 sent_to: type: string format: email sent_at: type: string format: date-time nullable: true expires_at: type: string format: date-time nullable: true description: 答复截止时间，为发送后 30 天。逾期后链接将失效。 answered_at: type: string format: date-time nullable: true valid_until: type: string format: date-time nullable: true description: 回答保持有效的时间：回答后 365 天。在回答之前为 null。 current: type: boolean description: 当问卷处于 ANSWERED 状态且 valid_until 尚未过期时为 true。 answers: type: object additionalProperties: type: string description: >- 按问题 ID 索引的答案：legal_name、licensing、jurisdictions、aml_program、compliance_officer、sanctions_screening、transaction_monitoring、travel_rule、custody、ownership、record_keeping、data_protection。每个答案最多 2,000 个字符。作答前为空。 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.