---
title: "Get Entity"
method: GET
path: "/network/{entityDID}"
tags: ["Network"]
---

# Get Entity

`GET /network/{entityDID}`

Retrieves VASP/Entity information from the Network API by DID. Returns detailed information about the entity including regulatory status, verification status, and protocol support.

## Path parameters

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

## Query parameters

- `fields` string
- `reviewedByVaspDID` string
- `showJurisdictionStatus` string
- `includeSubsidiaries` string
- `networkStatus` union
  - string
  - string[]
- `regulatoryStatus` union
  - string
  - string[]

## Response `200`

Entity retrieved successfully

- object
  - `did` string
  - `name` string, nullable
  - `legalName` string, nullable
  - `otherNames` string[], nullable
  - `subsidiaries` object[]
    - `did` string
    - `name` string, nullable
    - `legalName` string, nullable
    - `otherNames` string[], nullable
    - `subsidiaries` object[]
      - `did` string
      - `name` string, nullable
      - `legalName` string, nullable
      - `otherNames` string[], nullable
      - `subsidiaries` unknown
      - `subsidiaryOf` string, nullable
      - `parentGateway` object, nullable
        - `did` string, required
        - `name` string, required
      - `adminEmails` string, nullable
      - `logo` string, nullable
      - `website` string, nullable
      - `description` string, nullable
      - `legalStructure` string, nullable
      - `yearFounded` union
        - number
        - string
      - `incorporationCountry` string, nullable
      - `identificationType` string, nullable
      - `identificationCountry` string, nullable
      - `businessNumber` string, nullable
      - `leiNumber` string, nullable
      - `otherLegalName` string, nullable
      - `legalForm` string, nullable
      - `addressLine1` string, nullable
      - `addressLine2` string, nullable
      - `city` string, nullable
      - `country` string, nullable
      - `street` string, nullable
      - `number` string, nullable
      - `unit` string, nullable
      - `postCode` string, nullable
      - `state` string, nullable
      - `hqStreet` string, nullable
      - `hqNumber` string, nullable
      - `hqUnit` string, nullable
      - `hqPostcode` string, nullable
      - `hqRegion` string, nullable
      - `hqCity` string, nullable
      - `hqCountry` string, nullable
      - `isRegulated` string, nullable
      - `regulatoryStatus` string, nullable
      - `regulatoryAuthorities` unknown
      - `supervisoryAuthority` string, nullable
      - `registrationLicenseId` string, nullable
      - `statusStartDate` string, nullable
      - `statusExpirationDate` string, nullable
      - `lastChecked` string, nullable
      - `additionalInformation` string, nullable
      - `verificationStatus` string, nullable
      - `entityCategory` string, nullable
      - `entityStatus` string, nullable
      - `hasAdmin` boolean, nullable
      - `isNotifiable` boolean, nullable
      - `isActiveSender` boolean, nullable
      - `isActiveReceiver` boolean, nullable
      - `reviewValue` string, nullable
      - `reviewNote` string, nullable
      - `reviewDate` string, nullable
      - `reviewedBy` string, nullable
      - `jurisdictions` string, nullable
      - `jurisdictionStatus` object, nullable
      - `jurisdictionNotabenePage` string, nullable
      - `travelRule_OPENVASP` string, nullable
      - `travelRule_SYGNA` string, nullable
      - `travelRule_TRISA` string, nullable
      - `travelRule_TRLIGHT` string, nullable
      - `travelRule_EMAIL` string, nullable
      - `travelRule_TRP` string, nullable
      - `travelRule_SHYFT` string, nullable
      - `travelRule_USTRAVELRULEWG` string, nullable
      - `travelRule_TRUST` string, nullable
      - `travelRule_notabene` string, nullable
      - `certificates` string, nullable
      - `emailDomains` string, nullable
      - `documents` string, nullable
      - `division` unknown
      - `issuers` object, nullable
      - `onboardingStatus` string, nullable
      - `compliancePhase` number, nullable
      - `compliancePhaseData` object, nullable
      - `billing_customer_did` string, nullable
      - `subscription_id` string, nullable
      - `untracked_usage_in_period` number, nullable
      - `updatedAt` union
        - string
        - string, date-time
      - `created_at` string, nullable
      - `updated_at` string, nullable
      - `vaspnetId` string, nullable
      - `vaspnetImmutableFields` string[], nullable
      - `protocol` object, nullable
      - `vasp_categories` string, nullable
      - `isNotabeneCustomer` boolean, nullable
      - `testPhoneNumber` string, nullable
      - `autoEnableWhenUserJoins` boolean, nullable
      - `logo_filename` string, nullable
      - `logo_updated_at` string, nullable
      - `chainalysis_name` string, nullable
      - `badges` string[], nullable
      - `isSandbox` boolean, nullable
      - `identificationNumber` string, nullable
    - `subsidiaryOf` string, nullable
    - `parentGateway` object, nullable
      - `did` string, required
      - `name` string, required
    - `adminEmails` string, nullable
    - `logo` string, nullable
    - `website` string, nullable
    - `description` string, nullable
    - `legalStructure` string, nullable
    - `yearFounded` union
      - number
      - string
    - `incorporationCountry` string, nullable
    - `identificationType` string, nullable
    - `identificationCountry` string, nullable
    - `businessNumber` string, nullable
    - `leiNumber` string, nullable
    - `otherLegalName` string, nullable
    - `legalForm` string, nullable
    - `addressLine1` string, nullable
    - `addressLine2` string, nullable
    - `city` string, nullable
    - `country` string, nullable
    - `street` string, nullable
    - `number` string, nullable
    - `unit` string, nullable
    - `postCode` string, nullable
    - `state` string, nullable
    - `hqStreet` string, nullable
    - `hqNumber` string, nullable
    - `hqUnit` string, nullable
    - `hqPostcode` string, nullable
    - `hqRegion` string, nullable
    - `hqCity` string, nullable
    - `hqCountry` string, nullable
    - `isRegulated` string, nullable
    - `regulatoryStatus` string, nullable
    - `regulatoryAuthorities` unknown
    - `supervisoryAuthority` string, nullable
    - `registrationLicenseId` string, nullable
    - `statusStartDate` string, nullable
    - `statusExpirationDate` string, nullable
    - `lastChecked` string, nullable
    - `additionalInformation` string, nullable
    - `verificationStatus` string, nullable
    - `entityCategory` string, nullable
    - `entityStatus` string, nullable
    - `hasAdmin` boolean, nullable
    - `isNotifiable` boolean, nullable
    - `isActiveSender` boolean, nullable
    - `isActiveReceiver` boolean, nullable
    - `reviewValue` string, nullable
    - `reviewNote` string, nullable
    - `reviewDate` string, nullable
    - `reviewedBy` string, nullable
    - `jurisdictions` string, nullable
    - `jurisdictionStatus` object, nullable
    - `jurisdictionNotabenePage` string, nullable
    - `travelRule_OPENVASP` string, nullable
    - `travelRule_SYGNA` string, nullable
    - `travelRule_TRISA` string, nullable
    - `travelRule_TRLIGHT` string, nullable
    - `travelRule_EMAIL` string, nullable
    - `travelRule_TRP` string, nullable
    - `travelRule_SHYFT` string, nullable
    - `travelRule_USTRAVELRULEWG` string, nullable
    - `travelRule_TRUST` string, nullable
    - `travelRule_notabene` string, nullable
    - `certificates` string, nullable
    - `emailDomains` string, nullable
    - `documents` string, nullable
    - `division` unknown
    - `issuers` object, nullable
    - `onboardingStatus` string, nullable
    - `compliancePhase` number, nullable
    - `compliancePhaseData` object, nullable
    - `billing_customer_did` string, nullable
    - `subscription_id` string, nullable
    - `untracked_usage_in_period` number, nullable
    - `updatedAt` union
      - string
      - string, date-time
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `vaspnetId` string, nullable
    - `vaspnetImmutableFields` string[], nullable
    - `protocol` object, nullable
    - `vasp_categories` string, nullable
    - `isNotabeneCustomer` boolean, nullable
    - `testPhoneNumber` string, nullable
    - `autoEnableWhenUserJoins` boolean, nullable
    - `logo_filename` string, nullable
    - `logo_updated_at` string, nullable
    - `chainalysis_name` string, nullable
    - `badges` string[], nullable
    - `isSandbox` boolean, nullable
    - `identificationNumber` string, nullable
  - `subsidiaryOf` string, nullable
  - `parentGateway` object, nullable
    - `did` string, required
    - `name` string, required
  - `adminEmails` string, nullable
  - `logo` string, nullable
  - `website` string, nullable
  - `description` string, nullable
  - `legalStructure` string, nullable
  - `yearFounded` union
    - number
    - string
  - `incorporationCountry` string, nullable
  - `identificationType` string, nullable
  - `identificationCountry` string, nullable
  - `businessNumber` string, nullable
  - `leiNumber` string, nullable
  - `otherLegalName` string, nullable
  - `legalForm` string, nullable
  - `addressLine1` string, nullable
  - `addressLine2` string, nullable
  - `city` string, nullable
  - `country` string, nullable
  - `street` string, nullable
  - `number` string, nullable
  - `unit` string, nullable
  - `postCode` string, nullable
  - `state` string, nullable
  - `hqStreet` string, nullable
  - `hqNumber` string, nullable
  - `hqUnit` string, nullable
  - `hqPostcode` string, nullable
  - `hqRegion` string, nullable
  - `hqCity` string, nullable
  - `hqCountry` string, nullable
  - `isRegulated` string, nullable
  - `regulatoryStatus` string, nullable
  - `regulatoryAuthorities` unknown
  - `supervisoryAuthority` string, nullable
  - `registrationLicenseId` string, nullable
  - `statusStartDate` string, nullable
  - `statusExpirationDate` string, nullable
  - `lastChecked` string, nullable
  - `additionalInformation` string, nullable
  - `verificationStatus` string, nullable
  - `entityCategory` string, nullable
  - `entityStatus` string, nullable
  - `hasAdmin` boolean, nullable
  - `isNotifiable` boolean, nullable
  - `isActiveSender` boolean, nullable
  - `isActiveReceiver` boolean, nullable
  - `reviewValue` string, nullable
  - `reviewNote` string, nullable
  - `reviewDate` string, nullable
  - `reviewedBy` string, nullable
  - `jurisdictions` string, nullable
  - `jurisdictionStatus` object, nullable
  - `jurisdictionNotabenePage` string, nullable
  - `travelRule_OPENVASP` string, nullable
  - `travelRule_SYGNA` string, nullable
  - `travelRule_TRISA` string, nullable
  - `travelRule_TRLIGHT` string, nullable
  - `travelRule_EMAIL` string, nullable
  - `travelRule_TRP` string, nullable
  - `travelRule_SHYFT` string, nullable
  - `travelRule_USTRAVELRULEWG` string, nullable
  - `travelRule_TRUST` string, nullable
  - `travelRule_notabene` string, nullable
  - `certificates` string, nullable
  - `emailDomains` string, nullable
  - `documents` string, nullable
  - `division` unknown
  - `issuers` object, nullable
  - `onboardingStatus` string, nullable
  - `compliancePhase` number, nullable
  - `compliancePhaseData` object, nullable
  - `billing_customer_did` string, nullable
  - `subscription_id` string, nullable
  - `untracked_usage_in_period` number, nullable
  - `updatedAt` union
    - string
    - string, date-time
  - `created_at` string, nullable
  - `updated_at` string, nullable
  - `vaspnetId` string, nullable
  - `vaspnetImmutableFields` string[], nullable
  - `protocol` object, nullable
  - `vasp_categories` string, nullable
  - `isNotabeneCustomer` boolean, nullable
  - `testPhoneNumber` string, nullable
  - `autoEnableWhenUserJoins` boolean, nullable
  - `logo_filename` string, nullable
  - `logo_updated_at` string, nullable
  - `chainalysis_name` string, nullable
  - `badges` string[], nullable
  - `isSandbox` boolean, nullable
  - `identificationNumber` string, nullable

## 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/revisions/70056745a433/schema)
