---
title: "List relationships for an entity"
method: GET
path: "/entities/{entityDID}/relationships"
tags: ["Relationships"]
---

# List relationships for an entity

`GET /entities/{entityDID}/relationships`

Retrieves all relationships associated with the specified entity, including ownership proofs for each relationship. Supports optional filtering by 'from', 'to', 'custodian', and 'asset'.

## Path parameters

- `entityDID` string, did, required — Decentralized Identifier (DID)

## Query parameters

- `from` string
- `to` string
- `custodian` string
- `asset` AssetIdentifier[]

## Response `200`

List of relationships retrieved successfully

- RelationshipList
  - `relationships` RelationshipWithProofs[], required
    - `@id` string, required
    - `@type` string
    - `from` string, required
    - `to` string, required
    - `custodian` string, nullable
    - `status` 'UNCONFIRMED' | 'CONFIRMED' | 'PROVEN', required
    - `memoTag` string, nullable
    - `createdTime` string
    - `updatedTime` string
    - `proofId` string
    - `proofs` OwnershipProof[], required
      - union — Ownership Proof, which can be an CryptographicalProof, ScreenshotProof, SelfDeclarationProof or MicroTransferProof
        - object — Attestation and its corresponding signed proof.
          - `type` 'eip-191' | 'eip-712' | 'bip-137', required — Type identifier for CryptographicalProof
          - `proof` string, required — Proof
          - `attestation` string, required — Attestation
          - `address` string — blockchain address
          - `status` string — Status of the proof
        - object — Screenshot Proof
          - `type` 'screenshot', required — Type identifier for ScreenshotProof, should be "screenshot"
          - `url` string, required — URL with the screenshot resource
        - object — Information about the self-declared proof.
          - `type` 'self-declaration', required — Type identifier for SelfDeclarationProof (should be self-declaration)
          - `did` string — customer identifier
          - `address` string — blockchain address
          - `attestation` string, required — The attestation
          - `confirmed` boolean — Whether the proof has been confirmed
          - `status` string — Status of the proof attestation
        - object — Information about the micro-transfer proof.
          - `type` 'microtransfer', required — Type identifier for MicroTransferProof (should be micro-transfer)
          - `did` string — did
          - `address` string — blockchain address being validated
          - `proof` string, required — hash of the micro-transfer proof
          - `chain` string — The chain of the micro-transfer, in CAIP format
          - `destination` string — Destination blockchain address
          - `amountSubunits` string — Amount of the microtransfer
          - `status` string — Status of the proof attestation
        - object — Other Proof
          - `type` string, required

## Other responses

- `400` — Bad Request - The server could not process the request due to a client error.
- `401` — Unauthorized - Authentication information is missing or invalid.
- `403` — Forbidden - The server understood the request but refuses to authorize it.
- `404` — Not Found - The requested resource could not be found.
- `409` — Conflict - The request could not be completed due to a conflict with the current state of the resource.
- `500` — Internal Server Error - An unexpected condition was encountered on the server.

---

[API](https://skmtc.net/notabene/apis/notabene-api.md) · [All operations](https://skmtc.net/notabene/apis/notabene-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notabene/notabene-api/versions/70056745a433/schema)