Developers · Genius API

Build on the mortgage rails

The same pricing, loan, and eligibility engine that powers Genius — exposed as a clean, type-safe API. Price a real scenario across 80+ investors with a single request.

Get API keys See the pricing engine

quote.sh200 OK · 0.18s

# Price a scenario across every eligible investor
curl https://api.trygenius.ai/v1/pricing/quote \
  -H "Authorization: Bearer sk_live_•••" \
  -d '{
       "loan_amount": 420000,
       "fico": 760,
       "term": 360,
       "occupancy": "primary"
     }'

# → returns best-ex price + every investor
{ "best_ex": { "investor": "FNMA", "rate": 6.5, "price": 101.875 } }

<200ms

median pricing latency

99.99%

API uptime

80+

investors, one call

REST

+ webhooks + SDKs

Everything you need to ship

Real-time pricing API

POST a scenario and get best-execution pricing across every eligible investor in under a second.

Type-safe SDKs

First-class libraries for TypeScript, Python, Go, and Ruby — fully typed against the latest schema.

Webhooks for everything

Subscribe to loan, condition, and pricing events and react the instant something changes.

Free sandbox

Test keys and realistic mock data from day one. Build the full flow before you ever go live.

Secure by default

OAuth2, scoped API keys, idempotency keys, and signed webhook payloads on every request.

Versioned & documented

Date-versioned endpoints, an OpenAPI spec, and reference docs that never drift from the API.

Quickstart

From npm install to first quote in minutes

quote.tsTypeScript SDK

// npm i @genius/sdk
import { Genius } from "@genius/sdk";

const genius = new Genius(process.env.GENIUS_KEY);

const quote = await genius.pricing.quote({
  loanAmount: 420_000,
  fico: 760,
  term: 360,
  occupancy: "primary",
});

console.log(quote.bestEx.rate); // 6.5

webhook.jsonloan.condition.cleared

// POST'd to your endpoint, signed
{
  "event": "loan.condition.cleared",
  "loan_id": "loan_9f2a",
  "data": {
    "condition": "income_docs",
    "cleared_by": "genius_ai",
    "at": "2026-06-24T14:02:11Z"
  },
  "signature": "v1=8a3f•••"
}

SDKs:TypeScriptPythonGoRubycURL

API Reference

A focused, predictable API

POST/v1/pricing/quotePrice a scenario across every eligible investor

GET/v1/eligibilityCheck product & guideline eligibility

POST/v1/loansCreate a loan application

GET/v1/loans/:idRetrieve a loan and its full status

GET/v1/loans/:id/conditionsList conditions and clearing status

POST/v1/webhooksRegister a webhook subscription

Get a sandbox key and start building

Free test keys, realistic mock data, and the full pricing engine behind one endpoint.

Get API keys