Retrieve Finvoice Credentials#
This endpoint retrieves electronic invoicing (Finvoice) registry information for a Finnish company using its Business ID (Y-tunnus). The data is sourced from the national Finvoice registry and returns the e-invoicing addresses and operator details that the specified business has registered for receiving electronic invoices.This endpoint is provided at no additional cost to partners.
The service is optimized for low-latency responses and is suitable for real-time use cases.
How it works#
When a valid Business ID is provided, the service queries the Finvoice registry and returns all matching e-invoicing address records associated with that company.A single company may have:Multiple e-invoice addresses
Different address types for different invoicing channels
Response structure#
Each item in the response represents one registered e-invoicing address and includes:eInvoiceAddressName – Name of the recipient organization as registered
eInvoiceAddress – The electronic invoicing address (e.g., EDI or IBAN-based identifier)
eInvoiceAddressType – Code defining the address format/type (e.g., EDI, IBAN)
eInvoiceOperatorId – Identifier of the e-invoicing operator
eInvoiceOperatorName – Name of the operator providing the e-invoicing service
lastModified – Timestamp of when the record was last updated in the registry
Client responsibility#
The API does not determine which e-invoicing address should be used.
If multiple records are returned, the client application is responsible for:Selecting the appropriate e-invoicing address
Applying any business rules or user preferences
Presenting options to end users when necessary
The endpoint is read-only and reflects the current state of the Finvoice registry. Data availability depends on the registry; not all businesses have registered e-invoicing details. An empty array indicates that no e-invoicing information was found for the given Business ID
