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"
            }
          }
        ]
      }
    ]
  }
]

List CODB files

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"
            }
          }
        ]
      }
    ]
  }
]

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.

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

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

payrollProviders

object[]

One entry per payroll provider and year.

Show child attributes

Get started

Concepts

Guides

Authentication

Utilities

Customers

Bank accounts

Customer payroll providers

Mandates

Reference data

CODA files

CODB files

List CODB files

Authorizations

Body

Response