HanDl API Documentation

Build on top of HanDl. Send messages, manage orders, sync products, and handle payments — all through a simple REST API.

Base URL

https://api.handl-ng.com/v1

All API requests are made to this base URL. Responses are returned as JSON. All timestamps are in ISO 8601 format (UTC).

Quick Start

Here's the fastest path from zero to your first API call:

1. Get your API key

Go to Settings → API in your dashboard to create a secret key. Keep it safe — secret keys can access your entire account.

2. Make your first request

Try listing your products:

curl https://api.handl-ng.com/v1/products \
  -H "Authorization: Bearer sk_live_your_secret_key" \
  -H "Content-Type: application/json"

const res = await fetch('https://api.handl-ng.com/v1/products', {
  headers: {
    'Authorization': 'Bearer sk_live_your_secret_key',
    'Content-Type': 'application/json',
  },
});

const { data } = await res.json();
console.log(data); // [{ id: "prod_abc", name: "Jollof Rice", ... }]

3. Explore the resources

The API is organized around core resources that mirror your HanDl dashboard:

SDKs & Libraries

Official SDKs are coming soon. In the meantime, the API works great with any HTTP client — fetch, axios, requests, or curl.