Calqly API

REST API access to every Calqly calculator. Free tier: 1,000 requests/day. No credit card required. Build fintech apps, HR platforms, and nomad tools with real-time global data.

At a Glance

25+

Calculators

200+

Endpoints

50+

Countries

99.9%

Uptime

<100ms

Avg latency

All Calqly calculators are available as REST endpoints returning JSON. Power fintech apps, HR platforms, nomad-visa platforms, and remote work dashboards.

Pricing Tiers

Feature	Free	Pro $5/mo	Enterprise
Requests	1,000/day	10,000/day	Unlimited
Rate limit	10/min	100/min	1,000/min
Data freshness	Daily	Hourly	Live
Webhooks	—	5 endpoints	Unlimited
Historical	7 days	1 year	5 years
White-label embed	—	1 domain	Unlimited
Support	GitHub	Email 48h	Slack + phone
SLA	Best effort	99.5%	99.9% + credits

Free tier: no credit card, no expiration. Pro: cancel anytime with prorated refunds.

Endpoints

Base URL: https://api.calqly.com/v1

All requests require an X-API-Key header. Get a key at /api/keys.

GET/v1/remittance/compare

Compare remittance providers across 200+ corridors.

params: from_country, to_country, amount, currency, delivery_method?, payment_method?

GET/v1/ppp/convert

Convert salary using true purchasing power parity.

params: from_city, to_city, salary, currency

GET/v1/tax/nomad

Multi-country tax with 183-day rules, treaties, PE risk.

params: residence_country, work_countries[], annual_income, currency, days_abroad[]

GET/v1/timezone/meetings

Fair meeting slots across cities with overlap scoring.

params: cities[], duration_minutes, date_range_start, date_range_end

GET/v1/carbon/grid

Carbon footprint based on real grid mix.

params: country, kwh_consumed, period?

GET/v1/contractor/rate

Recommended hourly rate for international clients.

params: client_country, contractor_country, target_annual_usd, platform?

Webhooks (Pro & Enterprise)

Rate Alert

Fires when a remittance provider's total cost drops below your threshold.

Policy Change

Fires when a country's tax / leave policy changes.

FX Volatility

Fires when a currency pair moves >2% in a day.

Security

All payloads signed with HMAC-SHA256. Retries with exponential backoff (1s, 2s, 4s, 8s, 16s).

Rate Limits & Errors

Status	Code	Meaning	Action
200	OK	Success	—
400	BAD_REQUEST	Invalid parameters	Check required fields
401	UNAUTHORIZED	Missing/invalid key	Check X-API-Key header
403	FORBIDDEN	Tier lacks access	Upgrade plan
429	RATE_LIMITED	Too many requests	Wait for Retry-After
500	INTERNAL_ERROR	Server error	Retry with backoff
503	DATA_UNAVAILABLE	Source unavailable	Retry in 5 min

SDKs

Official SDKs for JavaScript/TypeScript (@calqly/sdk), Python (calqly-sdk), Go, and Ruby.

import { CalqlyClient } from '@calqly/sdk';

const client = new CalqlyClient({ apiKey: 'cq_live_...' });

const result = await client.remittance.compare({
  from_country: 'IND',
  to_country: 'ARE',
  amount: 50000,
  currency: 'INR'
});