gigaverse

Get information about the Gigaverse PRActicle™ — a portable Roth IRA for gig workers, freelancers, and the self-employed (custody through a FINRA/SIPC-member broker-dealer). Returns product description, pricing, launch status, and links. Educational only.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Educational Roth IRA MAGI phase-out check using 2026 IRS limits. NOT tax or investment advice — always show the returned disclaimer to the user. Takes filing_status and MAGI (USD).

{
  "type": "object",
  "properties": {
    "filing_status": {
      "type": "string",
      "enum": [
        "single",
        "head_of_household",
        "married_joint",
        "married_separate"
      ]
    },
    "magi": {
      "type": "number",
      "minimum": 0,
      "maximum": 100000000,
      "description": "Modified adjusted gross income in USD"
    }
  },
  "required": [
    "filing_status",
    "magi"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Initiate a Gigaverse retirement-account signup for your user. This does NOT open an account: it returns a signup_url that the HUMAN account owner must open and complete personally (identity, suitability, and brokerage agreements cannot be completed by an agent). Idempotent per email. Provide the user's email (required), name, gig platforms, and your partner_id if you have one.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The user's email address"
    },
    "name": {
      "type": "string",
      "maxLength": 80,
      "description": "The user's name"
    },
    "platforms": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "description": "Gig platforms, e.g. [\"uber\",\"doordash\"]"
    },
    "partner_id": {
      "type": "string",
      "maxLength": 60,
      "description": "Partner attribution slug (from /api/agent/partners)"
    },
    "sandbox": {
      "type": "boolean",
      "description": "true = test mode: nothing is stored, no email is sent, and the returned signup auto-progresses through the full lifecycle for testing"
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check the status of a previously initiated signup by signup_id. Statuses: initiated (awaiting the human's confirmation), waitlist_joined (human confirmed), account_opened (future). Returns no personal information.

{
  "type": "object",
  "properties": {
    "signup_id": {
      "type": "string",
      "pattern": "^gv_(sgn|test)_[a-z0-9]+$"
    }
  },
  "required": [
    "signup_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Register a company (developer, platform, or retirement broker) as a Gigaverse integration partner. Returns a partner_id attribution slug immediately (status pending_review) — pass it on start_signup so signups are attributed to the partner. No API secrets are issued pre-RIA; advisory services and partner revenue share launch upon RIA registration approval.

{
  "type": "object",
  "properties": {
    "company": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Company or organization name"
    },
    "email": {
      "type": "string",
      "description": "Business contact email"
    },
    "website": {
      "type": "string",
      "maxLength": 200,
      "description": "Company website URL"
    },
    "sandbox": {
      "type": "boolean",
      "description": "true = test mode: returns a test- partner_id, stores nothing"
    }
  },
  "required": [
    "company",
    "email"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}