A
AAFHQYour Financial Headquarters
PHASE 11 — FINANCIAL API NETWORK

The Financial Infrastructure Layer

One gateway, eight APIs. Banks, insurers, lenders, fintechs, and governments connect directly to AAFHQ's verified identity, trust, credit, and marketplace data.

GATEWAY ENDPOINT
POST /functions/apiGateway
AUTH — X-API-KEY HEADER · SCOPED PER RESOURCE · RATE-BOUNDED
Identity API

Look up a consumer's verified universal financial identity by passport.

PARAMS — public_id
RETURNS — verification level, trust score, country
resource: "identity"
Verification API

Check whether a company is AAFHQ-verified and at what level.

PARAMS — company_id or company_name
RETURNS — verified status, badge tier, license
resource: "verification"
Trust Score API

Pull the live trust score and verification level for a passport.

PARAMS — public_id
RETURNS — trust score, verification level
resource: "trust"
Credit Score API

Read a passport's credit score on the unified 300–850 scale.

PARAMS — public_id
RETURNS — credit score, unified scale, country
resource: "credit"
Marketplace API

Browse verified financial products by category and country.

PARAMS — category, country
RETURNS — rate, term, range, fees
resource: "marketplace"
Passport API

Fetch the full public Financial Passport record.

PARAMS — public_id
RETURNS — passport number, scores, dates
resource: "passport"
Alerts API

Stream the latest national scam and safety alerts.

PARAMS — none
RETURNS — active scam alerts
resource: "alerts"
AI Recommendation API

Get an AI-generated product recommendation for a passport holder.

PARAMS — public_id, product_interest
RETURNS — recommendation with reasoning
resource: "ai"
SAMPLE REQUEST
curl -X POST https://finance-trust-headquarters.base44.app/functions/apiGateway \
  -H "Content-Type: application/json" \
  -H "x-api-key: aafhq_sk_your_key" \
  -d '{
    "resource": "identity",
    "params": { "public_id": "AFP-XXXX-XXXX" }
  }'
EVERY RESPONSE RETURNS { resource, client, data } — 401 ON BAD KEYS, 403 ON MISSING SCOPES, 404 ON UNKNOWN RECORDS.
API AUTHENTICATION

One key. Scoped access. Zero ambiguity.

Keys are issued per organization with only the scopes you approve. Revoke any key anytime. Every request is counted against your client record.

IDENTITY · VERIFICATION · TRUST · CREDIT · MARKETPLACE · PASSPORT · ALERTS · AI

REQUEST AN API KEY
SCOPES
See what the data layer holds

The universal data schema behind every API response.

Open Global Intelligence