curl --request POST \
--url https://api.codaclean.io/v1/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'{
"records": [
{
"id": "675b4183d350b74dad2f46ec",
"enterpriseNumber": "0764.042.472",
"name": "Boulangerie Dupont SRL",
"accountingRef": "DUPONT",
"address": {
"street": "Rue du Marché 12",
"street2": "",
"zipCode": "1000",
"municipality": "Bruxelles",
"country": "Belgique"
},
"contact": {
"name": "Marie Dupont",
"function": "CEO",
"email": "marie.dupont@example.com",
"language": "nl"
},
"isConfidential": false,
"bankAccounts": [
{
"iban": "BE49001163522171",
"currency": "EUR",
"bic": "GEBA BE BB",
"bankName": "BNP Paribas Fortis"
},
{
"iban": "BE68001466139034",
"currency": "EUR",
"bic": "GEBA BE BB",
"bankName": "BNP Paribas Fortis"
},
{
"iban": "BE40751680738663",
"currency": "EUR",
"bic": "AXAB BE 22",
"bankName": "Crelan"
},
{
"iban": "BE10732141110904",
"currency": "EUR",
"bic": "CREG BE BB",
"bankName": "CBC Banque et Assurances"
},
{
"iban": "BE79104034016533",
"currency": "EUR",
"bic": "NICA BE BB",
"bankName": "Crelan"
},
{
"iban": "BE21103265210903",
"currency": "EUR",
"bic": "NICA BE BB",
"bankName": "Crelan"
}
],
"payrollProviders": [
{
"code": "sdworx",
"nameFr": "SD Worx",
"nameNl": "SD Worx"
},
{
"code": "twinntax",
"nameFr": "TwinnTax",
"nameNl": "TwinnTax"
}
],
"createdOn": "2024-12-12T20:03:15.277Z",
"updatedOn": "2026-06-30T10:30:16.368Z"
},
{
"id": "675b41d6d350b74dad2f46ed",
"enterpriseNumber": "0755.556.457",
"name": "Garage Peeters BV",
"accountingRef": "PEETERS",
"address": {
"street": "Kerkstraat 25",
"street2": "",
"zipCode": "1050",
"municipality": "Bruxelles",
"country": "Belgique"
},
"contact": {
"name": "Jan Peeters",
"function": "CEO",
"email": "jan.peeters@example.com",
"language": "en"
},
"isConfidential": false,
"bankAccounts": [
{
"iban": "BE59732578835326",
"currency": "EUR",
"bic": "CREG BE BB",
"bankName": "CBC Banque et Assurances"
},
{
"iban": "BE87088425005794",
"currency": "EUR",
"bic": "GKCC BE BB",
"bankName": "BELFIUS BANQUE"
},
{
"iban": "BE42088136494654",
"currency": "EUR",
"bic": "GKCC BE BB",
"bankName": "BELFIUS BANQUE"
}
],
"payrollProviders": [
{
"code": "partena_professional",
"nameFr": "Partena Professional",
"nameNl": "Partena Professional"
},
{
"code": "twinntax",
"nameFr": "TwinnTax",
"nameNl": "TwinnTax"
},
{
"code": "***other***",
"nameFr": "Autre secrétariat social (*)",
"nameNl": "Andere sociale secretariaat (*)"
}
],
"createdOn": "2024-12-12T20:04:38.056Z",
"updatedOn": "2026-01-26T09:23:05.991Z"
}
],
"recordsTotal": 2,
"recordsFiltered": 2
}Rechercher des clients
Paginated, filterable list of the customers visible to the user, sorted by name.
Only customers the user can access are included: usually all the accounting firm’s customers, or only some of them if the firm restricted the user in MyCodaclean.
Required scope: customers:read
POST
/
customers
curl --request POST \
--url https://api.codaclean.io/v1/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{}'{
"records": [
{
"id": "675b4183d350b74dad2f46ec",
"enterpriseNumber": "0764.042.472",
"name": "Boulangerie Dupont SRL",
"accountingRef": "DUPONT",
"address": {
"street": "Rue du Marché 12",
"street2": "",
"zipCode": "1000",
"municipality": "Bruxelles",
"country": "Belgique"
},
"contact": {
"name": "Marie Dupont",
"function": "CEO",
"email": "marie.dupont@example.com",
"language": "nl"
},
"isConfidential": false,
"bankAccounts": [
{
"iban": "BE49001163522171",
"currency": "EUR",
"bic": "GEBA BE BB",
"bankName": "BNP Paribas Fortis"
},
{
"iban": "BE68001466139034",
"currency": "EUR",
"bic": "GEBA BE BB",
"bankName": "BNP Paribas Fortis"
},
{
"iban": "BE40751680738663",
"currency": "EUR",
"bic": "AXAB BE 22",
"bankName": "Crelan"
},
{
"iban": "BE10732141110904",
"currency": "EUR",
"bic": "CREG BE BB",
"bankName": "CBC Banque et Assurances"
},
{
"iban": "BE79104034016533",
"currency": "EUR",
"bic": "NICA BE BB",
"bankName": "Crelan"
},
{
"iban": "BE21103265210903",
"currency": "EUR",
"bic": "NICA BE BB",
"bankName": "Crelan"
}
],
"payrollProviders": [
{
"code": "sdworx",
"nameFr": "SD Worx",
"nameNl": "SD Worx"
},
{
"code": "twinntax",
"nameFr": "TwinnTax",
"nameNl": "TwinnTax"
}
],
"createdOn": "2024-12-12T20:03:15.277Z",
"updatedOn": "2026-06-30T10:30:16.368Z"
},
{
"id": "675b41d6d350b74dad2f46ed",
"enterpriseNumber": "0755.556.457",
"name": "Garage Peeters BV",
"accountingRef": "PEETERS",
"address": {
"street": "Kerkstraat 25",
"street2": "",
"zipCode": "1050",
"municipality": "Bruxelles",
"country": "Belgique"
},
"contact": {
"name": "Jan Peeters",
"function": "CEO",
"email": "jan.peeters@example.com",
"language": "en"
},
"isConfidential": false,
"bankAccounts": [
{
"iban": "BE59732578835326",
"currency": "EUR",
"bic": "CREG BE BB",
"bankName": "CBC Banque et Assurances"
},
{
"iban": "BE87088425005794",
"currency": "EUR",
"bic": "GKCC BE BB",
"bankName": "BELFIUS BANQUE"
},
{
"iban": "BE42088136494654",
"currency": "EUR",
"bic": "GKCC BE BB",
"bankName": "BELFIUS BANQUE"
}
],
"payrollProviders": [
{
"code": "partena_professional",
"nameFr": "Partena Professional",
"nameNl": "Partena Professional"
},
{
"code": "twinntax",
"nameFr": "TwinnTax",
"nameNl": "TwinnTax"
},
{
"code": "***other***",
"nameFr": "Autre secrétariat social (*)",
"nameNl": "Andere sociale secretariaat (*)"
}
],
"createdOn": "2024-12-12T20:04:38.056Z",
"updatedOn": "2026-01-26T09:23:05.991Z"
}
],
"recordsTotal": 2,
"recordsFiltered": 2
}Autorisations
Identifies the partner software. Issued by Codaclean. Required on every call, including POST /token.
Identifies the user and their accounting firm. Send the idToken returned by POST /token as Authorization: Bearer <idToken>. Valid for 1 hour.
Corps
application/json
Case-insensitive search on name, enterprise number and accounting reference.
Exact match, formatted 0123.456.789.
Exact match.
Exact match on an active bank account. Spaces are ignored.
Plage requise:
x <= 200
