# Get your MyCodabox mandates and CODA files through an API

> Read the CODA mandate and bank account statuses, a company's File List and the VOILA statuses from MyCodabox with one API call each. Or have a workflow check Mandates & Services each morning and email you the mandates that need a signature or show Problem.

Page: https://fous.com/automate/codabox
Updated: 2026-11-12

Works with your own MyCodabox account. Fous is an independent product.

## What you can build on MyCodabox

### Get CODA mandate statuses

Reads Mandates & Services > CODA > Manage: each company's CODA mandate status, the status of each bank account and, for Archived mandates, the stop reason.

- Takes: Mandate status (optional), company (optional)
- Returns: Company, bank, mandate status, bank account, bank account status, stop reason

### List a company's CODA files

Opens a company's File List tab and reads the CODA files of its active bank accounts and sub-accounts for a date range.

- Takes: Company, from date, to date
- Returns: CODA number, statement date, bank account, PDF and .cod available

### Check VOILA statuses

Reads the overview under Mandates & Services > VOILA, filtered by status, with each company's VOILA status.

- Takes: VOILA status (optional)
- Returns: Company, VOILA status

### Redeliver CODA files on demand

Selects CODA files in a company's File List and chooses Delivery on demand to send them again.

- Takes: Company, CODA numbers or a date range
- Returns: Company, CODA numbers redelivered, statement dates

## Automate MyCodabox with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### CODA mandates waiting on a signature or showing Problem

Starts: Every weekday at 8:00

1. Get the CODA mandate statuses from Mandates & Services > CODA > Manage.
2. Keep the mandates in Awaiting Signature or Problem, and the Archived ones with their stop reason.
3. Email you the list grouped by status, with company, bank and bank account status.

### CODA mandate status changes, posted to your own system

Starts: Every weekday at 17:00

1. Get the CODA mandate statuses for all companies.
2. Keep the mandates whose status changed since the last run.
3. Post company, bank, old and new mandate status and bank account statuses to your webhook.

### Expired VOILA invitations, weekly

Starts: Every Monday at 9:00

