> ## Documentation Index
> Fetch the complete documentation index at: https://developer.salesforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API endpoints

> Base URL, authentication and request conventions for Leadsforge API, with an overview of its endpoint groups.

Use this page as the entry point before working through the Leadsforge API endpoint reference.

## Base URL

```text theme={null}
https://api.leadsforge.ai/public/v1
```

## Authentication

Create an API key in the Leadsforge app under **Settings -> API & MCP**, and send it as is in the `Authorization` header of every request, without a `Bearer ` prefix.

```http theme={null}
Authorization: YOUR_LEADSFORGE_API_KEY
```

A key acts for the workspace member who created it, spends your account's credits, and stops working when that member is removed from the workspace. A Leadsforge key works only with Leadsforge API, not with Salesforge API. See [Authentication](https://developer.salesforge.ai/authentication.md) and [Security best practices](https://developer.salesforge.ai/authentication/security-best-practices.md).

## Request conventions

* **JSON bodies.** Send request bodies as JSON with `Content-Type: application/json`. A body field the endpoint does not know is rejected with `400`, so a misspelled filter fails instead of being ignored.
* **Paging.** Search pages with a cursor. Lookalike company search pages with `page` and `pageSize`. Job lists and job results page with `offset` and `limit`.
* **Jobs.** Long-running operations return `202 Accepted` with a job you follow until it ends. See [Asynchronous jobs](https://developer.salesforge.ai/leadsforge-api/concepts/async-jobs.md).
* **Retries.** Job start requests and lookalike search accept an `Idempotency-Key` header, so a retried request does not start or charge twice.
* **Errors.** Failed requests return a JSON body with a stable `code`, except the few cases listed in [Errors](https://developer.salesforge.ai/leadsforge-api/concepts/errors.md#responses-without-a-code).

## Endpoint groups

| Group | What it does | Cost |
| - | - | - |
| Balance | Your available and reserved credits and your prices | Free |
| Search | Find people by person and company filters, or count them | Free up to a monthly allowance, then per request |
| Search filters | Accepted values for the controlled search filters, and location suggestions | Free |
| Enrichment | Work emails, phone numbers and LinkedIn URLs, as jobs, or single email and phone lookups | Per value found |
| Lookalikes | Companies similar to the domains you give | Preview free up to a monthly allowance, then per request; search per company returned |
| Company followers | People who follow a LinkedIn company page | Per follower collected |
| Maps discovery | Local businesses in an area you choose, and their owners' contacts | Per business found; per owner contact found |

The reference states for each endpoint whether it is free or paid, whether it is synchronous or a job, and what input it requires.

## Related resources

* [Search and enrichment](https://developer.salesforge.ai/leadsforge-api/concepts/search-and-enrichment.md)
* [Credits](https://developer.salesforge.ai/leadsforge-api/concepts/credits.md)
* [Rate limits](https://developer.salesforge.ai/leadsforge-api/concepts/rate-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.