curl --request POST \
  --url https://api.codaclean.io/v1/coda-files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "redownload": true
}
'

[
  {
    "id": "675b4183d350b74dad2f46ec",
    "name": "Boulangerie Dupont SRL",
    "accountingRef": "DUPONT",
    "enterpriseNumber": "0764.042.472",
    "isConfidential": false,
    "ibans": [
      {
        "iban": "BE49001163522171",
        "currency": "EUR",
        "year": 2022,
        "files": [
          {
            "id": "675b42981fbd2b49ba0c2c1a",
            "fileName": "039_CODA_20220314_BE49001163522171_EUR.cod",
            "statementDate": "2022-03-14T00:00:00.000Z",
            "statementNumber": "039",
            "processedOn": "2024-12-12T20:08:13.466Z",
            "urls": {
              "coda": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2022/BE49001163522171/039_CODA_20220314_BE49001163522171_EUR.cod?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427808&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%22039_CODA_20220314_BE49001163522171_EUR.cod%22"
            }
          },
          {
            "id": "675b429a62c7a588e3e68af7",
            "fileName": "040_CODA_20220316_BE49001163522171_EUR.cod",
            "statementDate": "2022-03-16T00:00:00.000Z",
            "statementNumber": "040",
            "processedOn": "2024-12-12T20:08:15.545Z",
            "urls": {
              "coda": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2022/BE49001163522171/040_CODA_20220316_BE49001163522171_EUR.cod?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427808&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%22040_CODA_20220316_BE49001163522171_EUR.cod%22"
            }
          }
        ]
      }
    ]
  },
  {
    "id": "675b41d6d350b74dad2f46ed",
    "name": "Garage Peeters BV",
    "accountingRef": "PEETERS",
    "enterpriseNumber": "0755.556.457",
    "isConfidential": false,
    "ibans": [
      {
        "iban": "BE59732578835326",
        "currency": "EUR",
        "year": 2022,
        "files": [
          {
            "id": "675b42986328595712f5b7c0",
            "fileName": "073_CODA_20220329_BE59732578835326_EUR.cod",
            "statementDate": "2022-03-29T00:00:00.000Z",
            "statementNumber": "073",
            "processedOn": "2024-12-12T20:08:13.605Z",
            "urls": {
              "coda": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/PEETERS/2022/BE59732578835326/073_CODA_20220329_BE59732578835326_EUR.cod?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427808&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%22073_CODA_20220329_BE59732578835326_EUR.cod%22"
            }
          },
          {
            "id": "675b42b174428167bf2b4210",
            "fileName": "074_CODA_20220330_BE59732578835326_EUR.cod",
            "statementDate": "2022-03-30T00:00:00.000Z",
            "statementNumber": "074",
            "processedOn": "2024-12-12T20:08:21.123Z",
            "urls": {
              "coda": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/PEETERS/2022/BE59732578835326/074_CODA_20220330_BE59732578835326_EUR.cod?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427808&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%22074_CODA_20220330_BE59732578835326_EUR.cod%22"
            }
          }
        ]
      }
    ]
  }
]

List CODA files

Processed CODA files, grouped by customer, then by IBAN, currency and year.

Each file comes with a pre-signed download URL, valid for 30 minutes.

Files already acknowledged with this API key and user are hidden, unless redownload is true.

The list is not paginated. Only files of customers the user can access are included.

Files arrive in the morning: polling twice a day is enough.

Always send a JSON body, at least {}.

Required scope: files:read

POST

coda-files

curl --request POST \
  --url https://api.codaclean.io/v1/coda-files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "redownload": true
}
'

