{"uid":"cap_ssHlfDB-g-i2qA_yhvzDa","slug":"getapi-kadaster-bag-address-suggest-702ff32c","name":"GetApi Kadaster BAG Address Suggest","description":"Ontdek, test en integreer krachtige API's voor web scraping, e-mailvalidatie, geolocatie\n    en meer. Gratis starten.","url":"https://api.getapi.nl/api/v1/kadaster/bag/address-suggest","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"properties":{"queryParams":{"type":"object","properties":{"q":"Amsterdam","limit":1}}}},"output":{"properties":{"example":{"suggestions":[{"id":"adr-1234567890123456","type":"adres","label":"Damrak 1, 1012LG Amsterdam","postcode":"1012LG","house_number":1,"verblijfsobject_id":"1234567890123456","nummeraanduiding_id":"1234567890123456"},{"id":"adr-1234567890123457","type":"adres","label":"Damrak 2, 1012LG Amsterdam","postcode":"1012LG","house_number":2,"verblijfsobject_id":"1234567890123457","nummeraanduiding_id":"1234567890123457"}]}}}}},"responseSchema":{"type":"json","example":{"suggestions":[{"id":"adr-1234567890123456","type":"adres","label":"Damrak 1, 1012LG Amsterdam","postcode":"1012LG","house_number":1,"verblijfsobject_id":"1234567890123456","nummeraanduiding_id":"1234567890123456"},{"id":"adr-1234567890123457","type":"adres","label":"Damrak 2, 1012LG Amsterdam","postcode":"1012LG","house_number":2,"verblijfsobject_id":"1234567890123457","nummeraanduiding_id":"1234567890123457"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a4Hwev3BoW55JUziJPP2r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Dutch address autocomplete suggestions from the Kadaster BAG (Basisregistratie Adressen en Gebouwen) registry given a partial address query","exampleAgentPrompt":"Can you suggest Dutch addresses that match 'Damrak 1 Amsterdam' using the Kadaster BAG registry and give me the official BAG address ID and postcode?","exampleUseCases":[{"title":"Address autocomplete for checkout form","prompt":"I'm building a checkout flow for Dutch customers — can you suggest matching addresses as the user types 'Kalverstraat 5 Amsterdam' and return the official postcode and BAG ID so I can pre-fill the rest of the form?"},{"title":"Resolve property BAG identifier","prompt":"I need the official Kadaster verblijfsobject ID and nummeraanduiding ID for the address 'Herengracht 100, Amsterdam' — can you look that up from the BAG registry?"},{"title":"Validate Dutch delivery address","prompt":"Before we ship an order, can you check if 'Binnenhof 1, Den Haag' matches a real BAG-registered address in the Netherlands and return the official label and postcode?"}],"resultDescription":"A JSON object containing a 'suggestions' array, where each entry includes a unique BAG address ID (adr-prefixed), type ('adres'), a human-readable label (street + postcode + city), postcode, house number, verblijfsobject ID, and nummeraanduiding ID — all sourced from the official Dutch Kadaster BAG database.","failureModes":["No suggestions returned for highly ambiguous or misspelled input","Empty suggestions array if query does not match any BAG record","Payment required (402) if x402 payment header is not provided","Rate limiting or authentication errors if API key is missing or invalid","Partial matches only for very short or generic query strings"],"whenToPreferThis":"Use this endpoint when you need authoritative Dutch address autocomplete or resolution backed by the official Kadaster BAG registry, especially when you need BAG identifiers (verblijfsobject ID, nummeraanduiding ID) for downstream property lookups, address validation, or form pre-filling in the Netherlands. Prefer this over generic geocoders when official Dutch government cadastral identifiers are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:43:09.756Z","isFirstParty":false}