curl --request POST \
  --url https://api.codaclean.io/v1/codb-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,
    "payrollProviders": [
      {
        "payrollProvider": "Twinntax",
        "year": 2025,
        "files": [
          {
            "id": "68f4fadfc617c0d3dd9b2f7f",
            "fileName": "0006_CODB_TWINNTAX_BE0764042472_202506_20250630.xml",
            "statementDate": "2025-06-30",
            "statementNumber": 6,
            "accountPeriod": 202506,
            "processedOn": "2025-10-19T14:51:43.797Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2025/CODB/0006_CODB_TWINNTAX_BE0764042472_202506_20250630.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220006_CODB_TWINNTAX_BE0764042472_202506_20250630.xml%22"
            }
          },
          {
            "id": "68f4fadf189b5fcd1ef94461",
            "fileName": "0007_CODB_TWINNTAX_BE0764042472_202507_20250731.xml",
            "statementDate": "2025-07-31",
            "statementNumber": 7,
            "accountPeriod": 202507,
            "processedOn": "2025-10-19T14:51:43.713Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2025/CODB/0007_CODB_TWINNTAX_BE0764042472_202507_20250731.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220007_CODB_TWINNTAX_BE0764042472_202507_20250731.xml%22"
            }
          }
        ]
      },
      {
        "payrollProvider": "sdworx",
        "year": 2025,
        "files": [
          {
            "id": "68f39c9f50d2196899901d8f",
            "fileName": "0001_CODB_SDWORX_BE0764042472_202501_20250128.xml",
            "statementDate": "2025-01-28",
            "statementNumber": 1,
            "accountPeriod": 202501,
            "processedOn": "2025-11-12T13:57:19.938Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2025/CODB/0001_CODB_SDWORX_BE0764042472_202501_20250128.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220001_CODB_SDWORX_BE0764042472_202501_20250128.xml%22"
            }
          },
          {
            "id": "68f39ca1b8e50f5763f91c53",
            "fileName": "0002_CODB_SDWORX_BE0764042472_202501_20250129.xml",
            "statementDate": "2025-01-29",
            "statementNumber": 2,
            "accountPeriod": 202501,
            "processedOn": "2025-10-18T13:57:20.073Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2025/CODB/0002_CODB_SDWORX_BE0764042472_202501_20250129.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220002_CODB_SDWORX_BE0764042472_202501_20250129.xml%22"
            }
          }
        ]
      }
    ]
  },
  {
    "id": "675b41d6d350b74dad2f46ed",
    "name": "Garage Peeters BV",
    "accountingRef": "PEETERS",
    "enterpriseNumber": "0755.556.457",
    "isConfidential": false,
    "payrollProviders": [
      {
        "payrollProvider": "partena_professional",
        "year": 2025,
        "files": [
          {
            "id": "68f39c9f9cb1e80ff7f7bf21",
            "fileName": "0001_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml",
            "statementDate": "2025-02-05",
            "statementNumber": 1,
            "accountPeriod": 202501,
            "processedOn": "2025-11-12T13:57:19.767Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/PEETERS/2025/CODB/0001_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220001_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml%22"
            }
          },
          {
            "id": "68f39ca1b211cc722e5fa9bc",
            "fileName": "0002_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml",
            "statementDate": "2025-02-05",
            "statementNumber": 2,
            "accountPeriod": 202501,
            "processedOn": "2025-10-18T13:57:22.042Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/PEETERS/2025/CODB/0002_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220002_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml%22"
            }
          }
        ]
      }
    ]
  }
]

CODB-bestanden oplijsten

Processed CODB files, grouped by customer, then by payroll provider 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

codb-files