[
  {
    "id": "675b4183d350b74dad2f46ec",
    "name": "Boulangerie Dupont SRL",
    "accountingRef": "DUPONT",
    "enterpriseNumber": "0764.042.472",
    "isConfidential": false,
    "ibans": [
      {
        "iban": "BE49001163522171",
        "currency": "EUR",
        "year": 2022,
        "files": [
          {
            "id": "675b42981fbd2b49ba0c2c1a",
            "fileName": "039_CODA_20220314_BE49001163522171_EUR.cod",
            "statementDate": "2022-03-14T00:00:00.000Z",
            "statementNumber": "039",
            "processedOn": "2024-12-12T20:08:13.466Z",
            "urls": {
              "coda": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2022/BE49001163522171/039_CODA_20220314_BE49001163522171_EUR.cod?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427808&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%22039_CODA_20220314_BE49001163522171_EUR.cod%22"
            }
          },
          {
            "id": "675b429a62c7a588e3e68af7",
            "fileName": "040_CODA_20220316_BE49001163522171_EUR.cod",
            "statementDate": "2022-03-16T00:00:00.000Z",
            "statementNumber": "040",
            "processedOn": "2024-12-12T20:08:15.545Z",
            "urls": {
              "coda": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2022/BE49001163522171/040_CODA_20220316_BE49001163522171_EUR.cod?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427808&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%22040_CODA_20220316_BE49001163522171_EUR.cod%22"
            }
          }
        ]
      }
    ]
  },
  {
    "id": "675b41d6d350b74dad2f46ed",
    "name": "Garage Peeters BV",
    "accountingRef": "PEETERS",
    "enterpriseNumber": "0755.556.457",
    "isConfidential": false,
    "ibans": [
      {
        "iban": "BE59732578835326",
        "currency": "EUR",
        "year": 2022,
        "files": [
          {
            "id": "675b42986328595712f5b7c0",
            "fileName": "073_CODA_20220329_BE59732578835326_EUR.cod",
            "statementDate": "2022-03-29T00:00:00.000Z",
            "statementNumber": "073",
            "processedOn": "2024-12-12T20:08:13.605Z",
            "urls": {
              "coda": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/PEETERS/2022/BE59732578835326/073_CODA_20220329_BE59732578835326_EUR.cod?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427808&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%22073_CODA_20220329_BE59732578835326_EUR.cod%22"
            }
          },
          {
            "id": "675b42b174428167bf2b4210",
            "fileName": "074_CODA_20220330_BE59732578835326_EUR.cod",
            "statementDate": "2022-03-30T00:00:00.000Z",
            "statementNumber": "074",
            "processedOn": "2024-12-12T20:08:21.123Z",
            "urls": {
              "coda": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/PEETERS/2022/BE59732578835326/074_CODA_20220330_BE59732578835326_EUR.cod?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427808&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%22074_CODA_20220330_BE59732578835326_EUR.cod%22"
            }
          }
        ]
      }
    ]
  }
]

Authorizations

x-api-key

string

header

required

Identifies the partner software. Issued by Codaclean. Required on every call, including POST /token.

Authorization

string

header

required

Identifies the user and their accounting firm. Send the idToken returned by POST /token as Authorization: Bearer <idToken>. Valid for 1 hour.

Body

application/json

redownload

boolean

default:false

By default, files already acknowledged with this API key and user are hidden. Set to true to list them again.

customer

string

Customer name.

enterpriseNumber

string

Belgian enterprise number, formatted 0123.456.789.

iban

string

currency

string

statementDate

object

Statement date range (inclusive).

Show child attributes

processingDate

object

Range (inclusive) on the date Codaclean processed the file.

Show child attributes

statementNumber

object

Statement number range (inclusive).

Show child attributes

includePdf

boolean

default:false

Also return a download URL for the PDF version of each file.

Response

Matching files, grouped by customer.

string

Customer identifier.

name

string

accountingRef

string

enterpriseNumber

string

Belgian enterprise number, formatted 0123.456.789.

isConfidential

boolean

ibans

object[]

One entry per IBAN, currency and statement year.

Show child attributes

Get started

Concepts

Guides

Authentication

Utilities

Customers

Bank accounts

Customer payroll providers

Mandates

Reference data

CODA files

CODB files

List CODA files

Authorizations

Body

Response