> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codaclean.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CODA-bestanden downloaden

> Vraag nieuwe bestanden met rekeninguittreksels op, download ze en bevestig elke download.

CODA-bestanden zijn rekeninguittreksels die Codaclean van de banken van uw klanten ontvangt.

De bestanden komen 's ochtends binnen: het volstaat om deze cyclus twee keer per dag te doorlopen.

<Steps>
  <Step title="Nieuwe bestanden opvragen">
    Roep [`POST /coda-files`](/nl/api/endpoints/list-coda-files) aan met een JSON-body, minstens `{}`.

    Standaard bevat het antwoord alleen bestanden die u nog niet hebt bevestigd.

    De bestanden zijn gegroepeerd per klant en vervolgens per IBAN, munt en jaar van het uittreksel.

    Nuttige filters: `enterpriseNumber`, `iban`, `statementDate`, `processingDate`, `statementNumber`.

    Zet `includePdf` op `true` om ook de pdf-versie van elk uittreksel te ontvangen.

    **Vereiste scope:** `files:read`
  </Step>

  <Step title="Elk bestand downloaden">
    Elk bestand bevat een link `urls.coda` (en `urls.pdf` als u daarom hebt gevraagd).

    Het gaat om vooraf ondertekende URL's: u downloadt ze met een gewone `GET`, zonder de API-headers.

    <Warning>
      Download-URL's verlopen **30 minuten** na de aanroep van de lijst. Is een URL verlopen, vraag de lijst dan opnieuw op om een nieuwe URL te krijgen.
    </Warning>
  </Step>

  <Step title="Elke download bevestigen">
    Zodra u een bestand aan uw kant hebt opgeslagen, roept u [`DELETE /coda-files/{fileId}`](/nl/api/endpoints/acknowledge-coda-file) aan met de `id` van het bestand.

    Het bestand wordt **niet** verwijderd. Het wordt voor uw API-sleutel en de huidige gebruiker als gedownload gemarkeerd, en verschijnt niet meer in de volgende lijst.

    Bevestigt u hetzelfde bestand twee keer, dan krijgt u `409`.
  </Step>
</Steps>

## Een bestand opnieuw downloaden

Wilt u bestanden opvragen die al bevestigd zijn, stuur dan `"redownload": true` mee.

Combineer dit met filters zoals `statementDate` om een bepaalde periode op te halen.

## Goed om te weten

* De lijst is niet gepagineerd. Bevestig de bestanden gaandeweg, zodat de antwoorden klein blijven.
* Bevestigingen gelden per API-sleutel en per gebruiker. Voor een andere gebruiker van uw software blijft het bestand nieuw.
* De lijst bevat alleen bestanden die Codaclean volledig heeft verwerkt.