Contents
On this page

Rate History - Plugixa Multi Currency for WooCommerce

GET /plugixa-multi-currency/v1/rates/history

Every rate fetched for a currency, newest first, whether it was applied or not. Pro shows it as a chart on the Currencies screen. See Rate alerts and history.

Needs a user with the plugixa_multi_currency_view capability (signed in with an Application Password, or the login cookie with an X-WP-Nonce header). Administrators hold it; see Capabilities.

Request

GET https://your-store.example/wp-json/plugixa-multi-currency/v1/rates/history?currency=EUR&limit=3

Query parameters

Field Type Required Description
currency string Yes The currency code.
limit integer No How many lines, 1 to 500. Defaults to 30.

Responses

200 OK.

{
  "success": true,
  "data": [
    {
      "id": 428,
      "currency": "EUR",
      "rate": "0.9099181073",
      "provider": "ecb",
      "status": "applied",
      "fetched_at": "2026-11-20 16:20:17"
    },
    {
      "id": 61,
      "currency": "EUR",
      "rate": "0.9234",
      "provider": "ecb",
      "status": "applied",
      "fetched_at": "2026-11-19 06:00:00"
    },
    {
      "id": 60,
      "currency": "EUR",
      "rate": "0.930913",
      "provider": "ecb",
      "status": "applied",
      "fetched_at": "2026-11-18 06:00:00"
    }
  ]
}
Field Type Meaning
id integer The line’s id. Pro uses it in Apply Held Rate
currency string The currency
rate string The rate fetched
provider string The source
status string applied, held (waiting for approval, Pro), rejected
fetched_at string UTC

Rates typed by hand are not in the history: only fetched ones are. An unknown currency gives an empty list.

Errors

Status Code When
401 / 403 rest_forbidden The caller lacks the capability: Sorry, you are not allowed to do that.

Plus the errors every endpoint can return.

Examples

curl -s "https://your-store.example/wp-json/plugixa-multi-currency/v1/rates/history?currency=EUR&limit=3" \
  -u "$WP_USER:$WP_APP_PASSWORD"
<?php
$ch = curl_init('https://your-store.example/wp-json/plugixa-multi-currency/v1/rates/history?currency=EUR&limit=3');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => getenv('WP_USER') . ':' . getenv('WP_APP_PASSWORD'),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
const response = await fetch('https://your-store.example/wp-json/plugixa-multi-currency/v1/rates/history?currency=EUR&limit=3', {
  headers: {
    'Authorization': `Basic ${btoa(`${process.env.WP_USER}:${process.env.WP_APP_PASSWORD}`)}`,
  },
});
const { data } = await response.json();

Quick Links

Share