GET ExchangeRates API

Updated on 2014-05-21
Current Version: Version 1
Deprecated Version: NA
Requests Allowed: GET&SOAP

Summary:

Returns an array of exchange rates.

Resource/WSDL Page:

http://<your_domain_here>/api/1/get.asmx?op=ExchangeRates

Parameters

api_key
Required
Type: STRING
Length (Max/Min): 50

Must be a valid API key (existing and not expired) 

Example Values: Fo35NRAqvFLXoZxqB4aViaiYM7iVMhh

start_date
Required
Type: DATE

Allowed formats: "yyyy-mm-dd","dd-mm-yyyy"

start_date
Required
Type: DATE


Allowed formats: "yyyy-mm-dd","dd-mm-yyyy"

 **Note all optional parameters still need to be passed through in the actual call. These parameters do not need a value (therefore you can use a null value). 

 

Example Request

GET

http://demo.cakemarketing.com/api/1/get.asmx/ExchangeRates?api_key=dNJFmId9rI&start_date=01/01/2013+00:00:00&end_date=01/02/2013+12:00:00

 

Sample XML Response:

<exchange_rates_response>
  <success>true</success>
  <row_count>12</row_count>
  <exchange_rates>
    <exchange_rate>
      <base_currency>
        <currency_id>1</currency_id>
        <currency_symbol>$</currency_symbol>
        <currency_name>US Dollar</currency_name>
        <currency_abbr>USD</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>2</currency_id>
        <currency_symbol>€</currency_symbol>
        <currency_name>Euro</currency_name>
        <currency_abbr>EUR</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>0.7643420000</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>2</currency_id>
        <currency_symbol>€</currency_symbol>
        <currency_name>Euro</currency_name>
        <currency_abbr>EUR</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>1</currency_id>
        <currency_symbol>$</currency_symbol>
        <currency_name>US Dollar</currency_name>
        <currency_abbr>USD</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>1.3083148642</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>1</currency_id>
        <currency_symbol>$</currency_symbol>
        <currency_name>US Dollar</currency_name>
        <currency_abbr>USD</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>3</currency_id>
        <currency_symbol>£</currency_symbol>
        <currency_name>British Pound</currency_name>
        <currency_abbr>GBP</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>0.6454240000</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>3</currency_id>
        <currency_symbol>£</currency_symbol>
        <currency_name>British Pound</currency_name>
        <currency_abbr>GBP</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>1</currency_id>
        <currency_symbol>$</currency_symbol>
        <currency_name>US Dollar</currency_name>
        <currency_abbr>USD</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>1.5493690969</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>1</currency_id>
        <currency_symbol>$</currency_symbol>
        <currency_name>US Dollar</currency_name>
        <currency_abbr>USD</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>4</currency_id>
        <currency_symbol>A$</currency_symbol>
        <currency_name>AU Dollar</currency_name>
        <currency_abbr>AUD</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>0.9828430000</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>4</currency_id>
        <currency_symbol>A$</currency_symbol>
        <currency_name>AU Dollar</currency_name>
        <currency_abbr>AUD</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>1</currency_id>
        <currency_symbol>$</currency_symbol>
        <currency_name>US Dollar</currency_name>
        <currency_abbr>USD</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>1.0174565011</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>2</currency_id>
        <currency_symbol>€</currency_symbol>
        <currency_name>Euro</currency_name>
        <currency_abbr>EUR</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>3</currency_id>
        <currency_symbol>£</currency_symbol>
        <currency_name>British Pound</currency_name>
        <currency_abbr>GBP</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>0.8444180000</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>3</currency_id>
        <currency_symbol>£</currency_symbol>
        <currency_name>British Pound</currency_name>
        <currency_abbr>GBP</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>2</currency_id>
        <currency_symbol>€</currency_symbol>
        <currency_name>Euro</currency_name>
        <currency_abbr>EUR</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>1.1842476119</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>2</currency_id>
        <currency_symbol>€</currency_symbol>
        <currency_name>Euro</currency_name>
        <currency_abbr>EUR</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>4</currency_id>
        <currency_symbol>A$</currency_symbol>
        <currency_name>AU Dollar</currency_name>
        <currency_abbr>AUD</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>1.2858680000</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>4</currency_id>
        <currency_symbol>A$</currency_symbol>
        <currency_name>AU Dollar</currency_name>
        <currency_abbr>AUD</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>2</currency_id>
        <currency_symbol>€</currency_symbol>
        <currency_name>Euro</currency_name>
        <currency_abbr>EUR</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>0.7776848012</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>3</currency_id>
        <currency_symbol>£</currency_symbol>
        <currency_name>British Pound</currency_name>
        <currency_abbr>GBP</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>4</currency_id>
        <currency_symbol>A$</currency_symbol>
        <currency_name>AU Dollar</currency_name>
        <currency_abbr>AUD</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>1.5227870000</rate>
    </exchange_rate>
    <exchange_rate>
      <base_currency>
        <currency_id>4</currency_id>
        <currency_symbol>A$</currency_symbol>
        <currency_name>AU Dollar</currency_name>
        <currency_abbr>AUD</currency_abbr>
      </base_currency>
      <quote_currency>
        <currency_id>3</currency_id>
        <currency_symbol>£</currency_symbol>
        <currency_name>British Pound</currency_name>
        <currency_abbr>GBP</currency_abbr>
      </quote_currency>
      <start_date>2013-01-01T00:00:00</start_date>
      <end_date>2013-01-31T00:00:00</end_date>
      <rate>0.6566906599</rate>
    </exchange_rate>
  </exchange_rates>
</exchange_rates_response>

Example Error Messages:  

Error Message

Likely Cause

Invalid API Key

API key does not exist or is expired