# Download currency rates as JSON

**GET** `https://api.zoined.com/v2/download/currencyRates.json?limit=1000&offset=0&start=2018-01-01&end=2018-12-31&currency=SEK`

Endpoint: GET /v2/download/currencyRates.json
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer token

## Query parameters:

  - `limit` (number)
    How many entries to return

  - `offset` (number)
    Which offset to return data from

  - `start` (string)
    Returns currency rates from given date onward

  - `end` (string)
    Returns currency rates until given date

  - `currency` (string)
    Return only rates with given currencies as either source or target currency

## Response 200:

  - `200` (unknown)
    Request has been processed successfully.
**Headers**
- `Content-Type: application/json`

## Response 200 fields (application/json):

  - `source_currency` (string, required)
    Source currency as ISO 4217 currency code.
    Example: EUR

  - `target_currency` (string, required)
    Target currency as ISO 4217 currency code.
    Example: SEK

  - `valid_from` (string, required)
    First day when the exchange rate is valid
    Example: 2017-01-01

  - `valid_to` (string, required)
    Last day when the exchange rate is valid
    Example: 2017-12-31

  - `rate` (number, required)
    Exchange rate to from source to target currency
    Example: 0.1123

## Response 400:

  - `400` (unknown)
    Invalid or malformed request.
**Headers**
- `Content-Type: application/json`

## Response 400 fields (application/json):

  - `status` (string, required)
    Status of the operation OK / Not OK
    Example: Not OK

  - `msg` (string, required)
    Message describing result of operation
    Example: Reason for error

## Response 401:

  - `401` (unknown)
    Missing or invalid authorization token in header
**Headers**
- `Content-Type: application/json`

## Response 401 fields (application/json):

  - `status` (string, required)
    Status of the operation OK / Not OK
    Example: Not OK

  - `msg` (string, required)
    Message describing result of operation
    Example: Unauthorized

## Response 500:

  - `500` (unknown)
    Internal error or exception
**Headers**
- `Content-Type: application/json`

## Response 500 fields (application/json):

  - `status` (string, required)
    Status of the operation OK / Not OK
    Example: Not OK

  - `msg` (string, required)
    Message describing result of operation
    Example: Reason for error

## Response 200 examples:

  - `response` (unknown)

## Response 400 examples:

  - `response` (unknown)

## Response 401 examples:

  - `response` (unknown)

## Response 500 examples:

  - `response` (unknown)