{"uid":"cap_wwGIN5l9fnwZSMrBbiXA-","slug":"finnish-vat-number-validator-alv-ad62fd85","name":"Finnish VAT Number Validator (ALV)","description":"Validate a Finnish VAT (ALV) number against the official VAT register. Validity means the entity exists and holds a live registration.","url":"https://vat.openverbs.com/v1/finland","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["vatNumber"],"properties":{"vatNumber":{"type":"string","maxLength":20,"minLength":8,"description":"Finnish VAT/ALV number — \"FI\" + the 8-digit Business ID (Y-tunnus). A leading \"FI\" and the \"1234567-8\" hyphen form are tolerated."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Uf7JLPBqEINFAuso01S_8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a Finnish VAT (ALV) number by checking it against the PRH/YTJ Tax Administration VAT register to confirm the entity exists and holds a live VAT registration.","exampleAgentPrompt":"Can you check whether FI12345678 is a valid, active Finnish VAT number — I need to confirm this supplier is registered in the Finnish Tax Administration VAT register before I process their invoice.","exampleUseCases":[{"title":"Invoice validation before payment","prompt":"Before I approve this Finnish supplier invoice, can you verify that their VAT number FI23456789 is active and registered in the Finnish Tax Administration VAT register?"},{"title":"Onboarding a new Finnish vendor","prompt":"We're onboarding a new vendor from Finland — their ALV number is FI98765432. Can you check if it's valid and actually registered in the Finnish VAT system?"},{"title":"Automated compliance check for EU invoices","prompt":"I have a Finnish company with VAT number FI11223344 that I need to run a compliance check on — can you confirm whether they hold a live entry in Finland's VAT register?"}],"resultDescription":"A response indicating whether the Finnish VAT number is valid — meaning the entity exists in the PRH/YTJ Business Information System and holds a live entry in the Finnish Tax Administration VAT register. Returns validity status and likely basic entity details if registered.","failureModes":["Invalid format: VAT number does not match FI + 8-digit pattern","Number not found: entity does not exist in the PRH/YTJ registry","Entity exists but not VAT registered: company exists but has no live VAT register entry","Network or upstream API error: PRH/YTJ open data API unavailable","Payment failure: x402 payment not processed, request rejected"],"whenToPreferThis":"Use this endpoint when you specifically need to validate a Finnish VAT (ALV) number against the official Finnish Tax Administration register via PRH/YTJ. Choose this over generic EU VIES lookups when you need authoritative Finnish-specific data directly from the source registry, or when VIES coverage for Finland is insufficient. Ideal for automating B2B compliance checks, vendor onboarding, and invoice validation workflows involving Finnish entities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:34:22.266Z","isFirstParty":false}