Raki AE API

Clean docs for a protected AE intelligence API.

This API is designed for the Raki frontend and internal tooling. The docs are public, but every /v1/ae/* route still requires a bearer token. Use the JSON spec if you want to import the contract into Postman or another client.

OpenAPI JSON Legacy JSON Alias Health Ready

Authentication

Bearer token

Use the same signed-in user token Raki already sends to protected InsForge-backed services.

Primary scopes

Exactly one of zip, city, county_fips, or state must be present on each market request.

Optional filters

year, loan_type, purpose, action, and limit.

Public routes

  • / landing page
  • /health service status
  • /ready readiness check
  • /docs human docs
  • /openapi.json raw spec
  • /docs/json legacy spec alias

AE endpoints

GET /v1/ae/top-producers

Top lenders in a market

Bearer required

Example

/v1/ae/top-producers?state=TX
GET /v1/ae/opportunities

Opportunity score, growth, approval, and product fit

Bearer required

Example

/v1/ae/opportunities?city=Dallas,%20TX
GET /v1/ae/growth-markets

Fastest-growing nearby markets

Bearer required

Example

/v1/ae/growth-markets?state=TX
GET /v1/ae/lender-weakness

Lenders losing share or posting weak denial/volume signals

Bearer required

Example

/v1/ae/lender-weakness?state=TX
GET /v1/ae/loan-type-insights

Loan type concentration and product mix

Bearer required

Example

/v1/ae/loan-type-insights?zip=75001
GET /v1/ae/insights

Narrative market summary for AEs

Bearer required

Example

/v1/ae/insights?state=TX
GET /v1/ae/territory-score

Coverage score against your current market

Bearer required

Example

/v1/ae/territory-score?state=TX
GET /v1/ae/missed-opportunities

Coverage gaps and high-value missed opportunities

Bearer required

Example

/v1/ae/missed-opportunities?state=TX