Get a currency

GET/org/currencies/{currency}

Use it in a workflow

Add a step and choose the Zoho CRM connector.
Pick the Get a currency action (under Organisation).
Fill in the fields below, then reference the result from later steps as {{getACurrency.response.data}}.

Request

Path parameters

currencystringrequired

Path parameter identifying the currency ID.

Response

Returns 200 with an object. Read it in later steps with {{getACurrency.response.data.<field>}}.

currenciesarray<object>

JSON array containing the requested currency object.

prefix_symbolbooleanrequired

Represents the position of the currency symbol. **Possible Values:** **true** - Display the currency symbol before the currency value. This is the default value. **false** - Display the currency symbol after the currency value.

formatobjectrequired4 fields

Represents the format of the base currency with details like decimal_separator, thousand_separator, and decimal_places.

exchange_ratestringrequired

Represents the rate at which the currency has to be exchanged with home currency. Accepts positive decimal numbers up to nine digits and nine decimal places. Example: 123456789.123456789.

is_activebooleanrequired

Indicates whether the currency is active and available for use.

exchange_rate_auto_updateboolean

Indicates whether the currency has the automated exchange rate option enabled or not.

iso_codestringrequired

Represents the ISO code of the currency. You can get the currency code from the CRM UI at **Setup > General > Company Settings > Currencies.**

symbolstringrequired

Indicates the currency symbol used for display.

namestringrequired

Represents the name of the currency. You can get the available currencies from the CRM UI at **Setup > General > Company Settings > Currencies.**

is_basebooleanrequired

Indicates whether this is the base currency of the organization.

idstring (int64)required

Unique ID associated with this currency.

created_byobjectrequired2 fields

User who created the currency record.

modified_byobjectrequired2 fields

User who last modified the currency record.

modified_timestring (date-time)required

Timestamp when the currency was last modified.

created_timestring (date-time)required

Timestamp when the currency was initially created.

exchange_rate_updated_timestring (date-time)

Timestamp when the exchange rate was last modified.

json

{
  "currencies": [
    {
      "prefix_symbol": false,
      "format": {
        "numeral_system": "International",
        "decimal_places": "0",
        "decimal_separator": "Comma",
        "thousand_separator": "Comma"
      },
      "exchange_rate": "string",
      "is_active": false,
      "iso_code": "string",
      "symbol": "string",
      "name": "string",
      "is_base": false,
      "id": "string",
      "created_by": {
        "name": "string",
        "id": "string"
      },
      "modified_by": {
        "name": "string",
        "id": "string"
      },
      "modified_time": "2025-01-01T00:00:00Z"
    }
  ]
}

Need more? See the Zoho CRM guide for connection setup and behaviour shared by every action.

Was this page helpful?