curl --request POST \
  --url https://api.codaclean.io/v1/codb-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,
    "payrollProviders": [
      {
        "payrollProvider": "Twinntax",
        "year": 2025,
        "files": [
          {
            "id": "68f4fadfc617c0d3dd9b2f7f",
            "fileName": "0006_CODB_TWINNTAX_BE0764042472_202506_20250630.xml",
            "statementDate": "2025-06-30",
            "statementNumber": 6,
            "accountPeriod": 202506,
            "processedOn": "2025-10-19T14:51:43.797Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2025/CODB/0006_CODB_TWINNTAX_BE0764042472_202506_20250630.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220006_CODB_TWINNTAX_BE0764042472_202506_20250630.xml%22"
            }
          },
          {
            "id": "68f4fadf189b5fcd1ef94461",
            "fileName": "0007_CODB_TWINNTAX_BE0764042472_202507_20250731.xml",
            "statementDate": "2025-07-31",
            "statementNumber": 7,
            "accountPeriod": 202507,
            "processedOn": "2025-10-19T14:51:43.713Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2025/CODB/0007_CODB_TWINNTAX_BE0764042472_202507_20250731.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220007_CODB_TWINNTAX_BE0764042472_202507_20250731.xml%22"
            }
          }
        ]
      },
      {
        "payrollProvider": "sdworx",
        "year": 2025,
        "files": [
          {
            "id": "68f39c9f50d2196899901d8f",
            "fileName": "0001_CODB_SDWORX_BE0764042472_202501_20250128.xml",
            "statementDate": "2025-01-28",
            "statementNumber": 1,
            "accountPeriod": 202501,
            "processedOn": "2025-11-12T13:57:19.938Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2025/CODB/0001_CODB_SDWORX_BE0764042472_202501_20250128.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220001_CODB_SDWORX_BE0764042472_202501_20250128.xml%22"
            }
          },
          {
            "id": "68f39ca1b8e50f5763f91c53",
            "fileName": "0002_CODB_SDWORX_BE0764042472_202501_20250129.xml",
            "statementDate": "2025-01-29",
            "statementNumber": 2,
            "accountPeriod": 202501,
            "processedOn": "2025-10-18T13:57:20.073Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/DUPONT/2025/CODB/0002_CODB_SDWORX_BE0764042472_202501_20250129.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220002_CODB_SDWORX_BE0764042472_202501_20250129.xml%22"
            }
          }
        ]
      }
    ]
  },
  {
    "id": "675b41d6d350b74dad2f46ed",
    "name": "Garage Peeters BV",
    "accountingRef": "PEETERS",
    "enterpriseNumber": "0755.556.457",
    "isConfidential": false,
    "payrollProviders": [
      {
        "payrollProvider": "partena_professional",
        "year": 2025,
        "files": [
          {
            "id": "68f39c9f9cb1e80ff7f7bf21",
            "fileName": "0001_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml",
            "statementDate": "2025-02-05",
            "statementNumber": 1,
            "accountPeriod": 202501,
            "processedOn": "2025-11-12T13:57:19.767Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/PEETERS/2025/CODB/0001_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220001_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml%22"
            }
          },
          {
            "id": "68f39ca1b211cc722e5fa9bc",
            "fileName": "0002_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml",
            "statementDate": "2025-02-05",
            "statementNumber": 2,
            "accountPeriod": 202501,
            "processedOn": "2025-10-18T13:57:22.042Z",
            "urls": {
              "codb": "https://codaclean-files.s3.eu-west-1.amazonaws.com/3f1c2a9e-7b4d-4e8a-9c21-5d6e7f8a9b0c/PEETERS/2025/CODB/0002_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml?AWSAccessKeyId=ASIAIOSFODNN7EXAMPLE&Expires=1790427811&Signature=EXAMPLE_SIGNATURE&x-amz-security-token=IQoJb3JpZ2luX2VjEXAMPLE_SESSION_TOKEN&response-content-disposition=attachment%3B+filename%3D%220002_CODB_PARTENA_PROFESSIONAL_BE0755556457_202501_20250205.xml%22"
            }
          }
        ]
      }
    ]
  }
]

Autorisaties

x-api-key

string

header

vereist

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

Authorization

string

header

vereist

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

standaard: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.

payrollProvider

string

Payroll provider name as written in the files, as reported in payrollProviders[].payrollProvider (for example Twinntax).

accountPeriod

integer

Exact match on the account period of the file, as YYYYMM (for example 202609).

statementDate

object

Range (inclusive) on the generation date of the file (YYYY-MM-DD).

Show child attributes

processingDate

object

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

Show child attributes

statementNumber

object

Range (inclusive) on the sequence number of the file.

Show child attributes

includePdf

boolean

standaard:false

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

Respons

Matching files, grouped by customer.

string

Customer identifier.

name

string

accountingRef

string

enterpriseNumber

string

Belgian enterprise number, formatted 0123.456.789.

isConfidential

boolean

payrollProviders

object[]

One entry per payroll provider and year.

Show child attributes

Aan de slag

Concepten

Handleidingen

Authenticatie

Hulpmiddelen

Klanten

Bankrekeningen

Sociale secretariaten van de klant

Mandaten

Referentiegegevens

CODA-bestanden

CODB-bestanden

CODB-bestanden oplijsten

Autorisaties

Body

Respons