# Leadex API

> Chat-native lead research, programmatically. Start a thread, describe your ideal customer in natural language, and Leadex plans + runs a research job and returns verified leads as artifacts (CSV, JSON, webhook).

The Leadex API is REST + JSON, authenticated with a bearer token, served at `https://api.getleadex.com/v1`. The human-readable reference below is rendered from `openapi.yaml` (OpenAPI 3.1) - the spec is the source of truth.

## Reference

- [Full API reference](https://docs.getleadex.com/): rendered docs - endpoints, objects, errors, webhooks, SDKs, glossary
- [OpenAPI 3.1 spec](https://docs.getleadex.com/openapi.yaml): machine-readable source of truth

## Getting started

- [Authentication](https://docs.getleadex.com/#authentication): bearer token in `Authorization: Bearer ...`
- [Base URL & versioning](https://docs.getleadex.com/#base-url): `https://api.getleadex.com/v1`
- [Quickstart](https://docs.getleadex.com/#quickstart): first call in under a minute
- [Errors](https://docs.getleadex.com/#errors), [Rate limits](https://docs.getleadex.com/#rate-limits), [Idempotency](https://docs.getleadex.com/#idempotency), [Pagination](https://docs.getleadex.com/#pagination)

## Core objects

- [Thread](https://docs.getleadex.com/#object-thread): the chat container
- [Message](https://docs.getleadex.com/#object-message): user + assistant turns in a thread
- [Plan](https://docs.getleadex.com/#object-plan): proposed research steps, subject to approval
- [Job](https://docs.getleadex.com/#object-job): a running or finished research execution
- [Artifact](https://docs.getleadex.com/#object-artifact): structured output (CSV / JSON) produced by a job
- [Lead](https://docs.getleadex.com/#object-lead): an enriched contact row inside an artifact

## Endpoints

- [Threads](https://docs.getleadex.com/#ep-threads), [Messages](https://docs.getleadex.com/#ep-messages)
- [Plans](https://docs.getleadex.com/#ep-plans), [Jobs](https://docs.getleadex.com/#ep-jobs), [Streaming](https://docs.getleadex.com/#ep-stream)
- [Artifacts & leads](https://docs.getleadex.com/#ep-artifacts), [Search (one-shot)](https://docs.getleadex.com/#ep-search)
- [Integrations](https://docs.getleadex.com/#ep-integrations), [Webhooks](https://docs.getleadex.com/#ep-webhooks)
- [Usage & credits](https://docs.getleadex.com/#ep-usage), [Account & keys](https://docs.getleadex.com/#ep-account)

## Product

- [Marketing site](https://getleadex.com/): overview, capabilities, pricing
- [Web app](https://app.getleadex.com/): signed-in UI for the same API
- [Privacy policy](https://getleadex.com/privacy.html)
- [Terms of service](https://getleadex.com/terms.html)