# 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

## Security:

  - `httpAuth` (unknown)
    http bearer

## Path parameters:

  - `domainId` (string, required)

  - `provider` (string, required)

## 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:

  - `200` (unknown)
    Relationships retrieved successfully

## 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:

  - `400` (unknown)
    Bad Request

## Response 400 fields (*/*):

  - `reason` (string, required)

  - `message` (string)

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (*/*):

  - `reason` (string, required)

  - `message` (string)

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (*/*):

  - `reason` (string, required)

  - `message` (string)

## Response 404:

  - `404` (unknown)
    Domain not found

## Response 404 fields (*/*):

  - `reason` (string, required)

  - `message` (string)

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (*/*):

  - `reason` (string, required)

  - `message` (string)