# REST API for business loan applications

Source: https://businessloanbroker.ai/agents/api/
Site: BusinessLoanBroker.ai (powered by Levr)

> Server to server access to the same capabilities as the MCP: businesses, documents, applications, autofill, matching, submission, deals and webhooks. OpenAPI spec included.

The REST API exposes the same capabilities as the MCP server for integrations that run without a chat client: accounting platforms, vertical software, internal tools. Authentication is a bearer API key the business creates in its account. The OpenAPI spec is at [https://docs.levr.ai/generated/openapi.json](https://docs.levr.ai/generated/openapi.json) and the full reference is at [https://docs.levr.ai/](https://docs.levr.ai/).

## Key facts
- **Auth:** Authorization: Bearer <key> , one key per business
- **Spec:** OpenAPI JSON
- **Resources:** businesses, client intake applications, projects and matchmaking, deals and deal applications, people, lenders
- **Webhooks:** business, application, autofill, matchmaking and deal events
- **Format:** JSON over HTTPS, cursor pagination on list endpoints

## What resources does the API expose?

The resources map one to one onto the MCP tool groups. Businesses hold the profile and people. Client intake applications hold answers, answer files and autofill runs. Projects hold the funding request and matchmaking (criteria, match runs, results and selections). Deals hold a submitted application, its terms and the conversation with the lender. Lenders is a read only directory of who is on the network and their published criteria.

Every write endpoint that changes lender facing state has a review counterpart that returns what would change without changing it, which is how you build a confirmation step into a non chat integration.

## What does an end to end call sequence look like?

- Create the business (`POST /businesses`) and the people who own 20% or more.

- Create a client intake application and fetch its contract to learn the fields.

- Prepare an answer file upload for each document, upload to the signed URL, and confirm.

- Prepare and start autofill, poll until settled, list suggestions and accept the ones that are right.

- Check submission readiness and fill any gaps with answer updates.

- Create a project funding request, calculate matches, read the result summaries.

- Update matchmaking selections with the lenders the owner approved.

- Submit. Subscribe to deal webhooks to learn about terms and status changes.

```
`curl -H "Authorization: Bearer $KEY" \ -H "Content-Type: application/json" \ -d '{"legal_name":"Northside Auto Repair LLC","country":"US"}' \ https://api.businessloanbroker.ai/v1/businesses`
```

Base URLs and exact paths are in the OpenAPI spec; the snippet above is illustrative.

## Which webhook events exist?

Subscribe to the events that matter for your integration rather than polling:

- `client_intake_application.created`, `.updated`, `.status_changed`, `.submitted`

- `client_intake_application_autofill_run.settled`

- `project_matchmaking_run.status_changed`

- `deal.created`, `deal.stage_changed`, `deal.updated`

- `deal_application.status_changed`, `.submitted`

Payloads carry the resource id and a summary; fetch the resource for the full state. Deliveries are signed and retried with backoff.

## When should I use the API instead of the MCP?

Use the MCP when a person is in the loop in a chat client and you want the consent flow handled for you. Use the API when the application is driven by your own software: a bookkeeping platform that offers financing from inside the product, a franchise system onboarding new units, a lender referral partner. You can combine them: an agent in a chat client for the owner, and webhooks into your system for status.

## Questions and answers
**How does a business get an API key?**

From the account settings after creating a free business account. Keys are scoped to that business and can be rotated or revoked at any time.

**Is there a sandbox environment?**

Work in a real business account without calling submit. Everything before submission has no lender facing effect. Contact us for a dedicated test business if you are building a partner integration.

**Are there rate limits?**

Yes, per key, with standard 429 responses and a retry after header. Normal integration traffic will not hit them; bulk backfills should be paced.

## Related
- [MCP server for business loan applications](https://businessloanbroker.ai/agents/mcp/)
- [Tool reference](https://businessloanbroker.ai/agents/tools/)
- [End to end workflow for applying on a business's behalf](https://businessloanbroker.ai/agents/workflow/)
- [Security, consent and data handling](https://businessloanbroker.ai/agents/security/)

## Apply
Apply for the business: https://apply.businessloanbroker.ai/signup?utm_source=direct&utm_medium=organic&utm_content=md-agents-api
MCP server for AI agents: https://mcp.businessloanbroker.ai/mcp (docs: https://businessloanbroker.ai/agents/mcp/)