Raly POC API Docs

Clean public endpoints for corridors, providers, compliance context, and monitoring. Includes endpoint usage, multi-language examples, and response previews.

Overview

Base URL (prod): https://ralydev.vercel.app

GET /api/poc/corridors
GET /api/poc/corridors?from=AED&to=INR
GET /api/poc/corridors/1
GET /api/poc/providers?corridor=AED_INR
GET /api/poc/providers
GET /api/poc/full
GET /api/poc/guide
GET /api/poc/health

Corridors APIs

Fetch all corridors, a single corridor by pair, or a single corridor by id.

GET /api/poc/corridors
GET /api/poc/corridors?from=AED&to=INR
GET /api/poc/corridors/1

Providers APIs

Get providers for one corridor or all grouped providers.

GET /api/poc/providers?corridor=AED_INR
GET /api/poc/providers

Full Payload API

Single payload combining corridor overview + provider list + compliance fields.

GET /api/poc/full

Guide & Health APIs

Field definitions and live API status checks used by monitors.

GET /api/poc/guide
GET /api/poc/health

Language Examples

JavaScript / TypeScript

const res = await fetch("https://ralydev.vercel.app/api/poc/providers?corridor=AED_INR");
const data = await res.json();

Python

import requests
r = requests.get("https://ralydev.vercel.app/api/poc/corridors?from=AED&to=INR")
print(r.json())

cURL

curl "https://ralydev.vercel.app/api/poc/full"

Response Shapes

// GET /api/poc/corridors?from=AED&to=INR
{
  "ok": true,
  "corridor": {
    "id": 1,
    "corridor": "AED→INR",
    "annualFlowBn": "$21.6B",
    "avgCost": "4.2%",
    "bestCost": "2.0%",
    "compliance": "Low",
    "settlement": "Minutes"
  }
}

// GET /api/poc/providers?corridor=AED_INR
{
  "ok": true,
  "corridor": "AED_INR",
  "count": 12,
  "providers": [{ "provider": "Wise", "rate": 25.04, "trueCostPct": "2.01%" }]
}