Developer

API Reference

The FEVAL-AI API lets you programmatically submit business ideas, retrieve evaluations, and export reports. All endpoints return JSON.

Authentication

Pass your API key in the Authorization: Bearer <key> header. Keys are available in your account settings.

Base URL

https://feval-ai-web.vercel.app/api

Endpoints

POST/api/evaluations

Submit a new business idea for evaluation. Returns an evaluation ID immediately; use the status endpoint to poll for completion.

GET/api/evaluations/:id

Retrieve a completed evaluation by ID, including the full FEVAL Score, dimension breakdown, valuations, and citations.

GET/api/evaluations/:id/status

Poll the processing status of an in-flight evaluation. Returns current stage and estimated completion.

GET/api/reports/:id

Download the PDF feasibility report for a completed evaluation.

Rate limits

Free3 evaluations / month
ProUnlimited evaluations
InstitutionalCustom — contact us

API Access

API access is available on Pro and Institutional plans. Contact us for Institutional batch API access or white-label options.