Quickstart

Welcome! This guide gets you from install → first soft pull → live webhooks in minutes. Use Sandbox for instant results with realistic demo data; switch to Production after business verification.

1) Get your Sandbox Agency Key

After installing via the GO Marketplace, your dashboard shows:

• Agency ID: ag_...
• Sandbox Key: gfa_sb_...
• Default Webhook URL (you can change this anytime)

2) Make your first request

cURL

curl -X POST 'https://api.gofinfi.com/v4/softpull?debug=true' \
  -H 'Authorization: Bearer SANDBOX_KEY_abc123' \
  -H 'Content-Type: application/json' \
  -d '{
    "applicant": {
      "first_name": "Maya",
      "last_name": "Angel",
      "dob": "1992-04-04",
      "ssn_last4": "1234",
      "address": {
        "line1": "123 Maple St",
        "city": "Minneapolis",
        "state": "MN",
        "postal_code": "55401"
      }
    },
    "consent": {
      "given": true,
      "timestamp": "2025-10-28T18:00:00Z",
      "ip": "203.0.113.10",
      "purpose": "credit_eligibility_soft_pull"
    },
    "tracking_id": "demo-001"
  }'

Example response

{
  "status": "success",
  "request_id": "sp_7Aq3xV9m",
  "bureau": "Experian",
  "score": 682,
  "score_detail": { "model": "VantageScore 3.0", "value": 682 },
  "summary": {
    "inquiries": 2,
    "accounts": 11,
    "open_accounts": 7,
    "closed_accounts": 4,
    "utilization": 34,
    "credit_limit": 13900,
    "balance": 281451,
    "risk_level": "Moderate"
  },
  "message": "Soft pull completed"
}

• request_id uniquely identifies the pull (use it for logs and support).
• Sandbox returns realistic demo data; PII is redacted in outbound events.

3) See webhooks arrive

On completion, GOFINFI sends a softpull.completed event to your configured webhook URL. Check your GO app or crm workflow log (or your server logs) to confirm delivery.

4) Error handling

• 400s: validation errors (missing/invalid fields)
• 401/403: bad or revoked key
• 429: sandbox rate limit exceeded
• 5xx: transient—retry with backoff

5) Ready for Production

When ready, complete KYB + MSA, pay the underwriting fee (or refundable deposit), and we’ll issue your Production Key. No code changes—just swap the key and lift sandbox limits.

---