---
title: "List all relationships registered with the travel rule provider"
method: GET
path: "/v1/domains/{domainId}/compliance/travel-rule/providers/{provider}/relationships"
tags: ["Compliance"]
---

# List all relationships registered with the travel rule provider

`GET /v1/domains/{domainId}/compliance/travel-rule/providers/{provider}/relationships`

## Request

- Base URL: `https://docs.ripple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.ripple.com/v1/domains/{domainId}/compliance/travel-rule/providers/{provider}/relationships`
- Auth: HTTP bearer

Pass-through proxy API to list all relationships from the travel rule provider (e.g., Notabene)

## Path parameters

- `domainId` string, uuid, required
- `provider` 'NOTABENE', required

## Query parameters

- `from` string, did
- `to` string, did
- `custodian` string, did

## Response `200`

Relationships retrieved successfully

- ComplianceRelationshipList: List of relationships from the travel rule provider
  - `relationships` ComplianceRelationshipWithProofs[]: Array of relationship objects with ownership proofs
    - `@id` string, required: Unique identifier for the relationship
    - `from` string, did, required: Decentralized Identifier (DID) of the source entity
    - `to` string, did, required: Decentralized Identifier (DID) of the target entity
    - `custodian` string, did: Decentralized Identifier (DID) of the custodian entity (optional)
    - `status` 'UNCONFIRMED' | 'CONFIRMED' | 'REJECTED', required: Current state of the relationship
    - `confirmedBy` string, did: Decentralized Identifier (DID) of the entity that confirmed the relationship
    - `proofs` ComplianceOwnershipProof[]: Ownership proofs associated with this relationship
      - `address` string, required: The blockchain address being proven
      - `chain` string: The blockchain network
      - `status` 'PENDING' | 'CONFIRMED' | 'VERIFIED' | 'REJECTED', required: Status of the ownership proof
      - `signature` string: Cryptographic signature proving ownership
      - `message` string: The message that was signed
      - `timestamp` string, date-time: When the proof was created

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Domain not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ripple/apis/ripple-custody-api.md) - [All operations](https://skmtc.dev/ripple/apis/ripple-custody-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ripple/apis/ripple-custody-api/revisions/c6f0ad6b70c0?raw)