Navigation

API Documentation

Overview

The Adentity API provides powerful email intelligence capabilities including dehashing SHA256 and MD5 email hashes, bulk processing, and email enrichment. Our API is RESTful, uses JSON for requests and responses, and supports both individual and batch operations.

Base URL: https://adentity.ai

Authentication

Most API requests require authentication using a valid API key. Include your API key in the Authorization header as a Bearer token. 

Authorization: Bearer YOUR_API_KEY
Note: You can obtain your API key from your dashboard after creating an account.

Single Email Dehash

Dehash a single email address with optional enrichment data.

GET /api/dehash/single/

Query Parameters

Parameter Type Required Description
hash string Required The email hash to dehash
hash_type string Required Hash type: "sha256" or "md5"
is_enrich boolean Optional Include enrichment data (default: false)

Example Request

cURL 
curl -X GET "https://api.adentity.com/api/dehash/single/?hash=806d979132ba82617bf7b6a18faae89321ece96052c5f17d712a1196cbbc4401&hash_type=sha256&is_enrich=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON 
{
  "status": "success",
  "results": {
    "email": "john.doe@company.com",
    "hash": "806d979132ba82617bf7b6a18faae89321ece96052c5f17d712a1196cbbc4401",
    "is_dehashed": true,
    "is_enriched": true,
    "first_name": "John",
    "last_name": "Doe",
    "gender": "male",
    "country_code": "US",
    "region": "California",
    "address": "123 Tech Street, San Francisco",
    "postal_code": "94105",
    "phone_numbers": "+1-555-0123",
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "twitter_url": "https://twitter.com/johndoe",
    "facebook_url": "https://facebook.com/john.doe",
    "additional_emails": "john.doe.personal@gmail.com"
  }
}

Bulk Email Dehash

Dehash multiple email addresses in a single request.

POST /api/dehash/bulk/

Request Body

Parameter Type Required Description
hashes array Required Array of hash strings to dehash
hash_type string Required Hash type for all hashes: "sha256" or "md5"
is_enrich boolean Optional Include enrichment data (default: false)

Example Request

cURL 
curl -X POST "https://api.adentity.com/api/dehash/bulk/" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hashes": [
      "806d979132ba82617bf7b6a18faae89321ece96052c5f17d712a1196cbbc4401",
      "5d41402abc4b2a76b9719d911017c592",
      "invalid_hash_example"
    ],
    "hash_type": "sha256",
    "is_enrich": true
  }'

Example Response

JSON 
{
  "status": "success",
  "results": [
    {
      "email": "john.doe@company.com",
      "hash": "806d979132ba82617bf7b6a18faae89321ece96052c5f17d712a1196cbbc4401",
      "is_dehashed": true,
      "is_enriched": true,
      "first_name": "John",
      "last_name": "Doe",
      "gender": "male",
      "country_code": "US",
      "region": "California",
      "address": "123 Tech Street, San Francisco",
      "postal_code": "94105",
      "phone_numbers": "+1-555-0123",
      "linkedin_url": "https://linkedin.com/in/johndoe",
      "twitter_url": "https://twitter.com/johndoe",
      "facebook_url": "https://facebook.com/john.doe",
      "additional_emails": "john.doe.personal@gmail.com"
    },
    {
      "email": "jane.smith@tech.io",
      "hash": "5d41402abc4b2a76b9719d911017c592",
      "is_dehashed": true,
      "is_enriched": true,
      "first_name": "Jane",
      "last_name": "Smith",
      "gender": "female",
      "country_code": "CA",
      "region": "Ontario",
      "address": "456 Innovation Drive, Toronto",
      "postal_code": "M5V 3A8",
      "phone_numbers": "+1-416-555-0456",
      "linkedin_url": "https://linkedin.com/in/janesmith",
      "twitter_url": "https://twitter.com/jane_smith",
      "facebook_url": null,
      "additional_emails": null
    },
    {
      "email": null,
      "hash": "invalid_hash_example",
      "is_dehashed": false,
      "is_enriched": false,
      "first_name": null,
      "last_name": null,
      "gender": null,
      "country_code": null,
      "region": null,
      "postal_code": null,
      "address": null,
      "phone_numbers": null,
      "linkedin_url": null,
      "twitter_url": null,
      "facebook_url": null,
      "additional_emails": null
    }
  ]
}

Error Handling

The API uses conventional HTTP response codes to indicate success or failure.

Status Code Description
200 Success
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid API key
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error

Error Response Format

{
  "status": "error",
  "message": "Hash type must be 'sha256' or 'md5'"
}