---
title: "Get the company currency"
method: GET
path: "/settings/v3/currencies/company-currency"
tags: ["Basic"]
---

# Get the company currency

`GET /settings/v3/currencies/company-currency`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/settings/v3/currencies/company-currency`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `cpq.quotes.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.quotes.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `settings.currencies.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `crm.objects.quotes.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `cpq.quotes.read`

Get the details for the company currency. The company currency is used in deal totals, reports, and the default currency for new deals.

## Response `200`

successful operation

- CompanyCurrency
  - `createdAt` string, date-time, required: The date the company currency was created.
  - `id` string, required: The currency code for the company currency

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-31** (v3) `727a013afa20`: 2 info
  - the security scope `cpq.quotes.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `cpq.quotes.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-15** (v3) `1e75688df9b7`: 2 info
  - the security scope `cpq.quotes.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `cpq.quotes.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-03** (v3) `746c3756f4b9`: 1 info
  - endpoint added
- **2026-07-13** (v3) `2a0f76e0a649`: 1 breaking
  - api path removed without deprecation
- **2026-07-13** (v3) `6795e1983140`: 2 info
  - the security scope `cpq.quotes.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `cpq.quotes.read` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/settings-multicurrency/changes/settings/v3/currencies/company-currency/get.md)

---

[API](https://skmtc.dev/hubspot/apis/settings-multicurrency.md) - [All operations](https://skmtc.dev/hubspot/apis/settings-multicurrency/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/settings-multicurrency/revisions/727a013afa20?raw)