9ja Checkr API

Overview

Lookups use the same public NAFDAC registration channel the site automates; responses may be served from our cache after the first fetch. All successful responses are JSON with an ok field.

All requests go to: https://api.9jacheckr.xyz

Authentication

Send your API key on every request as the x-api-keyheader (same as in the dashboard "Example request" snippet).

x-api-key: YOUR_API_KEY

Quick start

Create a key under API Keys, then run (replace YOUR_API_KEY):

curl -sS "https://api.9jacheckr.xyz/api/verify/01-5713" \
  -H "x-api-key: YOUR_API_KEY"

{
  "ok": true,
  "product": {
    "nafdac": "01-5713",
    "name": "Example product name",
    "category": "Food",
    "source": "nafdac-registration",
    "manufacturer": "Example manufacturer",
    "approvedDate": "2019-04-01T00: 00: 00.000Z",
    "expiryDate": "2024-04-01T00: 00: 00.000Z",
    "ingredients": []
  }
}

{
  "ok": false,
  "code": "NOT_FOUND",
  "message": "Product not found for this NAFDAC number",
  "nafdac": "99-9999"
}

JavaScript SDK

Official @9jacheckr/sdk wraps the same REST endpoints with typed results. Uses global fetch (Node 18+). The client always talks to https://api.9jacheckr.xyz — for a local API, use the HTTP examples above.

npm install @9jacheckr/sdk

All methods return a Promise that resolves (no throw for API/network errors). Branch on result.ok. Per-request timeout is about 25 seconds.

CheckrClient

import { CheckrClient } from '@9jacheckr/sdk';

const client = new CheckrClient({
  apiKey: process.env.CHECKR_API_KEY!,
});

const result = await client.verify('01-5713');

if (result.ok) {
  console.log(result.product.name, result.product.manufacturer);
} else {
  console.error(result.code, result.message);
}

const batch = await client.verifyBatch(['01-5713', '04-8127']);

if (batch.ok) {
  for (const row of batch.results) {
    if (row.ok) console.log(row.nafdac, row.product.name);
    else console.log(row.nafdac, row.code, row.message);
  }
} else {
  console.error(batch.code, batch.message);
}

const search = await client.searchProducts('sardine', {
  limit: 10,
});

if (search.ok) {
  for (const hit of search.results) {
    console.log(hit.nafdac, hit.name, hit.manufacturer);
  }
} else {
  console.error(search.code, search.message);
}

Exported types include Product, VerifyResult, BatchVerifyResult, SearchResult, and row/hit types. Extra SDK-only code values include INVALID_RESPONSE, TIMEOUT, and NETWORK_ERROR.

Rate limits

Two layers: a monthly usage cap per account (Free vs API Pro) and a sliding-window limiter on verify, batch, and search routes. Over the monthly cap you get 429 with PLAN_QUOTA_EXCEEDED. Over the window limit you get 429 with RATE_LIMITED.

Successful responses may include RateLimit-* style headers from the sliding limiter (draft standard). Monthly remaining usage is shown in your dashboard, not only in response headers.

Error codes

All errors follow a consistent shape. The HTTP status indicates the category; the code field is machine-readable.

{
  "ok": false,
  "code": "NOT_FOUND",
  "message": "Product not found for this NAFDAC number",
  "nafdac": "99-9999"
}

Code examples

const url = `https://api.9jacheckr.xyz/api/verify/` + encodeURIComponent("01-5713");
const response = await fetch(url, {
  headers: { "x-api-key": "YOUR_API_KEY" },
});

const data = await response.json();

if (data.ok && data.product) {
  console.log(data.product.name);
}

import urllib.parse
import requests

nafdac = urllib.parse.quote("01-5713", safe="")
r = requests.get(
    f"https://api.9jacheckr.xyz/api/verify/{nafdac}",
    headers={"x-api-key": "YOUR_API_KEY"},
    timeout=30,
)
data = r.json()
if data.get("ok") and data.get("product"):
    print(data["product"]["name"])

const API_KEY = process.env.CHECKR_API_KEY!;
const BASE = "https://api.9jacheckr.xyz";

export type Product = {
  nafdac: string;
  name: string;
  category: string;
  source: string;
  manufacturer: string;
  approvedDate: string | null;
  expiryDate: string | null;
  ingredients: string[];
};

export type VerifySuccess = { ok: true; product: Product };
export type VerifyError = {
  ok: false;
  code: string;
  message: string;
  nafdac?: string;
};

export async function verifyNafdac(
  nafdac: string,
): Promise<VerifySuccess | VerifyError> {
  const path = encodeURIComponent(nafdac);
  const res = await fetch(`${BASE}/api/verify/${path}`, {
    headers: { "x-api-key": API_KEY },
  });
  return res.json() as Promise<VerifySuccess | VerifyError>;
}

Upgrade to Pro

Need more than 300 lookups per month, multiple keys, batch verify, or product search? Upgrade to API Pro from your dashboard. Billed at ₦10,000/month. Photo verify stays on Telegram Bot Pro only.