Gigaverse API Docs

Initiate a PRActicle™ portable Roth IRA signup for a user. Idempotent per email (replay returns the same signup, HTTP 200). Rate limit 10/min, 50/day per IP.

{
  "signup_id": "gv_sgn_k2x91m4a7q",
  "status": "initiated",
  "partner_id": "acme-gig-app",
  "signup_url": "https://gigaverse.ai/start?sid=gv_sgn_k2x91m4a7q",
  "status_url": "https://gigaverse.ai/api/agent/signups/gv_sgn_k2x91m4a7q",
  "human_action_required": "The account owner must personally open signup_url to confirm.",
  "disclosures": "Gigaverse AI, Inc. is a financial technology company — not a bank..."
}

Poll signup status. Returns no personal information. Status enum is open: initiated → waitlist_joined → account_opened.

{
  "signup_id": "gv_sgn_k2x91m4a7q",
  "status": "waitlist_joined",
  "partner_id": "acme-gig-app",
  "created_at": "2026-06-10T18:21:04Z"
}

Educational 2026 Roth IRA MAGI phase-out estimate. Pure function — stores nothing. Always surface the returned disclaimer.

{
  "eligible": true,
  "partial": false,
  "contribution_limit": 7500,
  "contribution_limit_age_50_plus": 8600,
  "phase_out": null,
  "tax_year": 2026,
  "disclaimer": "Educational estimate only — not tax, legal, or investment advice..."
}

PRActicle™ product information: description, pricing tiers, custodian disclosure, launch status, links. Cacheable (max-age 3600).

{
  "product": "PRActicle™ — Portable Retirement Account",
  "type": "Portable Roth IRA",
  "custodian": "FINRA/SIPC-member broker-dealer provides brokerage services.",
  "launch_status": "waitlist",
  ...
}

Register as an integration partner. Returns a partner_id slug for signup attribution. Advisory services and partner revenue share launch upon RIA registration approval.

{
  "partner_id": "acme-gig-app",
  "status": "pending_review",
  "note": "Use partner_id on POST /api/agent/signups for attribution..."
}

Create an instant payout to a driver's linked bank account or debit card.

{
  "id": "pay_3fj82kx9",
  "object": "payout",
  "status": "completed",
  "amount": 14750,
  "currency": "usd",
  "method": "instant",
  "driver_id": "drv_8xk2m9",
  "completed_at": "2026-01-15T14:32:01Z",
  "fee": 25,
  "net_amount": 14725
}

Retrieve a payment by its ID.

{
  "id": "pay_3fj82kx9",
  "object": "payout",
  "status": "completed",
  "amount": 14750,
  "currency": "usd",
  "created_at": "2026-01-15T14:32:00Z",
  "completed_at": "2026-01-15T14:32:01Z"
}

List payments with optional filters: driver_id, status, created_after, created_before, limit, starting_after.

{
  "object": "list",
  "data": [{ "id": "pay_3fj82kx9", "amount": 14750, "status": "completed" }],
  "has_more": true,
  "total_count": 42
}

Get a driver's earnings summary across all connected platforms.

{
  "driver_id": "drv_8xk2m9",
  "period": "2026-01",
  "total_earnings": 485000,
  "total_tips": 72500,
  "total_miles": 1842,
  "platforms": {
    "uber": { "earnings": 185000, "trips": 142, "tips": 28000 },
    "doordash": { "earnings": 210000, "deliveries": 198, "tips": 31500 },
    "instacart": { "earnings": 90000, "batches": 45, "tips": 13000 }
  },
  "daily_breakdown": [
    { "date": "2026-01-01", "earnings": 18500, "tips": 2800, "miles": 67 }
  ]
}

Initiate OAuth connection to a gig platform for automatic earnings sync.

{
  "authorization_url": "https://auth.uber.com/oauth/authorize?client_id=...",
  "state": "st_k8x2m9f3",
  "expires_at": "2026-01-15T15:02:00Z"
}

Create a new driver profile.

{
  "id": "drv_8xk2m9",
  "object": "driver",
  "email": "[email protected]",
  "first_name": "Alex",
  "last_name": "Johnson",
  "status": "active",
  "created_at": "2026-01-15T14:00:00Z",
  "platforms_connected": [],
  "bank_accounts": []
}

Retrieve a driver's profile, including connected platforms and bank accounts.

{
  "id": "drv_8xk2m9",
  "object": "driver",
  "email": "[email protected]",
  "first_name": "Alex",
  "last_name": "Johnson",
  "status": "active",
  "platforms_connected": ["uber", "doordash"],
  "bank_accounts": [{ "id": "ba_x9f3k2", "last4": "4242", "bank_name": "Chase" }],
  "lifetime_earnings": 2450000,
  "lifetime_payouts": 2380000
}

Add a bank account for payouts via Plaid Link or manual entry.

{
  "id": "ba_x9f3k2",
  "object": "bank_account",
  "last4": "4242",
  "bank_name": "Chase",
  "status": "verified",
  "created_at": "2026-01-15T14:05:00Z"
}

Get a driver's tax summary for a given year, including estimated deductions and liability.

{
  "driver_id": "drv_8xk2m9",
  "year": 2026,
  "gross_income": 5820000,
  "deductions": {
    "mileage": { "miles": 22140, "rate": 0.725, "amount": 1605150 },
    "tips_exemption": { "eligible_tips": 2500000, "amount": 2500000, "provision": "No Tax on Tips Act 2025-2028" },
    "phone_data": 180000,
    "supplies": 45000,
    "total": 4330150
  },
  "estimated_taxable": 1489850,
  "estimated_tax": 357564,
  "quarterly_estimates": [
    { "q": "Q1", "due": "2026-04-15", "amount": 89391 },
    { "q": "Q2", "due": "2026-06-15", "amount": 89391 },
    { "q": "Q3", "due": "2026-09-15", "amount": 89391 },
    { "q": "Q4", "due": "2027-01-15", "amount": 89391 }
  ]
}

Log a mileage entry for tax deduction tracking.

{
  "id": "mil_f9x2k3",
  "miles": 23.4,
  "deduction_amount": 1697,
  "date": "2026-01-15",
  "purpose": "delivery"
}

Generate or retrieve the driver's 1099-NEC for a tax year.

{
  "id": "doc_1099_2026",
  "type": "1099-NEC",
  "year": 2026,
  "status": "available",
  "gross_amount": 5820000,
  "pdf_url": "https://api.gigaverse.ai/v1/tax/drv_8xk2m9/1099/2026.pdf",
  "generated_at": "2027-01-20T00:00:00Z"
}