1. Check the VOILA statuses for Company Invitation Expired and Problem.
2. Stop when there are none.
3. Email you the companies to follow up, one line each with its VOILA status.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get CODA mandate statuses” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "www.mycodabox.com/get_coda_mandate_statuses",
    "input": {
      "mandate_status": "Bank Procedure"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "mandates": [
      {
        "company": "Acme BV",
        "bank": "Northwind Bank",
        "mandate_status": "Bank Procedure",
        "bank_accounts": [
          {
            "iban": "BE00 0000 0000 0101",
            "status": "Waiting for activation by the bank"
          }
        ],
        "stop_reason": null
      }
    ],
    "count": 1
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## MyCodabox’s own options

Codabox has an API, built for accounting software and sales-invoicing software: each call needs an X-Software-Company key requested from Codabox, and production access follows a demo and a smoke test. An accounting office receives CODA, SODA and invoices through its delivery method and manages mandates in MyCodabox.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Codabox API | Bank account mandate ordering, getting documents (CODA, SODA, purchase invoices and PDFs) and uploading sales invoices in UBL. | A software company's X-Software-Company key from Codabox, a demo and a production smoke test. Accountants get document access through Codabox support. |
| Delivery to your accounting software | CODA files as .cod and PDF, SODA, and VOILA invoices as PDF and XML, sent to your office's accounting software. | Accounts in green on the Manage screen are charged. Prices are under Environment > Services & pricing in MyCodabox. |
| MyCodabox by hand | Mandate and bank account statuses, the File List with .pdf and .cod downloads, Delivery on demand and the CARO invoice details Excel report. | A MyCodabox user invited by an Admin of your office. |

Read on November 12, 2026: [Codabox API v2 documentation](https://doc.codabox.com/apiv2/index.html), [Accountants' top questions](https://faq.codabox.com/en/support/solutions/articles/75000125077), [Bank account statuses in MyCodabox](https://faq.codabox.com/en/support/solutions/articles/75000031093).

## Signing in to MyCodabox

MyCodabox asks for your email address and password. Two-factor authentication with an authenticator app is optional, each user chooses it, and Admins invite users and decide which environments they reach. With Fous you sign in once through MyCodabox's own sign-in with your own account: the login is sealed with AES-256, never shown to code or AI agents, and an expired session is signed back in.

## Worth knowing

- **No transactions, no CODA**: A bank only produces a CODA file when there are transactions. A gap in the File List or a bank account at Waiting for first CODA file often means a quiet account, not a fault.
- **Two years of files to redeliver**: The File List goes back to the mandate start, up to 2 years, and Delivery on demand is free. Periods before activation need Request historical CODA and the client's consent in the banking app.
- **KBC and CBC need the account holder**: For KBC and CBC accounts the account holder must create the link in the banking app. A bank account waiting on that step shows Waiting for activation by account holder.
- **Admins decide who sees which environment**: Only Admins see Administration > Manage users, invite colleagues and grant environments. A method reads only the companies of the environments your own user can open.

## More in Accounting, tax and ERP software

- [CONTPAQi](https://fous.com/automate/contpaqi.md)
- [Comarch ERP Optima](https://fous.com/automate/comarch-erp-optima.md)
- [Cegid Loop](https://fous.com/automate/cegid-loop.md)
- [Domínio Sistemas](https://fous.com/automate/dominio-sistemas.md)
- [Xero Practice Manager](https://fous.com/automate/xero-practice-manager.md)
- [a3innuva](https://fous.com/automate/a3innuva.md)
- [Confirmation](https://fous.com/automate/confirmation.md)
- [Xero bank feeds](https://fous.com/automate/xero-bank-feeds.md)
- [Exact Online](https://fous.com/automate/exact-online.md)
- [Twinfield](https://fous.com/automate/twinfield.md)
- [Sage Intacct](https://fous.com/automate/sage-intacct.md)
- [CCH Axcess](https://fous.com/automate/cch-axcess.md)
- [TallyPrime](https://fous.com/automate/tallyprime.md)
- [TaxDome](https://fous.com/automate/taxdome.md)
- [Drake Tax](https://fous.com/automate/drake-tax.md)
- [Dext Prepare](https://fous.com/automate/dext-prepare.md)
- [Lexware Office](https://fous.com/automate/lexware-office.md)
- [MYOB Business](https://fous.com/automate/myob-business.md)
- [弥生会計](https://fous.com/automate/yayoi-kaikei.md)
- [SAP Concur](https://fous.com/automate/sap-concur.md)

Other industries: [Walmart Connect Ad Center](/automate/walmart-connect-ad-center), [Repco Navigator Pro](/automate/repco-navigator-pro), [Dealertrack uniFI](/automate/dealertrack-unifi), [ADP Workforce Now](/automate/adp-workforce-now), [Trimble Unity Construct](/automate/trimble-unity-construct), [1688](/automate/1688).

## Frequently asked questions

### Does Codabox have an API?

Yes, for accounting software and sales-invoicing software. Each call needs an X-Software-Company key that Codabox issues, and production access follows a demo and a smoke test. It covers mandate ordering, getting CODA, SODA and invoices, and uploading sales invoices. Accountants get document access through Codabox support.

### How do I see why a CODA mandate is not active yet?

Open Mandates & Services > CODA > Manage. The mandate status runs from Registered and In Preparation through Awaiting Signature, Signed and Bank Procedure to Active, and each bank account has its own status, such as Waiting for activation by the bank. Archived mandates show their stop reason.

### Can I get a CODA file again that never reached my software?

Yes. Open the company's File List tab, search by CODA number or date range, and download the .pdf and .cod files, or select them and choose Delivery on demand. Files go back to the mandate start, up to 2 years.

### Can I check all companies at once instead of one by one?

Mandates & Services > CODA > Manage shows the mandates of all your companies, and the VOILA overview lists every company and filters by status. With Fous, a workflow can read one of them on a schedule, keep what changed since the last run, and email you the result or post it to your own system by webhook.

### Is Fous affiliated with Codabox?

No. Fous is an independent product. You use it with your own MyCodabox account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of MyCodabox (Codabox). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.