Request a bank account lookup verification

To initiate a new bank account lookup verification, send the IBAN along with the expected holder's details using the following endpoint:

POST /verifications/bank_account_lookups

curl --location --request POST '{baseUrl}/verifications/bank_account_lookups' \
--header 'Authorization: Bearer {apiKey}' \
--header "Content-Type: application/json" \
-d '{
    "iban": "FR8610559870736553282944457",
    "natural_person": {
      "first_name": "John",
      "last_name": "Doe"
    }
  }'

curl --location --request POST '{baseUrl}/verifications/bank_account_lookups' \
--header 'Authorization: Bearer {apiKey}' \
--header "Content-Type: application/json" \
-d '{
    "iban": "FR8610559870736553282944457",
		"legal_person": {
      "company_number": "794513986"
  	}
  }'

{
    "id": "4fe46d9a-ef9c-4f1e-87c3-fb8b00b1f693",
    "workspace_id": "6ed2772f-8d7e-4f67-ab2a-790a1dce2adc",
    "created_at": "2025-07-25T09:41:08+00:00",
    "updated_at": "2025-07-25T09:41:08+00:00",
    "status": "pending",
    "status_codes": []
}

To verify an IBAN whose holder is a natural person

Query Param	Type	Description
iban	string	[required] The International Bank Account Number (IBAN) to verify. It must be a valid IBAN starting with "FR". Also, the IBAN must belong to a bank account that is a member of the SEPAmail DIAMOND network. You can find the list of the members on this page.
natural_person[first_name]	string	[required] The first name of the bank account holder. You can't send `legal_person`at the same time.
natural_person[last_name]	string	[required] The last name of the bank account holder. You can't send `legal_person`at the same time.
legal_person[company_number]	string	[required] The company number. SIREN or SIRET in France. You can't send `natural_person`at the same time.
workspace_id	string	[optional] Scopes the verification to a specific workspace. Defaults to the main workspace if not specified.

In the response, you'll find the id. This value is required to retrieve the verification results.

📘
Rules regarding natural_person verification
We do not process joint accounts directly. SEPAmail Diamond manages name matching afterward. Banks operate differently for joint accounts (e.g., "Jean Dupont" or "Jean et Marine Dupont"). We recommend retrying with other name combinations if the returned score is "orange" or "red" (e.g., "Dupont Jean"). SEPAmail Diamond accepts either name for matching:

For "Jean et Marine Dupont," both "Jean Dupont" and "Marine Dupont" are accepted.

For "Jean Dupont et Marine Renard," both "Jean Dupont" and "Marine Renard" are accepted, but "Jean Renard" is not.

For compound names, hyphens are preserved, and special characters are replaced with their plain equivalents before processing with SEPAmail Diamond (e.g., "Jean-François" becomes "JEAN-FRANCOIS" and "Jean-René" becomes "JEAN-RENE").

Specific Cases for Special Characters:

Apostrophes and spaces are treated as distinct characters. For example: "d'Alembert," "Dalembert," and "D alembert" yield different scores.

Other special characters (:/,-_.()+@?) are treated as spaces, resulting in the same score for "d:Alembert," "d alembert," and "d?alembert."

To verify an IBAN whose holder is a natural person

📘Rules regarding natural_person verification

📘
Rules regarding natural_person verification