# Retrieve current rates

The `from`, `to`, and `group` parameters are not testable in our Sandbox environment at this time.
`GET /rates`
Fetch latest exchange rates of all currencies.
`GET /rates?source=EUR&target=USD`
Fetch latest exchange rate of one currency pair.
`GET /rates?source=EUR&target=USD&time=2019-02-13T14:53:01`
Fetch exchange rate of specific historical timestamp.
`GET /rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=day`
Fetch exchange rate history over period of time with daily interval.
`GET /rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=hour`
Fetch exchange rate history over period of time with hourly interval.
`GET /rates?source=EUR&target=USD&from=2019-02-13T14:53:01&to=2019-03-13T14:53:01&group=minute`
Fetch exchange rate history over period of time with 1 minute interval.

Endpoint: GET /rates
Version: 2027Q1
Security: UserToken, PersonalToken

## Security:

  - `UserToken` (unknown)
    http bearer JWT

  - `PersonalToken` (unknown)
    http bearer JWT

## Query parameters:

  - `source` (string)
    Source (send) currency code.

  - `target` (string)
    Target (receive) currency code.

  - `time` (string)
    Timestamp to get historic exchange rate. <br>Supports only Timestamp (combined date and time). Timezone offset is supported but optional. <br>Supported examples: `2019-03-13T14:53:01` or `2019-03-13T14:53:01+0100`.

  - `from` (string)
    Period start date/time to get exchange rate history. <br>Supports Timestamp (combined date and time) or Date (date only). <br>Supported examples: `2019-03-13T14:53:01` or `2019-03-13`.

  - `to` (string)
    Period end date/time to get exchange rate history. <br>Supports Timestamp (combined date and time) or Date (date only). <br>Timezone offset is supported but optional. <br>Supported examples: `2019-03-13T14:53:01+0100` or `2019-03-13+0100`.

  - `group` (string)
    Interval for history grouping.

## Header parameters:

  - `X-External-Correlation-Id` (string)
    Optional UUID for correlating requests across systems. If provided, Wise echoes it back in the response. Maximum 36 characters. [Learn more](/guides/developer/headers/correlation-id).

## Response 200:

  - `200` (unknown)
    List of exchange rate values which meet your query criteria.

## Response 200 fields (application/json):

  - `rate` (number, required)
    Exchange rate value.
    Example: 1.166

  - `source` (string, required)
    Source (send) currency code.
    Example: EUR

  - `target` (string, required)
    Target (receive) currency code.
    Example: USD

  - `time` (string, required)
    Timestamp for exchange rate.
    Example: 2018-08-31T10:43:31+0000

## Response 200 headers (application/json):

  - `X-External-Correlation-Id` (string)
    Echoed back when `X-External-Correlation-Id` was included in the request. [Learn more](/guides/developer/headers/correlation-id).
    Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

  - `x-trace-id` (string)
    Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.
    Example: fba501b6d453b96789f52338f019341f

## Response 400:

  - `400` (unknown)
    Invalid request.

## Response 400 headers:

  - `X-External-Correlation-Id` (string)
    Echoed back when `X-External-Correlation-Id` was included in the request. [Learn more](/guides/developer/headers/correlation-id).
    Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

  - `x-trace-id` (string)
    Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.
    Example: fba501b6d453b96789f52338f019341f

## Response 429:

  - `429` (unknown)
    Rate limit exceeded. Retry after the number of seconds specified in the `Retry-After` header.

## Response 429 headers (application/json):

  - `Retry-After` (integer)
    Number of seconds to wait before retrying the request.
    Example: 5

  - `X-Rate-Limited-By` (string)
    Identifies the rate limiter that triggered the 429 response.
    Example: wise-public-api

  - `X-External-Correlation-Id` (string)
    Echoed back when `X-External-Correlation-Id` was included in the request. [Learn more](/guides/developer/headers/correlation-id).
    Example: f47ac10b-58cc-4372-a567-0e02b2c3d479

  - `x-trace-id` (string)
    Unique trace identifier assigned by Wise. Useful when contacting support about a specific request.
    Example: fba501b6d453b96789f52338f019341f

## Response 400 examples:

  - `badRequest` (unknown)