awardwallet

AwardWallet Skill

Query loyalty program balances, elite status, and transaction history via the AwardWallet Business Account Access API.

Source: business.awardwallet.com — Requires a Business account.

Authentication

Set these in your .env file:

• AWARDWALLET_API_KEY — Get from https://business.awardwallet.com/profile/api
• AWARDWALLET_USER_ID — Your connected user ID. Find it via the List Connected Users endpoint below.

All requests use the X-Authentication header.

First-time setup gotcha: AwardWallet enforces an IP allowlist on Business API keys. Without your IP whitelisted, every call returns {"error": "access_denied", "code": "IP_DENIED"}. Whitelist before troubleshooting.

• Where to whitelist: https://business.awardwallet.com/profile/api
• How to find your IP: curl ifconfig.me
• Multi-IP: home, office, hotspot, VPN exit nodes, and any travel locations each need their own entry. Easiest is to whitelist a /24 if you're on a stable residential ISP.

Error signatures

Response	Meaning	Fix
{"error": "access_denied", "code": "IP_DENIED"}	IP not on allowlist	Whitelist current IP at the developer portal
Unauthorized / 401	Bad key	Regenerate key
Empty accounts array	User ID wrong or no connections	Verify AWARDWALLET_USER_ID

API Base

https://business.awardwallet.com/api/export/v1

Quick Start: Get All Balances

curl -s -H "X-Authentication: $AWARDWALLET_API_KEY" \
  "https://business.awardwallet.com/api/export/v1/connectedUser/$AWARDWALLET_USER_ID" | jq '.accounts'

Response Fields

Each account object contains:

Field	Description
accountId	Unique ID for deep dive
code	Provider code (e.g., "united", "chase", "amex")
displayName	Human name (e.g., "United Airlines (MileagePlus)")
kind	Category: Airlines, Hotels, Credit Cards, etc.
balance	Formatted balance string
balanceRaw	Numeric balance
properties	Array with status, account number, expiration, etc.
history	Last 10 transactions (call /account/{id} for full history)
errorCode	1 = successfully updated, 2 = invalid creds, etc.

Useful jq Filters

All filters below assume the curl output is piped in. Replace ... with the full curl command above.

# Just airline balances with status
... | jq '[.accounts[] | select(.kind == "Airlines") | {name: .displayName, balance: .balanceRaw, status: ((.properties // [])[] | select(.kind == 3) | .value) // "none"}]'

# Just hotel balances with status
... | jq '[.accounts[] | select(.kind == "Hotels") | {name: .displayName, balance: .balanceRaw, status: ((.properties // [])[] | select(.kind == 3) | .value) // "none"}]'

# Just credit card / transferable points
... | jq '[.accounts[] | select(.kind == "Credit Cards") | {name: .displayName, balance: .balanceRaw}]'

# All balances sorted by amount (descending), non-zero only
... | jq '[.accounts[] | {name: .displayName, kind: .kind, balance: .balanceRaw} | select(.balance > 0)] | sort_by(-.balance)'

# Elite status across all programs
... | jq '[.accounts[] | {name: .displayName, status: ((.properties // [])[] | select(.kind == 3) | .value) // null} | select(.status != null)]'

# Accounts with errors (need password update, etc.)
... | jq '[.accounts[] | select(.errorCode != 1) | {name: .displayName, error: .errorCode}]'

# Combined summary for trip planning (airlines + transferable points, non-zero, sorted)
... | jq '[.accounts[] | select((.kind == "Airlines" or .kind == "Credit Cards") and .balanceRaw > 0) | {name: .displayName, kind: .kind, balance: .balanceRaw, status: ((.properties // [])[] | select(.kind == 3) | .value) // null}] | sort_by(-.balance)'

Deep Dive: Full Account History

For full transaction history (beyond last 10):

curl -s -H "X-Authentication: $AWARDWALLET_API_KEY" \
  "https://business.awardwallet.com/api/export/v1/account/{accountId}" | jq '.account[0].history'

Travel Timeline

Get saved itineraries for a connected user:

curl -s -H "X-Authentication: $AWARDWALLET_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"start": "2026-01-01", "end": "2027-01-01"}' \
  "https://business.awardwallet.com/api/export/v1/travel-timeline/$AWARDWALLET_USER_ID" | jq '.itineraries'

List All Supported Providers

curl -s -H "X-Authentication: $AWARDWALLET_API_KEY" \
  "https://business.awardwallet.com/api/export/v1/providers/list" | jq '.'

Account Property Kinds

When parsing properties arrays, these kind values are standardized:

Kind	Meaning
1	Account number
2	Expiration
3	Elite status
4	Lifetime points
5	Member since
6	Expiring balance
7	YTD Miles/Points
8	YTD Segments
9	Next elite level
10	Points needed to next level
11	Segments needed to next level
12	Name
13	Last activity
14	Points needed for next reward
15	Status expiration
16	Points to retain status
17	Segments to retain status
18	Alliance elite level
19	Status miles/points

Error Codes

Code	Meaning
0	Never updated
1	Success
2	Invalid credentials
3	Locked out
4	Provider error or user action needed
5	Provider disabled by AwardWallet
6	Parse failure
7	Password missing
8	Disabled to prevent lockouts
9	Success with warning
10	Security question needed
11	Timed out

Workflow: Trip Planning Summary

When planning a trip, run this workflow:

1. Pull all accounts
2. Filter to Airlines and Credit Cards (transferable points)
3. Show a clean summary: program name, balance, elite status
4. Note any accounts with errors that might need updating
5. Cross reference with transfer partners for the destination

Notes

• History in user/member detail responses is capped at 10 records. Use /account/{id} for full history.
• balanceRaw is the numeric value. balance is formatted with commas.
• Connected users control their own access level. If data seems limited, they may have restricted sharing.
• SubAccounts exist for programs like Capital One where one login has multiple cards. Check subAccounts array.