---
title: "Get CurrencyGuard company by ID"
method: GET
path: "/api-regulated/v1/currencyguard-companies/{currencyguardCompanyId}"
tags: ["CurrencyguardCompany"]
---

# Get CurrencyGuard company by ID

`GET /api-regulated/v1/currencyguard-companies/{currencyguardCompanyId}`

## Request

- Base URL: `https://api.currencyguard.com`
- URL: `https://api.currencyguard.com/api-regulated/v1/currencyguard-companies/{currencyguardCompanyId}`
- Auth: HTTP bearer

Retrieves a specific CurrencyGuard company by its ID. Available to regulated and customer users.

## Path parameters

- `currencyguardCompanyId` string, uuid, required

## Response `200`

CurrencyGuard company retrieved successfully

- CurrencyguardCompanyDTO: Schema for representing a CurrencyguardCompany
  - `id` string, uuid: The ID for CurrencyGuard company.
  - `companyName` string: The company name.
  - `registeredCompanyNumber` string: The registered company number.
  - `contactEmail` string: The main contact email address.
  - `websiteUrl` string: The company website URL.
  - `phoneNumber` string: The primary contact phone number.
  - `addressLine1` string: The head office address line 1.
  - `addressLine2` string: The head office address line 2.
  - `city` string: The head office city.
  - `stateProvince` string: The head office state/province.
  - `postcode` string: The head office postcode.
  - `countryCode` string: The head office country code.
  - `companyLogoDocumentId` string, uuid: The company logo document.
  - `calendarCode` string: The calendar code for this company's trading operations.
  - `calendarTimezone` string: The timezone for this company's trading operations.
  - `operatingHours` CurrencyguardCompanyDTOOperatingHours: **Extensible JSONB field** - Operating hours for trading operations in JSON format 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.
  - `isActive` boolean: Whether CurrencyGuard company record is active.
  - `oauthPoolId` string, uuid: The OAuth pool CurrencyGuard staff authenticate against.
  - `systemOauthPoolId` string, uuid: The OAuth pool system accounts 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

- `400`: Invalid company ID format — [`http/malformed-request`](/problems/http/malformed-request/)
- `401`: Not authenticated — [`security/authentication-failed`](/problems/security/authentication-failed/)
- `403`: Not authorized — [`security/insufficient-permissions`](/problems/security/insufficient-permissions/)
- `404`: CurrencyGuard company 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)