Fare Intelligence API

Base URL and authentication

Every request goes to the base URL below and must carry your key in the X-API-Key header.

https://api.iocarta.com/api/v1

X-API-Key: iocp_your_key_here

A missing or invalid key returns 401. Each key has a per-minute rate limit; exceeding it returns 429.

Tiers

GET/feed/deals

Verified, AI-graded flight deals, newest first. Optional query parameters: origin and destination (3-letter IATA codes) and min_discount (number).

curl "https://api.iocarta.com/api/v1/feed/deals?origin=BRU" \
  -H "X-API-Key: iocp_your_key_here"

{
  "count": 1,
  "tier": "enterprise",
  "deals": [
    {
      "id": 1042,
      "origin": "CRL",
      "destination": "PMI",
      "price": 16.99,
      "market_price": 38.0,
      "discount_percent": 55.3,
      "grade": "rare_deal",
      "airline": "Ryanair",
      "departure_date": "2026-05-27",
      "return_date": null,
      "trip_type": "one_way",
      "booking_url": "https://...",
      "confidence_score": 75,
      "spotted_at": "2026-05-19T12:00:00"
    }
  ]
}

grade is one of error_fare, rare_deal, good_deal or no_deal.

GET/feed/anomalies

Error-fare anomalies only: fares the agent graded as error fares, far below a route's normal market price. The early-warning feed. Records use the same shape as /feed/deals, returned under an anomalies array.

curl "https://api.iocarta.com/api/v1/feed/anomalies" \
  -H "X-API-Key: iocp_your_key_here"

POST/verify

Run the IoCarta verification agent on any fare. The agent researches live and metasearch prices and returns a structured verdict. Allow up to ~30 seconds.

curl -X POST "https://api.iocarta.com/api/v1/verify" \
  -H "X-API-Key: iocp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "JFK",
    "destination": "CDG",
    "departure_date": "2026-09-15",
    "return_date": "2026-09-25",
    "trip_type": "return",
    "claimed_price": 95
  }'

{
  "verdict": {
    "genuine": true,
    "is_error_fare": true,
    "confidence": "high",
    "recommended_action": "publish",
    "grade": "error_fare",
    "market_price": 496,
    "discount_percent": 81,
    "assessment": "EUR 95 return sits 81% below the typical price ...",
    "traveller_note": "This looks like a genuine pricing mistake ...",
    "deal_description": "Possible error fare: New York JFK to Paris CDG ..."
  }
}

return_date and trip_type are optional; trip_type defaults to one_way.

Errors