API Cookbook

Practical implementation patterns for Bangladesh-focused apps.

Build cascading division, district, upazila selects

1Load /divisions once
2Call /districts?division_id=6 after division selection
3Call /upazilas?district_id=47 after district selection
4Call /unions?upazila_id=302 when union data is needed

const response = await fetch("https://bdapi4all.vercel.app/api/v1/districts?division_id=6&page=1&limit=20&fields=id%2Cname_en&sort=-name_en");
const payload = await response.json();
console.log(payload.data);

Show today prayer times for a selected district

GET /prayer-times

1Ask the user for district_id
2Call /prayer-times?district_id=47
3Cache the result in your UI for the day
4Render the Asia/Dhaka times as returned

const response = await fetch("https://bdapi4all.vercel.app/api/v1/prayer-times?district_id=47&lat=23.7115&lng=90.4111&date=2026-06-02");
const payload = await response.json();
console.log(payload.data);

Detect a mobile operator during signup

GET /mobile/operator

1Normalize user phone input
2Call /mobile/operator?number=01712345678
3Display the operator name beside the phone field
4Reject invalid numbers with the API error message

const response = await fetch("https://bdapi4all.vercel.app/api/v1/mobile/operator?number=01712345678");
const payload = await response.json();
console.log(payload.data);

Check whether a date is a public holiday

GET /holidays/{date}

1Format the date as YYYY-MM-DD
2Call /holidays/{date}
3Use is_holiday to disable bookings or show holiday details

const response = await fetch("https://bdapi4all.vercel.app/api/v1/holidays/2026-02-21");
const payload = await response.json();
console.log(payload.data);

Normalize Bengali numerals before form submit

GET /bn/to-english

1Pass localized input to /bn/to-english
2Store the converted field in your database
3Keep the original text if your app needs audit history

const response = await fetch("https://bdapi4all.vercel.app/api/v1/bn/to-english?text=%E0%A7%A8%E0%A7%A6%E0%A7%A8%E0%A7%AC");
const payload = await response.json();
console.log(payload.data);

Build one search box for Bangladesh facts

GET /search

1Send the user's text to /search?q=
2Show the category label with every result
3Open the matching /docs/{category} endpoint when users need full records

const response = await fetch("https://bdapi4all.vercel.app/api/v1/search?q=Padma&category=rivers&page=1&limit=20");
const payload = await response.json();
console.log(payload.data);

Show books and author pages

GET /books/search

1Use /books for the default list
2Use /books/search?q= when the user types a title
3Use /authors/{id}/books after the user opens an author

const response = await fetch("https://bdapi4all.vercel.app/api/v1/books/search?q=Bidrohi&page=1&limit=20");
const payload = await response.json();
console.log(payload.data);

Build district heritage pages

GET /historical-places/by-district

1Start with a district id or English district name
2Call /historical-places/by-district
3Render monuments, archaeological places, and source links

const response = await fetch("https://bdapi4all.vercel.app/api/v1/historical-places/by-district?district_id=47&district=Dhaka&page=1&limit=20");
const payload = await response.json();
console.log(payload.data);

Find regional foods

GET /foods/by-region

1Pass the region or district name
2Group results by category such as sweet, snack, rice, or curry
3Use source_url when a user wants attribution

const response = await fetch("https://bdapi4all.vercel.app/api/v1/foods/by-region?region=Dhaka&page=1&limit=20");
const payload = await response.json();
console.log(payload.data);

Import BDApi4All into Postman or Insomnia

GET /divisions

1Download /collections/postman.json or /collections/insomnia.json
2Import into your API client
3Run requests against the production base URL

const response = await fetch("https://bdapi4all.vercel.app/api/v1/divisions?page=1&limit=20&fields=id%2Cname_en&sort=-name_en");
const payload = await response.json();
console.log(payload.data);

Framework Examples

Copy-ready patterns for common frontend and backend stacks.

React

import { useEffect, useState } from "react";

export function DistrictSelect() {
  const [districts, setDistricts] = useState([]);

  useEffect(() => {
    fetch("https://bdapi4all.vercel.app/api/v1/districts?division_id=6")
      .then((res) => res.json())
      .then((payload) => setDistricts(payload.data));
  }, []);

  return (
    <select>
      {districts.map((district) => (
        <option key={district.id} value={district.id}>
          {district.name_en}
        </option>
      ))}
    </select>
  );
}

Next.js

export const metadata = { title: "API Cookbook" };

export default async function Page() {
  const res = await fetch("https://bdapi4all.vercel.app/api/v1/search?q=Padma", {
    next: { revalidate: 86400 },
  });
  const payload = await res.json();

  return <pre>{JSON.stringify(payload.data, null, 2)}</pre>;
}

Laravel

use Illuminate\Support\Facades\Http;

$response = Http::get('https://bdapi4all.vercel.app/api/v1/people/search', [
    'q' => 'Shakib',
    'limit' => 5,
]);

$people = $response->json('data');

Flutter

import 'dart:convert';
import 'package:http/http.dart' as http;

Future<List<dynamic>> loadBooks() async {
  final uri = Uri.parse('https://bdapi4all.vercel.app/api/v1/books?limit=20');
  final response = await http.get(uri);
  final payload = jsonDecode(response.body) as Map<String, dynamic>;
  return payload['data'] as List<dynamic>;
}

const response = await fetch("https://bdapi4all.vercel.app/api/v1/districts?division_id=6&page=1&limit=20&fields=id%2Cname_en&sort=-name_en"); const payload = await response.json(); console.log(payload.data);

const response = await fetch("https://bdapi4all.vercel.app/api/v1/prayer-times?district_id=47&lat=23.7115&lng=90.4111&date=2026-06-02"); const payload = await response.json(); console.log(payload.data);

const response = await fetch("https://bdapi4all.vercel.app/api/v1/historical-places/by-district?district_id=47&district=Dhaka&page=1&limit=20"); const payload = await response.json(); console.log(payload.data);

import { useEffect, useState } from "react"; export function DistrictSelect() { const [districts, setDistricts] = useState([]); useEffect(() => { fetch("https://bdapi4all.vercel.app/api/v1/districts?division_id=6") .then((res) => res.json()) .then((payload) => setDistricts(payload.data)); }, []); return ( <select> {districts.map((district) => ( <option key={district.id} value={district.id}> {district.name_en} </option> ))} </select> ); }

export const metadata = { title: "API Cookbook" }; export default async function Page() { const res = await fetch("https://bdapi4all.vercel.app/api/v1/search?q=Padma", { next: { revalidate: 86400 }, }); const payload = await res.json(); return <pre>{JSON.stringify(payload.data, null, 2)}</pre>; }

import 'dart:convert'; import 'package:http/http.dart' as http; Future<List<dynamic>> loadBooks() async { final uri = Uri.parse('https://bdapi4all.vercel.app/api/v1/books?limit=20'); final response = await http.get(uri); final payload = jsonDecode(response.body) as Map<String, dynamic>; return payload['data'] as List<dynamic>; }