Retrieve Finvoice Credentials

GET

https://api.cash-in.com/v2/finvoiceregistry

This API endpoint retrieves Finvoice Registry credentials for the specified business identifier (Finnish Business ID / Y-tunnus). The same information is available through the Finnish e-invoice address registry at verkkolaskuosoitteisto.fi, but this endpoint provides a faster and more convenient way to retrieve the required details programmatically. The endpoint returns an array of records. If multiple registry entries exist for the business, all matching records are included in the response.

The business ID can be provided in multiple formats, for example 1234567-8 or 12345678. Both formats are supported and will return matching registry records if available.

Partner Access Control

Use your Partner-level API key in the X-Api-Key header.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Responses

🟢200Success

application/json

Finvoice registry credentials retrieved successfully

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cash-in.com/v2/finvoiceregistry?businessId=undefined' \
--header 'X-Api-Key: <api-key>'

Response Example

200 - Credentials found

[
    {
        "EInvoiceAddressName": "Cash-In Consulting Oy Ab",
        "EInvoiceAddress": "FIXXXXXXXXXXXXXXXX",
        "EInvoiceAddressType": "0216",
        "EInvoiceOperatorId": "DABAFIHH",
        "EInvoiceOperatorName": "Danske Bank A/S, Suomen sivuliike",
        "LastModified": "2020-12-01T21:08:39.844033"
    }
]

Retrieve Creditor Credentials

Retrieve External Agreement Identifiers