শুধুমাত্র GET মেথড। key query প্যারামিটারে API Key, সঙ্গে nid ও dob পাঠালে যেকোনো API থেকে একই CRD-GR রেসপন্স পাবেন। অতিরিক্ত কোনো হেডার লাগবে না। সফল কলে চার্জ হবে; ব্যর্থ কলে কোনো চার্জ হবে না।
API Key query string-এ
প্রতিটি রিকোয়েস্টের URL-এ key=YOUR_API_KEY প্যারামিটার দিন। কোনো অতিরিক্ত হেডার প্রয়োজন নেই।
শুধুমাত্র GET
https://sunnah-api.top/api/v1/query.php
সব সার্ভিসেই service, key এবং সার্ভিস অনুযায়ী nid ও dob প্যারামিটার আবশ্যক।
সব প্যারামিটার query string-এ
সব প্যারামিটার URL-encoded query string হিসেবে যাবে; কোনো অতিরিক্ত হেডার বা request body লাগবে না।
Canonical envelope
{
"code": 200,
"success": true,
"data": {
"owner": "SUNNAH API",
"name": "খোকন মিয়া",
"nameEn": "Khokon Mia",
"nationalId": "8211097855",
"pin": "19828613659556132",
"oldnid": "8613659556132",
"smartnid": "8211097855",
"voterNumber": "860392000338",
"voterAreaNo": "860392",
"slNo": "398",
"father": "খালেক হাওলাদার",
"mother": "বেগম",
"spouseName": "",
"dob": "1982-08-02",
"dateOfbirth": "1982-08-02",
"dateOfBirth": "1982-08-02",
"age": "৪৪ বছর, ৩ মাস, ১ দিন",
"birthDay": "সোমবার",
"gender": "পুরুষ",
"genderEn": "Male",
"religion": "Islam",
"religionEn": "Islam",
"bloodGroup": "",
"birthPlace": "শরিয়তপুর",
"occupation": "শ্রমিক",
"education": "",
"voterArea": "লাকাচুয়া (২ নং ওয়ার্ড অংশ)",
"photo": "https://sunnah-api.top/photo/8211097855_47f42a5ba6.jpg",
"sign": "",
"dateOfToday": "",
"address": "লাকাচুয়া, গোসাইরহাট, শরিয়তপুর",
"presentAddress": {
"division": "চট্টগ্রাম",
"district": "শরিয়তপুর",
"upazilla": "গোসাইরহাট",
"postoffice": "গোসাইরহাট",
"postCode": "",
"unionOrWard": "সামন্তসার",
"mouzaOrMoholla": "",
"villageOrRoad": "লাকাচুয়া (২ নং ওয়ার্ড অংশ)",
"additionalVillageOrRoad": "লাকাচুয়া",
"houseOrHoldingNo": "",
"ward": "২",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": "গ্রাম/রাস্তা: লাকাচুয়া (২ নং ওয়ার্ড অংশ), অতিরিক্ত গ্রাম/রাস্তা: লাকাচুয়া, ওয়ার্ড: ২, ইউনিয়ন: সামন্তসার, পোস্ট অফিস: গোসাইরহাট, উপজেলা: গোসাইরহাট, জেলা: শরিয়তপুর, বিভাগ: চট্টগ্রাম"
},
"permanentAddress": {
"division": "চট্টগ্রাম",
"district": "শরিয়তপুর",
"upazilla": "গোসাইরহাট",
"postoffice": "গোসাইরহাট",
"postCode": "",
"unionOrWard": "সামন্তসার",
"mouzaOrMoholla": "",
"villageOrRoad": "লাকাচুয়া (২ নং ওয়ার্ড অংশ)",
"additionalVillageOrRoad": "লাকাচুয়া",
"houseOrHoldingNo": "",
"ward": "২ নং ওয়ার্ড",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": "গ্রাম/রাস্তা: লাকাচুয়া (২ নং ওয়ার্ড অংশ), অতিরিক্ত গ্রাম/রাস্তা: লাকাচুয়া, ওয়ার্ড: ২ নং ওয়ার্ড, ইউনিয়ন: সামন্তসার, পোস্ট অফিস: গোসাইরহাট, উপজেলা: গোসাইরহাট, জেলা: শরিয়তপুর, বিভাগ: চট্টগ্রাম"
}
}
}code — সফল কলে 200।success — সফল কলে true।data.owner — সবসময় SUNNAH API।data.photo — আমাদের সাইটে সেভ করা লোকাল ছবির URL।HTTP status + machine-readable body
{
"code": 422,
"success": false,
"data": null,
"message": "nid নম্বর আবশ্যক।",
"requestId": "CRD-261029-ABCDEF1234"
}| HTTP | অর্থ |
|---|---|
| 401 | UNAUTHORIZEDAPI Key নেই, query string-এ key দেওয়া হয়নি অথবা Key সঠিক নয়। |
| 402 | INSUFFICIENT_BALANCEব্যালেন্স অপর্যাপ্ত; ডেটা সোর্সে কল হয় না। |
| 404 | SERVICE_NOT_FOUNDservice slug পাওয়া যায়নি। |
| 405 | METHOD_NOT_ALLOWEDGET ছাড়া অন্য মেথড। |
| 409 | SERVICE_INACTIVEAPI সার্ভিস বন্ধ আছে। |
| 422 | VALIDATION_ERRORইনপুট প্যারামিটার সঠিক নয়। |
| 429 | RATE_LIMITEDপ্রতি মিনিটের রিকোয়েস্ট সীমা শেষ। |
| 503 | UPSTREAM_ERRORডেটা সোর্স ব্যর্থ, সময় শেষ বা ভুল রেসপন্স। |
শুধু সফল ডেটা রেসপন্সে চার্জ
X-Request-Id, X-Charged, X-Balance, X-Cacheতিন ধাপে প্রথম কল
রেজিস্টার করে API Key পেজ থেকে Key নিন।
নিচের সার্ভিস তালিকা থেকে service slug এবং ইনপুট field দেখুন।
শুধুমাত্র GET দিয়ে কল করুন; URL-এ key, nid ও dob দিন। সফল হলে ব্যালেন্স থেকে ফি কাটবে।
4টি সক্রিয় API
সব API-তে একই ফরম্যাট
প্রিসেট বা নতুন যেকোনো NID API-এর সোর্স রেসপন্স আলাদা হলেও আপনার অ্যাপ্লিকেশন সবসময় একই CRD-GR ফরম্যাট পাবে। Main API-তে যে field আছে সেটি বসবে, বাকিটি ফাঁকা থাকবে। ছবি আমাদের সার্ভারে সেভ হয় এবং প্রতিটি ইউজারের জন্য nid + dob ভিত্তিক ক্যাশ থাকে।
প্রতিটি সার্ভিসের request fields, response mapping এবং GET উদাহরণ।
nid-api-1 · ৳35.00 / সফল কল
NID ও জন্মতারিখ দিয়ে NID তথ্য যাচাই। SUNNAH আপস্ট্রিম ব্যবহার করে নাম, পিন, ঠিকানা, ছবি ও পারিবারিক তথ্য এক রেসপন্সে দেয়।
| Field | Type | Required | Rule |
|---|---|---|---|
| nidNID নম্বর | text | হ্যাঁ | ১০–১৭ ডিজিটের NID নম্বর। আপস্ট্রিমে nid হিসেবে পাঠানো হয়। |
| dobজন্মতারিখ (DOB) | text | হ্যাঁ | YYYY-MM-DD ফরম্যাটে জন্মতারিখ। আপস্ট্রিমে dob হিসেবে পাঠানো হয়। |
| Output | সোর্স পাথ | Missing default |
|---|---|---|
| owner | স্বয়ংক্রিয় | "SUNNAH API" |
| name, nameEn, nationalId, pin | unified identity | "" |
| oldnid, smartnid, dob | unified identity | "" |
| father, mother, age, birthDay | unified identity | "" |
| photo, address | লোকাল ছবি + কমপ্যাক্ট ঠিকানা | "" |
| presentAddress, permanentAddress | address object | {} |
https://sunnah-api.top/api/v1/query.php?service=nid-api-1&key=YOUR_API_KEY&nid=8211097855&dob=1982-08-02
{
"code": 200,
"success": true,
"data": {
"owner": "SUNNAH API",
"name": "খোকন মিয়া",
"nameEn": "Khokon Mia",
"nationalId": "8211097855",
"pin": "19828613659556132",
"oldnid": "8613659556132",
"smartnid": "8211097855",
"voterNumber": "860392000338",
"voterAreaNo": "860392",
"slNo": "398",
"father": "খালেক হাওলাদার",
"mother": "বেগম",
"spouseName": "",
"dob": "1982-08-02",
"dateOfbirth": "1982-08-02",
"dateOfBirth": "1982-08-02",
"age": "৪৪ বছর, ৩ মাস, ১ দিন",
"birthDay": "সোমবার",
"gender": "পুরুষ",
"genderEn": "Male",
"religion": "Islam",
"religionEn": "Islam",
"bloodGroup": "",
"birthPlace": "শরিয়তপুর",
"occupation": "শ্রমিক",
"education": "",
"voterArea": "লাকাচুয়া (২ নং ওয়ার্ড অংশ)",
"photo": "https://sunnah-api.top/photo/8211097855_47f42a5ba6.jpg",
"sign": "",
"dateOfToday": "",
"address": "লাকাচুয়া, গোসাইরহাট, শরিয়তপুর",
"presentAddress": {
"division": "চট্টগ্রাম",
"district": "শরিয়তপুর",
"upazilla": "গোসাইরহাট",
"postoffice": "গোসাইরহাট",
"postCode": "",
"unionOrWard": "সামন্তসার",
"mouzaOrMoholla": "",
"villageOrRoad": "লাকাচুয়া (২ নং ওয়ার্ড অংশ)",
"additionalVillageOrRoad": "লাকাচুয়া",
"houseOrHoldingNo": "",
"ward": "২",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": "গ্রাম/রাস্তা: লাকাচুয়া (২ নং ওয়ার্ড অংশ), অতিরিক্ত গ্রাম/রাস্তা: লাকাচুয়া, ওয়ার্ড: ২, ইউনিয়ন: সামন্তসার, পোস্ট অফিস: গোসাইরহাট, উপজেলা: গোসাইরহাট, জেলা: শরিয়তপুর, বিভাগ: চট্টগ্রাম"
},
"permanentAddress": {
"division": "চট্টগ্রাম",
"district": "শরিয়তপুর",
"upazilla": "গোসাইরহাট",
"postoffice": "গোসাইরহাট",
"postCode": "",
"unionOrWard": "সামন্তসার",
"mouzaOrMoholla": "",
"villageOrRoad": "লাকাচুয়া (২ নং ওয়ার্ড অংশ)",
"additionalVillageOrRoad": "লাকাচুয়া",
"houseOrHoldingNo": "",
"ward": "২ নং ওয়ার্ড",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": "গ্রাম/রাস্তা: লাকাচুয়া (২ নং ওয়ার্ড অংশ), অতিরিক্ত গ্রাম/রাস্তা: লাকাচুয়া, ওয়ার্ড: ২ নং ওয়ার্ড, ইউনিয়ন: সামন্তসার, পোস্ট অফিস: গোসাইরহাট, উপজেলা: গোসাইরহাট, জেলা: শরিয়তপুর, বিভাগ: চট্টগ্রাম"
}
}
}nid-api-2 · ৳18.00 / সফল কল
NID ও জন্মতারিখ দিয়ে NID তথ্য যাচাই। AllApiService আপস্ট্রিম ব্যবহার করে নাম, ঠিকানা, বয়স, পিতা-মাতা ও ছবি এক রেসপন্সে দেয়।
| Field | Type | Required | Rule |
|---|---|---|---|
| nidNID নম্বর | text | হ্যাঁ | ১০–১৭ ডিজিটের NID নম্বর। আপস্ট্রিমে nid হিসেবে পাঠানো হয়। |
| dobজন্মতারিখ (DOB) | text | হ্যাঁ | YYYY-MM-DD ফরম্যাটে জন্মতারিখ। আপস্ট্রিমে dob হিসেবে পাঠানো হয়। |
| Output | সোর্স পাথ | Missing default |
|---|---|---|
| owner | স্বয়ংক্রিয় | "SUNNAH API" |
| name, nameEn, nationalId, pin | unified identity | "" |
| oldnid, smartnid, dob | unified identity | "" |
| father, mother, age, birthDay | unified identity | "" |
| photo, address | লোকাল ছবি + কমপ্যাক্ট ঠিকানা | "" |
| presentAddress, permanentAddress | address object | {} |
https://sunnah-api.top/api/v1/query.php?service=nid-api-2&key=YOUR_API_KEY&nid=8211097855&dob=1982-08-02
{
"code": 200,
"success": true,
"data": {
"owner": "SUNNAH API",
"name": "খোকন মিয়া",
"nameEn": "Khokon Mia",
"nationalId": "8211097855",
"pin": "19828613659556132",
"oldnid": "8613659556132",
"smartnid": "8211097855",
"voterNumber": "860392000338",
"voterAreaNo": "860392",
"slNo": "398",
"father": "খালেক হাওলাদার",
"mother": "বেগম",
"spouseName": "",
"dob": "1982-08-02",
"dateOfbirth": "1982-08-02",
"dateOfBirth": "1982-08-02",
"age": "৪৪ বছর, ৩ মাস, ১ দিন",
"birthDay": "সোমবার",
"gender": "পুরুষ",
"genderEn": "Male",
"religion": "Islam",
"religionEn": "Islam",
"bloodGroup": "",
"birthPlace": "শরিয়তপুর",
"occupation": "শ্রমিক",
"education": "",
"voterArea": "লাকাচুয়া (২ নং ওয়ার্ড অংশ)",
"photo": "https://sunnah-api.top/photo/8211097855_47f42a5ba6.jpg",
"sign": "",
"dateOfToday": "",
"address": "লাকাচুয়া, গোসাইরহাট, শরিয়তপুর",
"presentAddress": {
"division": "চট্টগ্রাম",
"district": "শরিয়তপুর",
"upazilla": "গোসাইরহাট",
"postoffice": "গোসাইরহাট",
"postCode": "",
"unionOrWard": "সামন্তসার",
"mouzaOrMoholla": "",
"villageOrRoad": "লাকাচুয়া (২ নং ওয়ার্ড অংশ)",
"additionalVillageOrRoad": "লাকাচুয়া",
"houseOrHoldingNo": "",
"ward": "২",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": "গ্রাম/রাস্তা: লাকাচুয়া (২ নং ওয়ার্ড অংশ), অতিরিক্ত গ্রাম/রাস্তা: লাকাচুয়া, ওয়ার্ড: ২, ইউনিয়ন: সামন্তসার, পোস্ট অফিস: গোসাইরহাট, উপজেলা: গোসাইরহাট, জেলা: শরিয়তপুর, বিভাগ: চট্টগ্রাম"
},
"permanentAddress": {
"division": "চট্টগ্রাম",
"district": "শরিয়তপুর",
"upazilla": "গোসাইরহাট",
"postoffice": "গোসাইরহাট",
"postCode": "",
"unionOrWard": "সামন্তসার",
"mouzaOrMoholla": "",
"villageOrRoad": "লাকাচুয়া (২ নং ওয়ার্ড অংশ)",
"additionalVillageOrRoad": "লাকাচুয়া",
"houseOrHoldingNo": "",
"ward": "২ নং ওয়ার্ড",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": "গ্রাম/রাস্তা: লাকাচুয়া (২ নং ওয়ার্ড অংশ), অতিরিক্ত গ্রাম/রাস্তা: লাকাচুয়া, ওয়ার্ড: ২ নং ওয়ার্ড, ইউনিয়ন: সামন্তসার, পোস্ট অফিস: গোসাইরহাট, উপজেলা: গোসাইরহাট, জেলা: শরিয়তপুর, বিভাগ: চট্টগ্রাম"
}
}
}nid-api-3 · ৳10.00 / সফল কল
NID ও জন্মতারিখ দিয়ে NID তথ্য যাচাই। CRD-GR আপস্ট্রিম ব্যবহার করে নাম, পিতা-মাতা, জন্মস্থান, রক্তের গ্রুপ ও ছবি এক রেসপন্সে দেয়।
| Field | Type | Required | Rule |
|---|---|---|---|
| nidNID নম্বর | text | হ্যাঁ | ১০–১৭ ডিজিটের NID নম্বর। আপস্ট্রিমে nid হিসেবে পাঠানো হয়। |
| dobজন্মতারিখ (DOB) | text | হ্যাঁ | YYYY-MM-DD ফরম্যাটে জন্মতারিখ। আপস্ট্রিমে dob হিসেবে পাঠানো হয়। |
| Output | সোর্স পাথ | Missing default |
|---|---|---|
| owner | স্বয়ংক্রিয় | "SUNNAH API" |
| name, nameEn, nationalId, pin | unified identity | "" |
| oldnid, smartnid, dob | unified identity | "" |
| father, mother, age, birthDay | unified identity | "" |
| photo, address | লোকাল ছবি + কমপ্যাক্ট ঠিকানা | "" |
| presentAddress, permanentAddress | address object | {} |
https://sunnah-api.top/api/v1/query.php?service=nid-api-3&key=YOUR_API_KEY&nid=8211097855&dob=1982-08-02
{
"code": 200,
"success": true,
"data": {
"owner": "SUNNAH API",
"name": "মোঃ মোক্তার বিশ্বাস",
"nameEn": "Md. Moktar Biswas",
"nationalId": "3315065981",
"pin": "19712911860000011",
"oldnid": "",
"smartnid": "3315065981",
"voterNumber": "",
"voterAreaNo": "",
"slNo": "",
"father": "মোঃ মজিত বিশ্বাস",
"mother": "মোছাঃ সাজু বেগম",
"spouseName": "",
"dob": "1971-03-05",
"dateOfbirth": "1971-03-05",
"dateOfBirth": "1971-03-05",
"age": "৫৫ বছর, ৭ মাস, ২৯ দিন",
"birthDay": "শুক্রবার",
"gender": "পুরুষ",
"genderEn": "Male",
"religion": "",
"religionEn": "",
"bloodGroup": "",
"birthPlace": "ফরিদপুর",
"occupation": "",
"education": "",
"voterArea": "",
"photo": "https://sunnah-api.top/photo/8211097855_47f42a5ba6.jpg",
"sign": "",
"dateOfToday": "",
"address": "",
"presentAddress": {
"division": "",
"district": "",
"upazilla": "",
"postoffice": "",
"postCode": "",
"unionOrWard": "",
"mouzaOrMoholla": "",
"villageOrRoad": "",
"additionalVillageOrRoad": "",
"houseOrHoldingNo": "",
"ward": "",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": ""
},
"permanentAddress": {
"division": "",
"district": "",
"upazilla": "",
"postoffice": "",
"postCode": "",
"unionOrWard": "",
"mouzaOrMoholla": "",
"villageOrRoad": "",
"additionalVillageOrRoad": "",
"houseOrHoldingNo": "",
"ward": "",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": ""
}
}
}nid-api-4 · ৳5.00 / সফল কল
এটার মধ্যে address আসবেনা
| Field | Type | Required | Rule |
|---|---|---|---|
| nidNID নম্বর | text | হ্যাঁ | ১০–১৭ ডিজিটের NID নম্বর। আপস্ট্রিমে nid হিসেবে পাঠানো হয়। |
| dobজন্মতারিখ (DOB) | text | হ্যাঁ | YYYY-MM-DD ফরম্যাটে জন্মতারিখ। আপস্ট্রিমে dob হিসেবে পাঠানো হয়। |
| Output | সোর্স পাথ | Missing default |
|---|---|---|
| owner | স্বয়ংক্রিয় | "SUNNAH API" |
| name, nameEn, nationalId, pin | unified identity | "" |
| oldnid, smartnid, dob | unified identity | "" |
| father, mother, age, birthDay | unified identity | "" |
| photo, address | লোকাল ছবি + কমপ্যাক্ট ঠিকানা | "" |
| presentAddress, permanentAddress | address object | {} |
https://sunnah-api.top/api/v1/query.php?service=nid-api-4&key=YOUR_API_KEY&nid=8211097855&dob=1982-08-02
{
"code": 200,
"success": true,
"data": {
"owner": "SUNNAH API",
"name": "MD. HARUN OR RASID",
"nameEn": "MD. HARUN OR RASID",
"nationalId": "19726127203163173",
"pin": "19726127203163173",
"oldnid": "",
"smartnid": "19726127203163173",
"voterNumber": "",
"voterAreaNo": "",
"slNo": "",
"father": "রইছ উদ্দিন",
"mother": "মোসাঃ হাজেরা খাতুন",
"spouseName": "",
"dob": "1972-12-20",
"dateOfbirth": "1972-12-20",
"dateOfBirth": "1972-12-20",
"age": "৫৩ বছর, ১০ মাস, ১৪ দিন",
"birthDay": "বুধবার",
"gender": "পুরুষ",
"genderEn": "Male",
"religion": "ইসলাম",
"religionEn": "Islam",
"bloodGroup": "",
"birthPlace": "ময়মনসিংহ",
"occupation": "",
"education": "",
"voterArea": "",
"photo": "https://sunnah-api.top/photo/8211097855_47f42a5ba6.jpg",
"sign": "",
"dateOfToday": "",
"address": "",
"presentAddress": {
"division": "",
"district": "",
"upazilla": "",
"postoffice": "",
"postCode": "",
"unionOrWard": "",
"mouzaOrMoholla": "",
"villageOrRoad": "",
"additionalVillageOrRoad": "",
"houseOrHoldingNo": "",
"ward": "",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": ""
},
"permanentAddress": {
"division": "",
"district": "",
"upazilla": "",
"postoffice": "",
"postCode": "",
"unionOrWard": "",
"mouzaOrMoholla": "",
"villageOrRoad": "",
"additionalVillageOrRoad": "",
"houseOrHoldingNo": "",
"ward": "",
"region": "",
"cityCorporationOrMunicipality": "",
"addressLine": ""
}
}
}