---
title: "Get own regulated entity"
method: GET
path: "/api-regulated/v1/regulated-entities/self"
tags: ["RegulatedEntity"]
---

# Get own regulated entity

`GET /api-regulated/v1/regulated-entities/self`

## Request

- Base URL: `https://api.currencyguard.com`
- URL: `https://api.currencyguard.com/api-regulated/v1/regulated-entities/self`
- Auth: HTTP bearer

Returns the regulated entity details for the authenticated regulated user.

## Response `200`

Regulated entity retrieved successfully

- RegulatedEntityDTO: Schema for representing a RegulatedEntity
  - `id` string, uuid: The ID for this regulated entity.
  - `entityReferenceCode` string: Two-character code identifying this regulated entity in customer-facing references, e.g. the 'SP' in Guard reference GSP1000104. Immutable once a Guard has been issued under it.
  - `piiData` RegulatedEntityDTOPiiData: **Extensible JSONB field** - The PII data for this regulated entity as JSONB (includes name, regulatory info, address, phone, website, and contact). This field accepts any valid JSON structure and can be extended with additional properties as needed. Note: While the structure is extensible, known fields shown in the example are subject to application validation.
  - `oauthPoolId` string, uuid: The OAuth pool this regulated entity's staff authenticate against.
  - `perimeterId` string, uuid: The tenant perimeter whose KMS key encrypts this record's PII.
  - `eventSequence` integer: Event sequence number for event sourcing.
  - `versionNumber` integer: The strictly monotonically increasing version number for this record.
  - `updatedBy` string: The username of the person or entity that updated this record.
  - `updatedAt` string: The timestamp of the last update in UTC.
  - `createdAt` string: The timestamp of creation in UTC.

## Other responses

- `401`: Not authenticated — [`security/authentication-failed`](/problems/security/authentication-failed/)
- `403`: Not authorized - requires regulated role — [`security/insufficient-permissions`](/problems/security/insufficient-permissions/)
- `404`: Regulated entity not found — [`http/resource-not-found`](/problems/http/resource-not-found/)
- `500`: Server error — [`server/internal-error`](/problems/server/internal-error/)

---

[API](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external.md) · [All operations](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/llms.txt) · [OpenAPI document](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/revisions/a1f3f854190d?raw)