Transfer partners API
Pro plan and aboveTransfer partners need Pro or above.
Flexible points currencies transfer to airline and hotel loyalty programs. The directory lists, for each currency, the programs it transfers to and at what ratio, with the minimum, transfer time and any current transfer bonus where known.
Filter the directory by currency code (MR, UR, TYP, C1 and others), or ask for the partners of one card's currency.
Endpoints
GET /v1/transfer-partners: List transfer partners Pro plan and above
The transfer partner directory: which loyalty programs each points currency transfers to, and at what ratio.
currencystringPoints currency code, e.g. MR, UR, TYP, C1curl "https://api.cardapi.dev/v1/transfer-partners?currency=MR" \-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"id": "f59f9870-f319-4d0f-88f1-d7b1e0400cd2",
"source_currency": "MR",
"partner_program": "Aeroplan",
"partner_type": "airline",
"transfer_ratio_from": 1,
"transfer_ratio_to": 1,
"country": "US",
"transfer_minimum": null,
"transfer_time": null,
"transfer_bonus_current": null,
"transfer_bonus_expires": null
},
{
"id": "b3b848be-9c37-421e-9c14-5b41e2a465f5",
"source_currency": "MR",
"partner_program": "ANA Mileage Club",
"partner_type": "airline",
"transfer_ratio_from": 1,
"transfer_ratio_to": 1,
"country": "US",
"transfer_minimum": null,
"transfer_time": null,
"transfer_bonus_current": null,
"transfer_bonus_expires": null
}
]
}GET /v1/cards/:slug/transfers: List a card's transfer partners Pro plan and above
Loyalty programs the card's points can be transferred to, with transfer ratios.
slugstringrequiredCard slug, e.g. american-express-gold-card or chase-sapphire-preferred-credit-card (from /v1/cards or /v1/cards/search)curl "https://api.cardapi.dev/v1/cards/american-express-gold-card/transfers" \-H "Authorization: Bearer YOUR_API_KEY"
{
"data": [
{
"source_currency": "MR",
"partner_program": "Aeroplan",
"partner_type": "airline",
"transfer_ratio_from": 1,
"transfer_ratio_to": 1,
"transfer_time": null,
"transfer_bonus_current": null
}
]
}Currencies and programs
CurrenciesAmex Membership Rewards (MR), Chase Ultimate Rewards (UR), Citi ThankYou Points (TYP), Capital One Miles (C1) and others.
Airline programsFor example Aeroplan, Air France/KLM Flying Blue, ANA Mileage Club, British Airways, Cathay Pacific, Delta SkyMiles, Singapore KrisFlyer, United MileagePlus and Virgin Atlantic.
Hotel programsFor example Accor Live Limitless, Hilton Honors, IHG One Rewards, Marriott Bonvoy, World of Hyatt and Wyndham Rewards.
Transfer partner fields
| Field | Type | Description |
|---|---|---|
id | string (uuid) | |
source_currency | string | Program code, e.g. MR, UR, TYP, C1. |
partner_program | string | |
partner_type | stringnullable | airline or hotel |
transfer_ratio_from | integer | |
transfer_ratio_to | integer | |
country | stringnullable | |
notes | stringnullable | |
is_active | booleannullable | |
transfer_minimum | integernullable | |
transfer_time | stringnullable | |
transfer_bonus_current | stringnullable | |
transfer_bonus_expires | stringnullable |