> ## 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.

# Loice API

> 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, resolving a company page, and running lead searches in the background.

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

<CardGroup cols={2}>
  <Card title="Authenticate" icon="key" href="/authentication">
    Create a workspace API key and send it as a bearer token.
  </Card>

  <Card title="Handle errors" icon="triangle-exclamation" href="/errors">
    One error shape, with a machine-readable code to branch on.
  </Card>

  <Card title="Understand billing" icon="coins" href="/billing">
    What is billed, when, and where to see the current costs.
  </Card>

  <Card title="Browse the reference" icon="code" href="/api-reference/find-and-verify-contact-data">
    Every operation, its parameters, responses and examples.
  </Card>
</CardGroup>

## 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.