# List all relationships registered with the travel rule provider

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

Endpoint: GET /v1/domains/{domainId}/compliance/travel-rule/providers/{provider}/relationships
Security: httpAuth

## Path parameters:

  - `domainId` (string, required)

  - `provider` (string, required)
    Enum: "NOTABENE"

## Query parameters:

  - `from` (string)
    Filter by 'from' DID (Decentralized Identifier)

  - `to` (string)
    Filter by 'to' DID (Decentralized Identifier)

  - `custodian` (string)
    Filter by custodian DID (Decentralized Identifier)

## Response 200 fields (application/json):

  - `relationships` (array)
    Array of relationship objects with ownership proofs

  - `relationships.@id` (string, required)
    Unique identifier for the relationship
    Example: "urn:uuid:12345678-1234-1234-1234-123456789abc"

  - `relationships.from` (string, required)
    Decentralized Identifier (DID) of the source entity
    Example: "did:web:ripple.com:test:us"

  - `relationships.to` (string, required)
    Decentralized Identifier (DID) of the target entity
    Example: "did:web:example.com:test:counterparty"

  - `relationships.custodian` (string)
    Decentralized Identifier (DID) of the custodian entity (optional)
    Example: "did:web:custodian.com:test:vault"

  - `relationships.status` (string, required)
    Current state of the relationship
    Enum: "UNCONFIRMED", "CONFIRMED", "REJECTED"

  - `relationships.confirmedBy` (string)
    Decentralized Identifier (DID) of the entity that confirmed the relationship
    Example: "did:web:example.com:test:counterparty"

  - `relationships.proofs` (array)
    Ownership proofs associated with this relationship

  - `relationships.proofs.address` (string, required)
    The blockchain address being proven
    Example: "0x1234567890abcdef1234567890abcdef12345678"

  - `relationships.proofs.chain` (string)
    The blockchain network
    Example: "ethereum"

  - `relationships.proofs.status` (string, required)
    Status of the ownership proof
    Enum: "PENDING", "CONFIRMED", "VERIFIED", "REJECTED"

  - `relationships.proofs.signature` (string)
    Cryptographic signature proving ownership
    Example: "0xabcdef..."

  - `relationships.proofs.message` (string)
    The message that was signed
    Example: "I own this address"

  - `relationships.proofs.timestamp` (string)
    When the proof was created
    Example: "2026-03-10T14:30:00.0000000+00:00"

## Response 400 fields (*/*):

  - `reason` (string, required)

  - `message` (string)