# International

sidebar:
  order: 13

## GET /api/quantis/v2/rates/international/

Returns exchange rates for approximately 170 world currencies relative to USD, sourced from openexchangerates.

| | |
|---|---|
| **Method** | `GET` |
| **URL** | `https://app.vzla.io/api/quantis/v2/rates/international/` |
| **Authentication** | `Authorization: Bearer vzlaio_...` |
| **Parameters** | None |

### Request

```bash
curl --request GET \
  --url 'https://app.vzla.io/api/quantis/v2/rates/international/' \
  --header 'Authorization: Bearer vzlaio_YOUR_TOKEN_HERE'
```

---
sidebar:
  order: 13

### Response

#### `data`

| Field | Type | Description |
|---|---|---|
| `timestamp` | string (ISO 8601 datetime) | When this data was last fetched from openexchangerates |
| `base` | string | Always `"USD"` — all rates are relative to 1 USD |
| `rates` | object | Map of currency code → exchange rate (number) |

Rate values are plain numbers, not strings. The `rates` object contains approximately 170 currency codes.

#### `meta`

| Field | Type | Description |
|---|---|---|
| `source` | string | Always `"openexchangerates"` |

---
sidebar:
  order: 13

### Response headers

| Header | Description |
|---|---|
| `X-API-Version` | `2.0` |
| `X-Quota-Limit` | Your monthly request limit |
| `X-Quota-Remaining` | Requests remaining this month |
| `X-Quota-Reset` | ISO 8601 timestamp of next quota reset |
| `X-Request-ID` | UUID for this request |

---
sidebar:
  order: 13

### Example response

```json
{
  "data": {
    "timestamp": "2026-05-06T19:46:46.339127+00:00",
    "base": "USD",
    "rates": {
      "AED": 3.67315,
      "ARS": 1387.7501,
      "BRL": 4.9412,
      "CLP": 896.65,
      "COP": 3713.473403,
      "EUR": 0.851096,
      "GBP": 0.735602,
      "JPY": 144.886,
      "MXN": 19.5831,
      "PEN": 3.65965
    }
  },
  "meta": {
    "source": "openexchangerates"
  }
}
```

Only a representative subset of the ~170 currencies is shown above.

---
sidebar:
  order: 13

### HTTP status codes

| Code | Meaning |
|---|---|
| `200 OK` | Success. |
| `401 Unauthorized` | Missing or invalid token. |
| `405 Method Not Allowed` | Only GET is supported. |
| `429 Too Many Requests` | Monthly quota exhausted. |
| `500 Internal Server Error` | Server error. Retry after a short delay. |

#### 401 — no Authorization header

```json
{
  "error": {
    "code": "auth_missing",
    "message": "Authentication credentials were not provided"
  }
}
```

#### 401 — invalid token

```json
{
  "error": {
    "code": "auth_token_unknown",
    "message": "Invalid token format"
  }
}
```

#### 429

```json
{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly quota limit exceeded.",
    "details": {
      "reset_at": "2026-06-01T00:00:00Z"
    }
  }
}
```
**Note:** This endpoint is cached for **30 minutes**.