{"openapi":"3.1.0","info":{"title":"agenticweb.nl API","version":"1.0.0","description":"Clean, structured data endpoints for AI agents, metered per call via x402 (USDC on Base). Every endpoint answers a free sample at ?sample=1 and returns a unified { data, meta } envelope. Paying a 402 challenge constitutes acceptance of the terms of service; privacy policy at agenticweb.nl/privacy.","termsOfService":"agenticweb.nl/terms","contact":{"url":"agenticweb.nl"}},"servers":[{"url":"api.agenticweb.nl"}],"paths":{"/api/v1/nl/vehicle/{kenteken}":{"get":{"operationId":"vehicle","summary":"Dutch vehicle lookup","description":"Registration, fuel/EV, APK (roadworthiness) and open recalls (terugroepacties) for a Dutch licence plate (kenteken).\n\nPaid per call over x402 ($0.02). Free sample: `/api/v1/nl/vehicle/demo?sample=1`.","parameters":[{"name":"kenteken","in":"path","required":true,"description":"Plate, path segment. Case/format-insensitive (e.g. 0001TJ).","schema":{"type":"string"}},{"name":"sample","in":"query","required":false,"description":"Set to 1 for the free demo response.","schema":{"type":"string"}}],"x-x402":{"price":"$0.02","network":"base","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"responses":{"200":{"description":"Success — unified data envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"402":{"description":"Payment Required — pay the advertised x402 price and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Not found / no data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/nl/school-holidays":{"get":{"operationId":"school-holidays","summary":"Dutch school holidays","description":"Current, merged Dutch school-holiday dates, queryable by school year, region or a specific date.\n\nPaid per call over x402 ($0.008). Free sample: `/api/v1/nl/school-holidays?sample=1`.","parameters":[{"name":"year","in":"query","required":false,"description":"School year, e.g. 2025-2026. Defaults to the current one.","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"noord | midden | zuid.","schema":{"type":"string"}},{"name":"date","in":"query","required":false,"description":"YYYY-MM-DD — returns the holiday (if any) covering that date.","schema":{"type":"string"}},{"name":"sample","in":"query","required":false,"description":"Set to 1 for the free demo response.","schema":{"type":"string"}}],"x-x402":{"price":"$0.008","network":"base","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"responses":{"200":{"description":"Success — unified data envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"402":{"description":"Payment Required — pay the advertised x402 price and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Not found / no data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/nl/vacation-region":{"get":{"operationId":"vacation-region","summary":"Vacation region resolver","description":"Resolve a Dutch place to its vacation region (noord/midden/zuid) and attach that region's current holiday dates.\n\nPaid per call over x402 ($0.01). Free sample: `/api/v1/nl/vacation-region?sample=1`.","parameters":[{"name":"plaats","in":"query","required":false,"description":"Place/city name.","schema":{"type":"string"}},{"name":"gemeente","in":"query","required":false,"description":"Municipality name.","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"Province name.","schema":{"type":"string"}},{"name":"sample","in":"query","required":false,"description":"Set to 1 for the free demo response.","schema":{"type":"string"}}],"x-x402":{"price":"$0.01","network":"base","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"responses":{"200":{"description":"Success — unified data envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"402":{"description":"Payment Required — pay the advertised x402 price and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Not found / no data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/global/fx":{"get":{"operationId":"fx","summary":"FX conversion (ECB)","description":"Currency conversion using ECB euro reference rates. Informational only — not tradeable quotes.\n\nPaid per call over x402 ($0.003). Free sample: `/api/v1/global/fx?sample=1`.","parameters":[{"name":"from","in":"query","required":false,"description":"ISO 4217 source currency (default EUR).","schema":{"type":"string"}},{"name":"to","in":"query","required":false,"description":"ISO 4217 target currency (default USD).","schema":{"type":"string"}},{"name":"amount","in":"query","required":false,"description":"Amount to convert (default 1).","schema":{"type":"string"}},{"name":"sample","in":"query","required":false,"description":"Set to 1 for the free demo response.","schema":{"type":"string"}}],"x-x402":{"price":"$0.003","network":"base","asset":"USDC","assetAddress":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"responses":{"200":{"description":"Success — unified data envelope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"402":{"description":"Payment Required — pay the advertised x402 price and retry with the X-PAYMENT header.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Not found / no data.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Envelope":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"type":"object","properties":{"source":{"type":"string","example":"agenticweb.nl"},"attribution":{"type":"array","items":{"type":"string"}},"license_notes":{"type":"string"},"disclaimer":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"},"cache_age_seconds":{"type":"integer"}}}}},"PaymentRequired":{"type":"object","properties":{"x402Version":{"type":"integer","example":1},"error":{"type":"string"},"accepts":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true}}}}}}