Contents
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