API Reference

Halal (BPJPH)

Search halal supervisors/businesses from the BPJPH portal. On-demand: fetches upstream on cache miss, 24h TTL per keyword.

Main endpoint
GET https://use.apiindonesia.id/api/v1/halal
Endpoints
2
Authentication
x-api-key header (create one free in the dashboard)
Price
2 credits (Rp2) per successful request; failed requests are free
Format
JSON (REST), with cURL, JavaScript and Python examples
Product Brief

What this API gives you

Search halal supervisors/businesses from the BPJPH portal. On-demand: fetches upstream on cache miss, 24h TTL per keyword.

Coverage
2

ready-to-use endpoints in this product, with JSON responses and consistent error handling.

Access
API key

Can be tried with the 3,000 credit signup bonus, then used in production through one API Indonesia key.

Sample resource
https://use.apiindonesia.id/api/v1/halal

Search by business or supervisor name.

When should you use it?

The Halal API fits F&B marketplaces, food-discovery apps, retail, merchant fintech, and supplier audits that need to search halal supervisors or businesses from BPJPH.

Marketplaces want to show halal status for restaurants, brands, or products.

Merchant onboarding needs an initial signal before manual document verification.

Consumer apps need keyword-based search for halal businesses.

Because data is fetched on demand and cached, design the UI to show refresh time and empty-result states.

Example product scenarios

This section separates the product page from the docs. The docs explain how to call endpoints; this page explains why the endpoints make sense for your feature.

  • F&B e-commerce: display a product's halal certification badge/status to buyers.
  • Food-discovery apps: filter restaurant/product search by BPJPH halal status.
  • Fintech & retail: validate a merchant partner's halal status before onboarding.

Example Usage

Request
curl "https://use.apiindonesia.id/api/v1/halal?q=indomie&limit=10" \
  -H "x-api-key: YOUR_API_KEY"
Response · 200 OK
{
  "data": [{ "id_penyelia": "...", "company_name": "Dapoer indomie", "supervisor_name": "..." }],
  "meta": { "attribution": "Sumber: BPJPH", "refreshed": true, "cache_ttl_hours": 24 }
}

Related Articles

Pricing 2 credits (Rp2) per successful request; failed requests are free. One-time 3,000 credit signup bonus, no credit card, no monthly allowance.

Halal (BPJPH) API questions

Where does the halal data come from?

From the BPJPH portal. Data is fetched on demand on a cache miss and kept for 24 hours per keyword.

How do I search businesses or halal supervisors?

Use GET /api/v1/halal?q=... with an optional limit, then GET /api/v1/halal/{id} for supervisor details.

Does this replace official BPJPH verification?

No. It makes searching easier; for official decisions, refer to the BPJPH portal.

Get Started

Start Integrating
Today

Sign up for free and get a 3,000 credit bonus (Rp3,000) once your email is verified, grab an API key, and call your first endpoint right away. No credit card, no tedious approval process.

Dot wave visualization