{"info":{"_postman_id":"aac6b414-e13b-4af5-9bdf-785db836fe25","name":"Indonesia Schools API","description":"<html><head></head><body><p>Complete API collection for Indonesian schools data with comprehensive filtering capabilities and premium features.</p>\n<h2 id=\"features\">Features</h2>\n<ul>\n<li>Access to all schools in Indonesia</li>\n<li>Filter by province, regency, district</li>\n<li>Search by NPSN, school name, status, and grade</li>\n<li>Filter by accreditation (premium only)</li>\n<li>Advanced search endpoint (premium only)</li>\n<li>Geographic data (latitude/longitude - premium only)</li>\n<li>Accreditation data (premium only)</li>\n<li>Fast search with dynamic query parameters</li>\n<li>Pagination support</li>\n<li>Integrated with Indonesia Regional API for location data</li>\n</ul>\n<h2 id=\"authentication\">Authentication</h2>\n<p>All requests require an API key in the <code>x-api-co-id</code> header.</p>\n<h2 id=\"premium-features\">Premium Features</h2>\n<p>The following features require a premium subscription:</p>\n<ul>\n<li><strong>Latitude &amp; Longitude</strong> - Geographic coordinates (non-premium users will see: \"this data only available on premium package\")</li>\n<li><strong>Accreditation Data</strong> - School accreditation information (non-premium users will see: \"this data only available on premium package\")</li>\n<li><strong>Accreditation Filter</strong> - Filter schools by accreditation</li>\n<li><strong>Advanced Search</strong> - <code>/regional/indonesia/schools/search</code> endpoint for searching by name, NPSN, or address</li>\n</ul>\n<h2 id=\"base-url\">Base URL</h2>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code>https://use.api.co.id/regional/indonesia/schools\n</code></pre><h2 id=\"integration-with-indonesia-regional-api\">Integration with Indonesia Regional API</h2>\n<p>This API is connected to the <a href=\"https://api.co.id/indonesia-regional-api/\">Indonesia Regional API</a> for location data. You can use the <code>province_code</code>, <code>regency_code</code>, and <code>district_code</code> returned in the response to fetch detailed location information from the Regional API.</p>\n<h3 id=\"example-get-province-details\">Example: Get Province Details</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\">GET https://use.api.co.id/regional/indonesia/provinces/{province_code}\n</code></pre>\n<h3 id=\"example-get-regency-details\">Example: Get Regency Details</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\">GET https://use.api.co.id/regional/indonesia/regencies/{regency_code}\n</code></pre>\n<h3 id=\"example-get-district-details\">Example: Get District Details</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\">GET https://use.api.co.id/regional/indonesia/districts/{district_code}\n</code></pre>\n<p>Visit <a href=\"https://api.co.id/indonesia-regional-api/\">https://api.co.id/indonesia-regional-api/</a> for complete Regional API documentation.</p>\n<h2 id=\"data-fields\">Data Fields</h2>\n<ul>\n<li><strong>npsn</strong>: National School Registration Number</li>\n<li><strong>name</strong>: School name (sekolah)</li>\n<li><strong>grade</strong>: School type/level (bentuk)</li>\n<li><strong>status</strong>: School status - <strong>N</strong> = Negeri (Public), <strong>S</strong> = Swasta (Private)</li>\n<li><strong>accreditation</strong>: School accreditation (A, B, C, etc.) - <strong>Premium Only</strong></li>\n<li><strong>address</strong>: Street address (alamat_jalan)</li>\n<li><strong>province_code</strong>: Province code (use with Regional API)</li>\n<li><strong>province_name</strong>: Province name (api_propinsi)</li>\n<li><strong>regency_code</strong>: Regency/city code (use with Regional API)</li>\n<li><strong>regency_name</strong>: Regency/city name (api_kabupaten_kota)</li>\n<li><strong>district_code</strong>: District code (use with Regional API)</li>\n<li><strong>district_name</strong>: District name (api_kecamatan)</li>\n<li><strong>lang</strong>: Latitude (lintang) - <strong>Premium Only</strong></li>\n<li><strong>long</strong>: Longitude (bujur) - <strong>Premium Only</strong></li>\n</ul>\n<h2 id=\"filtering-options\">Filtering Options</h2>\n<ul>\n<li><code>province_code</code>: Filter by province code</li>\n<li><code>regency_code</code>: Filter by regency/city code</li>\n<li><code>district_code</code>: Filter by district code</li>\n<li><code>npsn</code>: Exact match by NPSN</li>\n<li><code>name</code>: Search by school name (case-insensitive partial match)</li>\n<li><code>status</code>: Filter by status (N = Negeri, S = Swasta)</li>\n<li><code>grade</code>: Search by school grade/type (case-insensitive partial match)</li>\n<li><code>accreditation</code>: Filter by accreditation (A, B, C, etc.) - <strong>Premium Only</strong></li>\n<li><code>page</code>: Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50289783","collectionId":"aac6b414-e13b-4af5-9bdf-785db836fe25","publishedId":"2sBXVhEBht","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-01-16T09:16:55.000Z"},"item":[{"name":"List Schools","item":[{"name":"List All Schools","id":"fea009dd-cd48-49de-87b7-9de9ff2e8397","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?page=1","description":"<p>Get all schools in Indonesia with pagination.</p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>page</code> (optional): Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n<h3 id=\"premium-fields\">Premium Fields</h3>\n<p>Non-premium users will see \"this data only available on premium package\" for:</p>\n<ul>\n<li><code>accreditation</code></li>\n<li><code>lang</code> (latitude)</li>\n<li><code>long</code> (longitude)</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Get first page of schools\nGET /regional/indonesia/schools?page=1\n\n# Get next page\nGET /regional/indonesia/schools?page=2\n</code></pre>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>Page number</p>\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"1f1a485d-d158-47c7-8172-f3de11d71d07","name":"Success - List Schools (Premium User)","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/schools?page=1","host":["https://use.api.co.id"],"path":["regional","indonesia","schools"],"query":[{"key":"page","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": true,\n    \"message\": \"Success\",\n    \"data\": [\n        {\n            \"npsn\": \"10100101\",\n            \"name\": \"SD NEGERI 1 BANDA ACEH\",\n            \"grade\": \"SD\",\n            \"status\": \"N\",\n            \"accreditation\": \"A\",\n            \"address\": \"JL. CUT NYAK DIEN NO. 1\",\n            \"province_code\": \"11\",\n            \"province_name\": \"ACEH\",\n            \"regency_code\": \"1171\",\n            \"regency_name\": \"KOTA BANDA ACEH\",\n            \"district_code\": \"1171010\",\n            \"district_name\": \"BAITURRAHMAN\",\n            \"lang\": -5.548056,\n            \"long\": 95.319167\n        }\n    ],\n    \"paging\": {\n        \"page\": 1,\n        \"size\": 100,\n        \"total_item\": 250000,\n        \"total_page\": 2500\n    }\n}"},{"id":"204823a6-b41a-47f2-a716-24c498d57740","name":"Success - List Schools (Non-Premium User)","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/schools?page=1","host":["https://use.api.co.id"],"path":["regional","indonesia","schools"],"query":[{"key":"page","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": true,\n    \"message\": \"Success\",\n    \"data\": [\n        {\n            \"npsn\": \"10100101\",\n            \"name\": \"SD NEGERI 1 BANDA ACEH\",\n            \"grade\": \"SD\",\n            \"status\": \"N\",\n            \"accreditation\": \"this data only available on premium package\",\n            \"address\": \"JL. CUT NYAK DIEN NO. 1\",\n            \"province_code\": \"11\",\n            \"province_name\": \"ACEH\",\n            \"regency_code\": \"1171\",\n            \"regency_name\": \"KOTA BANDA ACEH\",\n            \"district_code\": \"1171010\",\n            \"district_name\": \"BAITURRAHMAN\",\n            \"lang\": \"this data only available on premium package\",\n            \"long\": \"this data only available on premium package\"\n        }\n    ],\n    \"paging\": {\n        \"page\": 1,\n        \"size\": 100,\n        \"total_item\": 250000,\n        \"total_page\": 2500\n    }\n}"}],"_postman_id":"fea009dd-cd48-49de-87b7-9de9ff2e8397"},{"name":"Filter by Province","id":"e8e34068-473d-48d0-bb3d-10db509b3ae4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?province_code=32&page=1","description":"<p>Get schools filtered by province code.</p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>province_code</code> (required): Province code (e.g., 32 for Jawa Barat, 31 for DKI Jakarta)</li>\n<li><code>page</code> (optional): Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Get schools in Jawa Barat\nGET /regional/indonesia/schools?province_code=32\n\n# Get schools in DKI Jakarta\nGET /regional/indonesia/schools?province_code=31\n</code></pre>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>Province code (e.g., 32 for Jawa Barat)</p>\n","type":"text/plain"},"key":"province_code","value":"32"},{"key":"page","value":"1"}],"variable":[]}},"response":[],"_postman_id":"e8e34068-473d-48d0-bb3d-10db509b3ae4"},{"name":"Filter by Regency","id":"fd1687a0-c425-4508-b505-3021faaca3d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?regency_code=3273&page=1","description":"<p>Get schools filtered by regency/city code.</p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>regency_code</code> (required): Regency/city code</li>\n<li><code>page</code> (optional): Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Get schools in Kota Bandung\nGET /regional/indonesia/schools?regency_code=3273\n\n# Combine with province filter\nGET /regional/indonesia/schools?province_code=32&amp;regency_code=3273\n</code></pre>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>Regency/city code (e.g., 3273 for Kota Bandung)</p>\n","type":"text/plain"},"key":"regency_code","value":"3273"},{"key":"page","value":"1"}],"variable":[]}},"response":[],"_postman_id":"fd1687a0-c425-4508-b505-3021faaca3d3"},{"name":"Filter by District","id":"03610bd0-4183-4e69-b988-410973f9dbe9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?district_code=3273010&page=1","description":"<p>Get schools filtered by district code.</p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>district_code</code> (required): District code</li>\n<li><code>page</code> (optional): Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Get schools in a specific district\nGET /regional/indonesia/schools?district_code=3273010\n\n# Combine filters\nGET /regional/indonesia/schools?province_code=32&amp;regency_code=3273&amp;district_code=3273010\n</code></pre>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>District code</p>\n","type":"text/plain"},"key":"district_code","value":"3273010"},{"key":"page","value":"1"}],"variable":[]}},"response":[],"_postman_id":"03610bd0-4183-4e69-b988-410973f9dbe9"},{"name":"Search by NPSN","id":"65294928-08a9-43f4-8735-337925173804","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?npsn=10100101","description":"<p>Get school by NPSN (exact match).</p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>npsn</code> (required): National School Registration Number</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Get school by NPSN\nGET /regional/indonesia/schools?npsn=10100101\n</code></pre>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>National School Registration Number (exact match)</p>\n","type":"text/plain"},"key":"npsn","value":"10100101"}],"variable":[]}},"response":[],"_postman_id":"65294928-08a9-43f4-8735-337925173804"},{"name":"Search by School Name","id":"56110129-8d60-4c28-bccf-3aa9e55cab1f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?name=SD NEGERI&page=1","description":"<p>Search schools by name (case-insensitive partial match).</p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>name</code> (required): School name to search for</li>\n<li><code>page</code> (optional): Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Search for schools with \"SD NEGERI\" in name\nGET /regional/indonesia/schools?name=SD NEGERI\n\n# Search for specific school\nGET /regional/indonesia/schools?name=SMA NEGERI 1 BANDUNG\n</code></pre>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>School name (case-insensitive partial match)</p>\n","type":"text/plain"},"key":"name","value":"SD NEGERI"},{"key":"page","value":"1"}],"variable":[]}},"response":[],"_postman_id":"56110129-8d60-4c28-bccf-3aa9e55cab1f"},{"name":"Filter by Status (Negeri/Swasta)","id":"66a93673-6fc5-4146-8e5e-461ae49ded08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?status=N&page=1","description":"<p>Filter schools by status.</p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>status</code> (required): School status<ul>\n<li><strong>N</strong> = Negeri (Public School)</li>\n<li><strong>S</strong> = Swasta (Private School)</li>\n</ul>\n</li>\n<li><code>page</code> (optional): Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Get only public schools (Negeri)\nGET /regional/indonesia/schools?status=N\n\n# Get only private schools (Swasta)\nGET /regional/indonesia/schools?status=S\n\n# Combine with province filter\nGET /regional/indonesia/schools?province_code=32&amp;status=N\n</code></pre>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>School status: N = Negeri (Public), S = Swasta (Private)</p>\n","type":"text/plain"},"key":"status","value":"N"},{"key":"page","value":"1"}],"variable":[]}},"response":[],"_postman_id":"66a93673-6fc5-4146-8e5e-461ae49ded08"},{"name":"Filter by Grade/Type","id":"d9012b9d-d0ca-4afd-a518-42da7b1b0d2d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?grade=SD&page=1","description":"<p>Filter schools by grade/type.</p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>grade</code> (required): School grade/type (case-insensitive partial match)<ul>\n<li>Common values: SD, SMP, SMA, SMK, MI, MTs, MA</li>\n</ul>\n</li>\n<li><code>page</code> (optional): Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Get all SD (Elementary) schools\nGET /regional/indonesia/schools?grade=SD\n\n# Get all SMA (High School) schools\nGET /regional/indonesia/schools?grade=SMA\n\n# Combine with status filter\nGET /regional/indonesia/schools?grade=SD&amp;status=N\n</code></pre>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>School grade/type (case-insensitive partial match, e.g., SD, SMP, SMA, SMK)</p>\n","type":"text/plain"},"key":"grade","value":"SD"},{"key":"page","value":"1"}],"variable":[]}},"response":[],"_postman_id":"d9012b9d-d0ca-4afd-a518-42da7b1b0d2d"},{"name":"Filter by Accreditation (Premium)","id":"8b9bb918-cacf-4c79-8dce-04ec38739bc2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?accreditation=A&page=1","description":"<p>Filter schools by accreditation. <strong>This filter requires a premium subscription.</strong></p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>accreditation</code> (required): School accreditation<ul>\n<li>Common values: A, B, C</li>\n</ul>\n</li>\n<li><code>page</code> (optional): Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Get all A-accredited schools\nGET /regional/indonesia/schools?accreditation=A\n\n# Get A-accredited public schools in Bandung\nGET /regional/indonesia/schools?regency_code=3273&amp;status=N&amp;accreditation=A\n</code></pre>\n<h3 id=\"error-responses\">Error Responses</h3>\n<ul>\n<li><code>403 Forbidden</code>: User is not a premium member</li>\n<li><code>401 Unauthorized</code>: User not authenticated</li>\n</ul>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>School accreditation (A, B, C, etc.)</p>\n","type":"text/plain"},"key":"accreditation","value":"A"},{"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"09a4c0a1-3221-4dae-81da-dd760cc5a680","name":"Success - Filter by Accreditation","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/schools?accreditation=A&page=1","host":["https://use.api.co.id"],"path":["regional","indonesia","schools"],"query":[{"key":"accreditation","value":"A"},{"key":"page","value":"1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": true,\n    \"message\": \"Success\",\n    \"data\": [\n        {\n            \"npsn\": \"10100101\",\n            \"name\": \"SD NEGERI 1 BANDA ACEH\",\n            \"grade\": \"SD\",\n            \"status\": \"N\",\n            \"accreditation\": \"A\",\n            \"address\": \"JL. CUT NYAK DIEN NO. 1\",\n            \"province_code\": \"11\",\n            \"province_name\": \"ACEH\",\n            \"regency_code\": \"1171\",\n            \"regency_name\": \"KOTA BANDA ACEH\",\n            \"district_code\": \"1171010\",\n            \"district_name\": \"BAITURRAHMAN\",\n            \"lang\": -5.548056,\n            \"long\": 95.319167\n        }\n    ],\n    \"paging\": {\n        \"page\": 1,\n        \"size\": 100,\n        \"total_item\": 50000,\n        \"total_page\": 500\n    }\n}"},{"id":"7f17f629-64e8-47c1-9688-1a7467568e28","name":"Error - Not Premium","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/schools?accreditation=A","host":["https://use.api.co.id"],"path":["regional","indonesia","schools"],"query":[{"key":"accreditation","value":"A"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"Accreditation filter is for premium members only\"\n}"}],"_postman_id":"8b9bb918-cacf-4c79-8dce-04ec38739bc2"},{"name":"Combined Filters Example","id":"0e93e5bf-ec81-4aee-99c8-5390f65910e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?province_code=32&regency_code=3273&status=N&grade=SD&page=1","description":"<p>Example of combining multiple filters for precise search.</p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<p>All filters can be combined:</p>\n<ul>\n<li><code>province_code</code>: Filter by province</li>\n<li><code>regency_code</code>: Filter by regency/city</li>\n<li><code>district_code</code>: Filter by district</li>\n<li><code>status</code>: Filter by status (N/S)</li>\n<li><code>grade</code>: Filter by grade/type</li>\n<li><code>accreditation</code>: Filter by accreditation (premium only)</li>\n<li><code>name</code>: Search by name</li>\n<li><code>npsn</code>: Exact match by NPSN</li>\n<li><code>page</code>: Page number</li>\n<li><code>size (fixed at 100)</code>: Items per page</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Get public SD schools in Kota Bandung\nGET /regional/indonesia/schools?province_code=32&amp;regency_code=3273&amp;status=N&amp;grade=SD\n\n# Get A-accredited private SMA schools in Jakarta (premium)\nGET /regional/indonesia/schools?province_code=31&amp;status=S&amp;grade=SMA&amp;accreditation=A\n\n# Search by name in specific district\nGET /regional/indonesia/schools?district_code=3273010&amp;name=SMAN\n</code></pre>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>Jawa Barat</p>\n","type":"text/plain"},"key":"province_code","value":"32"},{"description":{"content":"<p>Kota Bandung</p>\n","type":"text/plain"},"key":"regency_code","value":"3273"},{"description":{"content":"<p>Negeri (Public)</p>\n","type":"text/plain"},"key":"status","value":"N"},{"description":{"content":"<p>Elementary School</p>\n","type":"text/plain"},"key":"grade","value":"SD"},{"key":"page","value":"1"}],"variable":[]}},"response":[],"_postman_id":"0e93e5bf-ec81-4aee-99c8-5390f65910e0"}],"id":"214836e6-9961-4ad8-9ffa-e38ae06b14f9","_postman_id":"214836e6-9961-4ad8-9ffa-e38ae06b14f9","description":""},{"name":"Search (Premium)","item":[{"name":"Search Schools","id":"5f742827-27fd-469f-9c03-0bd005c38817","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","description":"<p>Your API key for authentication</p>\n","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools/search?query=SD NEGERI","description":"<p>Advanced search across school name, NPSN, and address. <strong>This endpoint requires a premium subscription.</strong></p>\n<h3 id=\"query-parameters\">Query Parameters</h3>\n<ul>\n<li><code>query</code> (required): Search term (searches name, NPSN, and address)</li>\n<li><code>page</code> (optional): Page number (default: 1)</li>\n<li><strong>Note:</strong> Pagination size is fixed at 100 items per page and cannot be configured</li>\n</ul>\n<h3 id=\"examples\">Examples</h3>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-bash\"># Search by name\nGET /regional/indonesia/schools/search?query=SD NEGERI\n\n# Search by NPSN\nGET /regional/indonesia/schools/search?query=10100101\n\n# Search by address\nGET /regional/indonesia/schools/search?query=JL. CUT NYAK DIEN\n</code></pre>\n<h3 id=\"error-responses\">Error Responses</h3>\n<ul>\n<li><code>403 Forbidden</code>: User is not a premium member</li>\n<li><code>401 Unauthorized</code>: User not authenticated</li>\n</ul>\n","urlObject":{"path":["regional","indonesia","schools","search"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>Search term (required) - searches name, NPSN, and address</p>\n","type":"text/plain"},"key":"query","value":"SD NEGERI"},{"disabled":true,"description":{"content":"<p>Page number (optional)</p>\n","type":"text/plain"},"key":"page","value":"1"}],"variable":[]}},"response":[{"id":"31d47cd1-7772-4f49-bef3-2557db56e428","name":"Success - Search Results","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/schools/search?query=SD NEGERI","host":["https://use.api.co.id"],"path":["regional","indonesia","schools","search"],"query":[{"key":"query","value":"SD NEGERI"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"status\": \"success\",\n    \"timestamp\": \"2026-01-16 10:30:45\",\n    \"result\": [\n        {\n            \"npsn\": \"10100101\",\n            \"name\": \"SD NEGERI 1 BANDA ACEH\",\n            \"grade\": \"SD\",\n            \"status\": \"N\",\n            \"accreditation\": \"A\",\n            \"address\": \"JL. CUT NYAK DIEN NO. 1\",\n            \"province_code\": \"11\",\n            \"province\": \"ACEH\",\n            \"regency_code\": \"1171\",\n            \"regency\": \"KOTA BANDA ACEH\",\n            \"district_code\": \"1171010\",\n            \"district\": \"BAITURRAHMAN\",\n            \"lat\": -5.548056,\n            \"long\": 95.319167\n        },\n        {\n            \"npsn\": \"10100102\",\n            \"name\": \"SD NEGERI 2 BANDA ACEH\",\n            \"grade\": \"SD\",\n            \"status\": \"N\",\n            \"accreditation\": \"A\",\n            \"address\": \"JL. TEUKU UMAR NO. 15\",\n            \"province_code\": \"11\",\n            \"province\": \"ACEH\",\n            \"regency_code\": \"1171\",\n            \"regency\": \"KOTA BANDA ACEH\",\n            \"district_code\": \"1171010\",\n            \"district\": \"BAITURRAHMAN\",\n            \"lat\": -5.549167,\n            \"long\": 95.320278\n        }\n    ],\n    \"paging\": {\n        \"page\": 1,\n        \"size\": 100,\n        \"total_item\": 25000,\n        \"total_page\": 250\n    }\n}"},{"id":"bd9b86b0-12c0-4162-b2bd-b4ad33ede081","name":"Error - Not Premium","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","type":"text"}],"url":{"raw":"https://use.api.co.id/regional/indonesia/schools/search?query=SD NEGERI","host":["https://use.api.co.id"],"path":["regional","indonesia","schools","search"],"query":[{"key":"query","value":"SD NEGERI"}]}},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"This endpoint is for premium members only\"\n}"}],"_postman_id":"5f742827-27fd-469f-9c03-0bd005c38817"}],"id":"7d46ae57-d315-4216-9acc-232eb09ff88a","description":"<p>Advanced search endpoint for schools. Search endpoint requires premium subscription.</p>\n","_postman_id":"7d46ae57-d315-4216-9acc-232eb09ff88a"},{"name":"Error Responses","item":[{"name":"Unauthorized - Missing API Key","id":"e580ecc7-58d1-457d-b8c1-90e9f8e61394","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://use.api.co.id/regional/indonesia/schools","description":"<p>Error response when API key is missing or invalid.</p>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[{"id":"b8c1ea64-9dcf-4598-b009-efe3d8ac74f0","name":"401 Unauthorized","originalRequest":{"method":"GET","header":[],"url":"https://use.api.co.id/regional/indonesia/schools"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n    \"is_success\": false,\n    \"message\": \"Unauthorized: API key is required\"\n}"}],"_postman_id":"e580ecc7-58d1-457d-b8c1-90e9f8e61394"},{"name":"Bad Request - Invalid Parameters","id":"36d74233-4736-4d74-b4cc-ca92147bb65d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"your-api-key-here","type":"text"}],"url":"https://use.api.co.id/regional/indonesia/schools?page=0","description":"<p>Error response when query parameters are invalid.</p>\n","urlObject":{"path":["regional","indonesia","schools"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"<p>Invalid: page must be &gt;= 1</p>\n","type":"text/plain"},"key":"page","value":"0"}],"variable":[]}},"response":[],"_postman_id":"36d74233-4736-4d74-b4cc-ca92147bb65d"}],"id":"a6441e6a-6ace-420c-a940-75c192bca5c5","_postman_id":"a6441e6a-6ace-420c-a940-75c192bca5c5","description":""}],"variable":[{"key":"base_url","value":"https://use.api.co.id","type":"string"},{"key":"api_key","value":"your-api-key-here","type":"string"}]}