Find hashed emails

curl --request POST \
  --url https://api.airscale.io/v1/hashed-emails \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedin_url": "https://www.linkedin.com/in/jane-doe-example"
}
'

{
  "status": "success",
  "linkedin_url": "https://www.linkedin.com/in/jane-doe-example",
  "hashed_email": "86e0b9e56c17cc4d12387e1949b85053fbe73bc3ce5a1188713a9d300cc6133d",
  "hashed_emails": [
    {
      "normalized_hash": "86e0b9e56c17cc4d12387e1949b85053fbe73bc3ce5a1188713a9d300cc6133d",
      "original_hash": "86e0b9e56c17cc4d12387e1949b85053fbe73bc3ce5a1188713a9d300cc6133d"
    },
    {
      "normalized_hash": "b8cadecdc8dec603ab820de2f80614db594e5ba9a6d19908c35e3e17f67faac3",
      "original_hash": "b8cadecdc8dec603ab820de2f80614db594e5ba9a6d19908c35e3e17f67faac3"
    }
  ],
  "hash_algorithm": "sha256",
  "credits_used": 5,
  "credits_remaining": 995
}

{
  "error": "<string>",
  "code": "invalid_input"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "status": "not_found",
  "work_email": "jane.doe@example.com",
  "hashed_email": null,
  "hashed_emails": [],
  "credits_used": 0
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "invalid_input"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

POST

hashed-emails

curl --request POST \
  --url https://api.airscale.io/v1/hashed-emails \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedin_url": "https://www.linkedin.com/in/jane-doe-example"
}
'

{
  "status": "success",
  "linkedin_url": "https://www.linkedin.com/in/jane-doe-example",
  "hashed_email": "86e0b9e56c17cc4d12387e1949b85053fbe73bc3ce5a1188713a9d300cc6133d",
  "hashed_emails": [
    {
      "normalized_hash": "86e0b9e56c17cc4d12387e1949b85053fbe73bc3ce5a1188713a9d300cc6133d",
      "original_hash": "86e0b9e56c17cc4d12387e1949b85053fbe73bc3ce5a1188713a9d300cc6133d"
    },
    {
      "normalized_hash": "b8cadecdc8dec603ab820de2f80614db594e5ba9a6d19908c35e3e17f67faac3",
      "original_hash": "b8cadecdc8dec603ab820de2f80614db594e5ba9a6d19908c35e3e17f67faac3"
    }
  ],
  "hash_algorithm": "sha256",
  "credits_used": 5,
  "credits_remaining": 995
}

{
  "error": "<string>",
  "code": "invalid_input"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "status": "not_found",
  "work_email": "jane.doe@example.com",
  "hashed_email": null,
  "hashed_emails": [],
  "credits_used": 0
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "invalid_input"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "code": "<string>"
}

Send a LinkedIn profile URL, a work email, or both. The operation returns the person’s emails as SHA-256 hashes, ready to upload to Meta, Google, LinkedIn or TikTok as a customer list or matched audience. Raw email addresses are never returned.

A lookup costs 5 credits when at least one hashed email is found. Not found, validation failures, and lookup failures are not charged. The limit is 60 requests per rolling second per workspace.

Send a person

Field	Format
`linkedin_url`	A LinkedIn profile URL such as `https://www.linkedin.com/in/jane-doe-example`. Country subdomains, a missing `https://`, query strings and a trailing slash are accepted. Company pages are rejected.
`work_email`	The person’s work email. It is trimmed and lowercased.

At least one field is required. When both are sent, both are used to find the person. Any other body field returns 400 with code: "invalid_input".

Read a successful result

Field	Meaning
`status`	`success` when at least one hashed email was found.
`linkedin_url` / `work_email`	The normalized inputs that were looked up.
`hashed_email`	The best-matching hash. Use it when you need one value per person.
`hashed_emails`	Every hashed email found, best match first. Each entry has `normalized_hash` (use this for ad uploads) and `original_hash`.
`hash_algorithm`	Always `sha256`.
`credits_used`	Always `5`.
`credits_remaining`	Remaining workspace credit balance.

normalized_hash is the SHA-256 of the trimmed, lowercased email, which is the format ad platforms expect for hashed customer lists.

Errors and retries

Status	Meaning	Charged
`400`	Invalid JSON, a body that is not an object, or an unsupported field.	No
`401`	Missing or invalid API key.	No
`403`	Insufficient credits. At least 5 credits are required before a lookup starts.	No
`404`	`status: "not_found"`: no hashed email was found for this person.	No
`413`	JSON body larger than 16 KiB.	No
`422`	`code: "invalid_input"`: no field sent, a LinkedIn URL that is not a profile URL, or an invalid email.	No
`429`	Workspace rate limit exceeded.	No
`502`	The lookup failed or returned an invalid result.	No
`503`	A service the lookup depends on is temporarily unavailable.	No result is returned
`504`	The lookup timed out.	No

Correct the input before retrying a 400 or 422. After 429, retry in a later second. For temporary 502, 503 or 504 responses, retry with increasing delays and a fixed retry limit.

In the Airscale app

The same lookup is available as the Find hashed emails enrichment in your tables (Enrich & clean, under Enrich contact data). It costs 5 credits per row when a hash is found; the cell shows the best-matching hash and keeps every hash in its details.

Next step

Review Authentication and rate limits before sending lookups in bulk.

Authorizations

Authorization

string

header

required

Use an Airscale workspace API key. Never expose the key in client-side code.

Body

application/json

Send linkedin_url, work_email, or both; at least one is required. Any other field returns 400.

linkedin_url

string | null

LinkedIn profile URL (linkedin.com/in/...). Company pages are rejected.

Maximum string length: 512

work_email

string | null

Work email address of the person.

Maximum string length: 254

Response

At least one hashed email was found. Costs 5 credits.

status

string

required

Allowed value: "success"

hashed_email

string

required

Best-ranked normalized hash. Same as hashed_emails[0].normalized_hash.

Pattern: ^[a-f0-9]{64}$

hashed_emails

object[]

required

Every hashed email found for the person, best match first.

Minimum array length: 1

Show child attributes

hash_algorithm

string

required

Allowed value: "sha256"

credits_used

number

required

credits_remaining

number | null

required

Remaining workspace credit balance after the charge.

linkedin_url

string

The normalized LinkedIn profile URL that was looked up, when one was sent.

work_email

string

The normalized (lowercased) work email that was looked up, when one was sent.

Start here

Account

Search and discovery

Contact data

Profiles and reverse lookup

Post engagement

Intent signals

Miscellaneous

Table API

Find hashed emails

Send a person

Read a successful result

Errors and retries

In the Airscale app

Next step

Authorizations

Body

Response

​Send a person

​Read a successful result

​Errors and retries

​In the Airscale app

​Next step

Authorizations

Body

Response

Send a person

Read a successful result

Errors and retries

In the Airscale app

Next step