# Quickstart

> For AI agents: a documentation index is available at [https://heirpros.com/llms.txt](https://heirpros.com/llms.txt). This page is also available as markdown at [https://heirpros.com/developers/quickstart.md](https://heirpros.com/developers/quickstart.md).

Make your first heir search hours estimate in two steps.

## 1. Get an API key

API keys are issued by HeirPros. [Contact us](https://heirpros.com/contact-us/) to request one. Keep your key private.

No key? AI assistants can use the free [MCP server](https://heirpros.com/developers/mcp/) instead.

## 2. Send a request

```bash
curl -X POST https://heirpros.com/api/v1/hours \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"known_heirs": 3, "unknown_heirs": 2}'
```

The answer:

```json
{
  "estimated_hours": 6.5,
  "total_heirs": 5,
  "known_heirs": 3,
  "unknown_heirs": 2,
  "case_details": {},
  "method": "1.5 base hours plus 1 hour per known and estimated unknown heir.",
  "note": "This is an estimate. Final hours are confirmed by HeirPros before work starts."
}
```

## Next steps

- [Authentication](https://heirpros.com/developers/authentication/): header options and checking a key.
- [Estimate research hours](https://heirpros.com/developers/estimate-hours/): all fields, including optional case details.
- [Errors](https://heirpros.com/developers/errors/): what to do when a request fails.
