{ "openapi": "3.1.0", "info": { "title": "FabTally Valid — validation suite for developers & agents", "version": "1.0.0", "description": "One unified, per-call validation bundle: vat (EU VAT format/checksum + LIVE VIES lookup returning the registered name/address), iban (mod-97 checksum + country + bank-code extraction), email (syntax + live MX/DNS + disposable-domain detection + role-address flag, no storage/SMTP), geo (country/subdivision/city reference lookup over a bundled open dataset — no per-day API limits), vin (format/check-digit + NHTSA vPIC make/model/year decode). All read-only, keyless, stateless, non-PII. Paid via x402 (USDC on Base) or a prepaid credit key; each has a rate-limited free teaser. Also available as an MCP server.", "x-guidance": "Paid (x402 USDC on Base, or prepaid X-FabTally-Key): POST /v1/vat ($0.003), /v1/iban ($0.001), /v1/email ($0.002), /v1/geo ($0.002), /v1/vin ($0.002) — each has a rate-limited /free teaser. Unpaid paid-calls return an x402 402 challenge; pay and retry with the X-PAYMENT header. Bad input -> 400, never charged.", "contact": { "email": "hello@fabtally.com" } }, "servers": [ { "url": "https://valid.fabtally.com" } ], "paths": { "/agent/overview": { "get": { "operationId": "overview", "summary": "Capabilities, pricing, payment info (free)", "tags": [ "Discovery" ], "security": [], "responses": { "200": { "description": "Overview" } } } }, "/health": { "get": { "operationId": "health", "summary": "Health (free)", "tags": [ "Discovery" ], "security": [], "responses": { "200": { "description": "OK" } } } }, "/v1/vat": { "post": { "operationId": "vat", "summary": "vat (paid, $0.003 USDC on Base)", "tags": [ "Paid" ], "description": "Validate an EU/EEA VAT number. Give {country_code, vat_number}; get a per-country format + checksum pre-check AND a LIVE lookup against the official VIES service — returning valid/registered plus the registered company name & address when VIES provides them (results cached ~1h to shield the flaky VIES). Read-only, stateless.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.003000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxAmountRequired": "3000", "payTo": "0xccB5d25C698FdfdaA7B21d54088774cF512A90e3", "resource": "https://valid.fabtally.com/v1/vat", "facilitator": "https://facilitator.daydreams.systems", "maxTimeoutSeconds": 60 } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "country_code": "IE", "vat_number": "6388047V" } } } }, "responses": { "200": { "description": "Result", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad input (never charged)" }, "402": { "description": "Payment Required (x402 v2 challenge)" } } } }, "/v1/vat/free": { "post": { "operationId": "vat_free", "summary": "vat — rate-limited free teaser", "tags": [ "Free" ], "security": [], "description": "Free teaser for vat (daily per-IP quota).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "country_code": "IE", "vat_number": "6388047V" } } } }, "responses": { "200": { "description": "Teaser result" }, "429": { "description": "Free daily quota exceeded" } } } }, "/v1/iban": { "post": { "operationId": "iban", "summary": "iban (paid, $0.001 USDC on Base)", "tags": [ "Paid" ], "description": "Validate an IBAN. Give {iban}; get ISO 13616 length + mod-97 checksum validation, the country, the human-formatted grouping, and the bank identifier (e.g. German Bankleitzahl, UK bank+sort code) extracted from the BBAN where the layout makes it derivable. Pure-offline, read-only, stateless.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.001000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxAmountRequired": "1000", "payTo": "0xccB5d25C698FdfdaA7B21d54088774cF512A90e3", "resource": "https://valid.fabtally.com/v1/iban", "facilitator": "https://facilitator.daydreams.systems", "maxTimeoutSeconds": 60 } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "iban": "DE89 3704 0044 0532 0130 00" } } } }, "responses": { "200": { "description": "Result", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad input (never charged)" }, "402": { "description": "Payment Required (x402 v2 challenge)" } } } }, "/v1/iban/free": { "post": { "operationId": "iban_free", "summary": "iban — rate-limited free teaser", "tags": [ "Free" ], "security": [], "description": "Free teaser for iban (daily per-IP quota).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "iban": "DE89 3704 0044 0532 0130 00" } } } }, "responses": { "200": { "description": "Teaser result" }, "429": { "description": "Free daily quota exceeded" } } } }, "/v1/email": { "post": { "operationId": "email", "summary": "email (paid, $0.002 USDC on Base)", "tags": [ "Paid" ], "description": "Validate an email address. Give {email}; get RFC-ish syntax validation, a LIVE MX-record (DNS) existence check, disposable/throwaway-domain detection (bundled blocklist), and a role-address flag (info@, admin@…). STATELESS and non-PII: the address is never stored and no SMTP mailbox is ever probed.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxAmountRequired": "2000", "payTo": "0xccB5d25C698FdfdaA7B21d54088774cF512A90e3", "resource": "https://valid.fabtally.com/v1/email", "facilitator": "https://facilitator.daydreams.systems", "maxTimeoutSeconds": 60 } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "email": "jane.doe@gmail.com" } } } }, "responses": { "200": { "description": "Result", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad input (never charged)" }, "402": { "description": "Payment Required (x402 v2 challenge)" } } } }, "/v1/email/free": { "post": { "operationId": "email_free", "summary": "email — rate-limited free teaser", "tags": [ "Free" ], "security": [], "description": "Free teaser for email (daily per-IP quota).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "email": "jane.doe@gmail.com" } } } }, "responses": { "200": { "description": "Teaser result" }, "429": { "description": "Free daily quota exceeded" } } } }, "/v1/geo": { "post": { "operationId": "geo", "summary": "geo (paid, $0.002 USDC on Base)", "tags": [ "Paid" ], "description": "Resolve a place against a bundled open dataset (no per-day API limits). Give {query:\"Munich, Bavaria, Germany\"} OR {country,state,city}; get normalized names, ISO 3166-1/-2 codes, the country→subdivision→city hierarchy, population and coordinates, and confirmation the place exists. Read-only, stateless.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxAmountRequired": "2000", "payTo": "0xccB5d25C698FdfdaA7B21d54088774cF512A90e3", "resource": "https://valid.fabtally.com/v1/geo", "facilitator": "https://facilitator.daydreams.systems", "maxTimeoutSeconds": 60 } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "query": "Munich, Bavaria, Germany" } } } }, "responses": { "200": { "description": "Result", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad input (never charged)" }, "402": { "description": "Payment Required (x402 v2 challenge)" } } } }, "/v1/geo/free": { "post": { "operationId": "geo_free", "summary": "geo — rate-limited free teaser", "tags": [ "Free" ], "security": [], "description": "Free teaser for geo (daily per-IP quota).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "query": "Munich, Bavaria, Germany" } } } }, "responses": { "200": { "description": "Teaser result" }, "429": { "description": "Free daily quota exceeded" } } } }, "/v1/vin": { "post": { "operationId": "vin", "summary": "vin (paid, $0.002 USDC on Base)", "tags": [ "Paid" ], "description": "Decode a Vehicle Identification Number. Give {vin}; get a 17-char format + North-American check-digit validation and a full decode via NHTSA's public vPIC API — make, model, year, body class, engine, plant country and more. VIN-only (never plate→owner). Read-only, stateless.", "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.002000" }, "protocols": [ { "x402": { "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "maxAmountRequired": "2000", "payTo": "0xccB5d25C698FdfdaA7B21d54088774cF512A90e3", "resource": "https://valid.fabtally.com/v1/vin", "facilitator": "https://facilitator.daydreams.systems", "maxTimeoutSeconds": 60 } } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "vin": "1HGCM82633A004352" } } } }, "responses": { "200": { "description": "Result", "content": { "application/json": { "schema": { "type": "object" } } } }, "400": { "description": "Bad input (never charged)" }, "402": { "description": "Payment Required (x402 v2 challenge)" } } } }, "/v1/vin/free": { "post": { "operationId": "vin_free", "summary": "vin — rate-limited free teaser", "tags": [ "Free" ], "security": [], "description": "Free teaser for vin (daily per-IP quota).", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object" }, "example": { "vin": "1HGCM82633A004352" } } } }, "responses": { "200": { "description": "Teaser result" }, "429": { "description": "Free daily quota exceeded" } } } } } }