Documentation

Decode Hash API Reference

Resolve phone number hashes to verified Kenyan mobile numbers. Our API provides sub-2ms lookups with carrier identification across all major East African networks.

Overview

The Decode Hash API allows you to look up phone number information from SHA-256 hashes. Send a hash, get back the verified phone number and carrier details. It is that simple.

The API supports both single lookups and batch operations (up to 100 hashes at once), making it suitable for both real-time and bulk processing workflows.

Base URL

https://api.decode.cowdi.co/v1

All API requests should be made to this base URL. The API accepts and returns JSON. All requests must include your API key in the X-API-Key header.

Quick Start

Make your first API call in seconds. Replace sk_live_xxx with your actual API key.

Request

curl -X POST https://api.decode.cowdi.co/v1/lookup \
-H   "Content-Type: application/json" \
-H   "X-API-Key: sk_live_xxx" \
-d   '{"hash": "9a880505fc5c7953ad6770d71055719bc9f00d963c815207a1a657402d5b7a54"}'

Response200 OK

{
  "phone": "+254746604674",
  "carrier": "Safaricom",
  "lookup_time_ms": 1.2
}

Next Steps

Authentication

Learn how to authenticate your API requests with API keys.

Single Lookup

Look up a phone number from a single SHA-256 hash.

Batch Lookup

Resolve up to 100 hashes in a single request.

Error Handling

Understand error responses and how to handle them.