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

# API Reference

> Complete reference for all Leonar API endpoints.

The Leonar API is organized around REST. It uses standard HTTP methods, returns JSON responses, and uses Bearer token authentication.

## Base URL

```
https://app.leonar.app/api/v1
```

## Authentication

Include your API key in the `Authorization` header:

```
Authorization: Bearer leo_your_api_key
```

## Resources

<CardGroup cols={3}>
  <Card title="Contacts" icon="users" href="/api-reference/contacts/list">
    Manage contacts, search, enrich, and read custom field values.
  </Card>

  <Card title="Companies" icon="building" href="/api-reference/companies/list">
    Track companies, their contacts, and company custom fields.
  </Card>

  <Card title="Deals" icon="handshake" href="/api-reference/deals/list">
    Manage sales pipeline and deal stages.
  </Card>

  <Card title="Projects" icon="folder" href="/api-reference/projects/list">
    Organize recruiting projects.
  </Card>

  <Card title="Sequences" icon="paper-plane" href="/api-reference/sequences/list">
    Automate outreach campaigns.
  </Card>

  <Card title="Tasks" icon="check" href="/api-reference/tasks/list">
    Track to-dos and follow-ups.
  </Card>

  <Card title="Messages" icon="envelope" href="/api-reference/messages/send">
    Send emails, LinkedIn messages.
  </Card>

  <Card title="Sourcing" icon="magnifying-glass" href="/api-reference/sourcing/search">
    Search and import candidates.
  </Card>

  <Card title="Enrichment" icon="sparkles" href="/api-reference/enrichment/enrich-contact">
    Find emails and phone numbers.
  </Card>
</CardGroup>

## Custom fields

Contacts and companies can include workspace-defined custom fields in the `custom_data` object.

* use `GET /contacts/custom-fields` and `GET /companies/custom-fields` to discover valid keys
* read values from `custom_data` on contact and company responses
* update values with partial merge semantics on `PUT /contacts/{id}` and `PUT /companies/{id}`