{"uid":"cap_XwHrsE5YuiBCkZN310Mvo","slug":"getapi-bag-address-lookup-by-id-30609022","name":"GetApi BAG Address Lookup by ID","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/id","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"properties":{"queryParams":{"type":"object","properties":{"id":"1"}}}},"output":{"properties":{"example":{"found":true,"address":{"lat":52.3745,"lon":4.8986,"city":"Amsterdam","type":"residence","status":"in_use","street":"Damrak","postcode":"1012LG","build_year":1900,"occurrence":null,"short_name":"Damrak","is_observed":false,"address_line":"Damrak 1","bag_pand_ids":["0363100012165277"],"house_letter":null,"house_number":1,"municipality":"Amsterdam","document_date":"2019-11-22","usage_purposes":["retail"],"document_number":"19SZ2048","surface_area_m2":312,"in_investigation":null,"bag_woonplaats_id":"3594","address_line_postal":"1012 LG  AMSTERDAM","is_secondary_address":false,"house_number_addition":null,"secondary_address_ids":[],"bag_openbare_ruimte_id":"0363300000006316","bag_verblijfsobject_id":"0363010000218908","bag_nummeraanduiding_id":"0363200000218908"}}}}}},"responseSchema":{"type":"json","example":{"found":true,"address":{"lat":52.3745,"lon":4.8986,"city":"Amsterdam","type":"residence","status":"in_use","street":"Damrak","postcode":"1012LG","build_year":1900,"occurrence":null,"short_name":"Damrak","is_observed":false,"address_line":"Damrak 1","bag_pand_ids":["0363100012165277"],"house_letter":null,"house_number":1,"municipality":"Amsterdam","document_date":"2019-11-22","usage_purposes":["retail"],"document_number":"19SZ2048","surface_area_m2":312,"in_investigation":null,"bag_woonplaats_id":"3594","address_line_postal":"1012 LG  AMSTERDAM","is_secondary_address":false,"house_number_addition":null,"secondary_address_ids":[],"bag_openbare_ruimte_id":"0363300000006316","bag_verblijfsobject_id":"0363010000218908","bag_nummeraanduiding_id":"0363200000218908"}}},"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_zdAB0tzIc2-Zt-icTWsyE","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":"Looks up detailed Dutch address and building metadata from the BAG (Basisregistratie Adressen en Gebouwen) registry by a BAG identifier","exampleAgentPrompt":"Can you look up the full address details for BAG verblijfsobject ID 0363010000218908 — I need the coordinates, postcode, build year, surface area, and usage purpose?","exampleUseCases":[{"title":"Enrich property listings with BAG data","prompt":"I have a BAG nummeraanduiding ID 0363200000218908 for a property — can you pull all the details from the Dutch BAG registry, including the street address, postcode, city, build year, and surface area in square meters?"},{"title":"Validate Dutch address for a business application","prompt":"We need to verify that BAG verblijfsobject 0363010000218908 in Amsterdam is currently in use and find out what its registered usage purposes are — can you check the Kadaster BAG data for me?"},{"title":"Geolocate a Dutch building by BAG ID","prompt":"Can you get the latitude and longitude for the building registered under BAG pand ID 0363100012165277 in the Netherlands so I can place it on a map?"}],"resultDescription":"Returns a JSON object with a `found` boolean and a nested `address` object containing: latitude, longitude, city, street, postcode, build year, surface area in m², usage purposes, address status, municipality, full address line, postal address line, BAG pand IDs, bag_verblijfsobject_id, bag_nummeraanduiding_id, bag_openbare_ruimte_id, bag_woonplaats_id, document date and number, house number and letter, house number addition, secondary address info, and observation/investigation flags.","failureModes":["BAG ID not found — returns `found: false` with no address data","Invalid BAG ID format — may return 400 or empty result","BAG object exists but is not in active use — status field will indicate this","Network timeout for slow Kadaster upstream responses","Payment failure (402) if USDC payment is not included or insufficient"],"whenToPreferThis":"Use this endpoint when you already have a specific BAG identifier (verblijfsobject, nummeraanduiding, or pand ID) and need to resolve it to full Dutch address metadata including coordinates, build year, usage purpose, and status. Prefer this over general address search endpoints when you need rich BAG-specific fields like bag_pand_ids, surface_area_m2, usage_purposes, or in_investigation flags that are only available from the Dutch Kadaster registry.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:47:46.390Z","isFirstParty":false}