Retrieve historical exchange rates

GET with from/to date-time range, group granularity, and source/target ISO currency codes. Returns historical FX rates over the requested window.

{
  "query": {
    "from": "string (required, date-time, e.g. '2026-01-10T08:59:56+0000')",
    "to": "string (required, date-time, e.g. '2026-01-10T08:59:56+0000')",
    "group": "string (required: 'day' | 'hour' | 'minute')",
    "source": "string (required, 3-letter ISO 4217 code, e.g. 'GBP')",
    "target": "string (required, 3-letter ISO 4217 code, e.g. 'SBD')"
  }
}

Retrieve current exchange rates

GET with required source currency. Optionally include target for a specific conversion pair and time for a specific timestamp.

{
  "query": {
    "source": "string (required, 3-letter ISO 4217 code, e.g. 'GBP')",
    "target": "string (optional, 3-letter ISO 4217 code, e.g. 'SBD')",
    "time": "string (optional, date-time, e.g. '2026-01-10T08:59:56+0000')"
  }
}

Find flight offers using Amadeus data

GET with required origin, destination, dateDepart, and travelersAdult. Add optional filters like class, direct, and priceMaximum to narrow flight offers.

{
  "query": {
    "origin": "string (required, IATA code, e.g. 'AMS')",
    "destination": "string (required, IATA code, e.g. 'JNB')",
    "dateDepart": "string (required, YYYY-MM-DD)",
    "dateReturn": "string (optional, YYYY-MM-DD)",
    "travelersAdult": "number (required, min 1)",
    "travelersChild": "number (optional)",
    "travelersInfant": "number (optional)",
    "class": "string (optional: 'ECONOMY' | 'PREMIUM_ECONOMY' | 'BUSINESS' | 'FIRST')",
    "direct": "boolean (optional, direct flights only)",
    "currencyCode": "string (optional, e.g. 'USD')",
    "priceMaximum": "number (optional)",
    "resultsMaximum": "number (optional)"
  }
}

Search for places based on a query (full details)

GET with query params. Returns full place details including address, ratings, hours, and contact info.

{
  "query": {
    "query": "string (search term, e.g. 'coffee shops in NYC')",
    "language": "string (optional, e.g. 'en')",
    "region": "string (optional, e.g. 'us')"
  }
}

Look up geolocation and metadata for an IP address

GET with ip query parameter. Optionally send Accept and Accept-Language headers to control response format and localization.

{
  "query": {
    "ip": "string (required, IP address to look up)"
  },
  "headers": {
    "Accept": "string (optional: 'application/json' | 'application/xml')",
    "Accept-Language": "string (optional, response language)"
  }
}