# Invenitor API

Connecting people.

Search for people in plain words with POST /api/v1/people/search, or send one
LinkedIn or GitHub profile link to POST /api/v1/find. A name helps too. Get
emails, phones, and links when we have them. Use a Bearer key.

## Quick start

```bash
curl -X POST https://api.invenitor.com/api/v1/find \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"full_name":"Jordan Lee","linkedin_url":"https://linkedin.com/in/example"}'
```

Keys start with `pf_live_`. Get a key at https://invenitor.com/login after buying credits.

## Customer endpoints

| Method | Path | Notes |
|--------|------|-------|
| POST | /api/v1/find | Lookup. 1 credit only when email or phone is returned |
| GET | /api/v1/usage | Last 24 hours |
| GET | /api/v1/key/info | This key |
| GET | /api/v1/health | `{"status":"ok"}` |
| GET | /api/pricing | Credit packs |

## Packs

New accounts get 25 free credits. Then packs of 25–1,000 credits at ₹2.00 each. Credits expire 30 days after they are granted. Volume: hello@invenitor.com.

MCP is on by default. Ops can turn one account off.

## Errors

401 missing or invalid key. 402 no credits. 429 rate limit. 403 key blocked.
See https://invenitor.com/docs#error-codes.

Sales: hello@invenitor.com
Docs: https://invenitor.com/docs#error-codes
Status: https://invenitor.com/status