Skip to main content
This guide sends one request to the Hanto API and handles the two normal outcomes: found and not_found.

Prerequisites

Before you begin, you need:
  • Access to a Hanto workspace.
  • An active Hanto API key.

Send your first request

1

Create an API key

Sign in to Hanto, open API keys, and create a key for your integration.Copy the key when it is shown. Hanto shows the plaintext key only once.
2

Call the enrich endpoint

curl https://api.hanto.ai/api/v1/person/enrich \
  -H "Authorization: Bearer sk_live_REPLACE_WITH_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"person@gmail.com"}'
3

Read the result

A found response returns a 200 status and a LinkedIn profile URL.
{
  "lookup_id": "lookup_2F0knGH5CSqVAveuPlyCelx1",
  "status": "found",
  "profile": {
    "linkedin_url": "https://www.linkedin.com/in/person"
  }
}
A no-match response returns a 404 status and no profile object.
{
  "lookup_id": "lookup_XbVW9yUdTzakGWNmZheBHvuV",
  "status": "not_found"
}

Next steps