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

# API overview

> Find and verify professional contact data from your own systems, with the same platform the Loice web app runs on.

The Loice API exposes every capability of the web app as a key-authenticated HTTP endpoint:
finding and verifying a work email, enriching an email address into a person, searching LinkedIn
profiles by name, running lead and employee searches in the background, and saving people to
lead lists.

Every request goes to `https://app.loice.ai/api/v1/…` with a workspace API key.

> [card] [Authenticate](https://docs.loice.ai/authentication.md)
>
> Create a workspace API key and send it as a bearer token.

> [card] [Handle errors](https://docs.loice.ai/errors.md)
>
> One error shape, with a machine-readable code to branch on.

> [card] [Understand billing](https://docs.loice.ai/billing.md)
>
> What is billed, when, and where to see the current costs.

> [card] [Browse the reference](https://docs.loice.ai/api-reference/find-and-verify-email.md)
>
> Every operation, its parameters, responses and examples.

## Your first call

Check the points balance of your workspace. It is free and needs only a key:

```bash theme={null}
curl https://app.loice.ai/api/v1/points \
  -H "Authorization: Bearer $LOICE_API_KEY"
```

```json theme={null}
{ "data": { "available": 99, "reserved": 0, "granted": 100 } }
```

Then find a verified work email:

```bash theme={null}
curl https://app.loice.ai/api/v1/find \
  -H "Authorization: Bearer $LOICE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"mode":"email","name":"Satya Nadella","company":"microsoft.com"}'
```

## The machine-readable description

The API is described by an OpenAPI 3.1 document, generated from the same source the server
validates requests with:

* `GET https://app.loice.ai/api/v1/openapi.json` is the live document, including the current
  point cost of every operation. Point code generators at it.
* `GET https://app.loice.ai/api/v1/openapi.json?audience=docs` is the variant this site is built
  from: the same operations, without point amounts.

Both need no authentication.


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