> ## 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.

# Quickstart

> Get your credentials, obtain an ID token, and make your first call to the Codaclean API.

This page takes you from zero to a first successful call.

You need an API key issued by Codaclean and a Codaclean user account.

User accounts are created and managed by the accounting firm in [MyCodaclean](https://app.codaclean.io).

**See also:** [Authentication](/api/authentication#user-accounts-and-token-scope)

<Steps>
  <Step title="Get an API key">
    Codaclean issues one API key per partner software.

    It identifies your software, not a specific accounting firm: the same key serves all the firms that use your software.

    <Card title="Request API access" icon="key" href="https://codaclean.be/fr-be/contact" horizontal>
      Contact Codaclean to get an API key.
    </Card>
  </Step>

  <Step title="Get an ID token">
    Call [`POST /token`](/api/endpoints/get-token) with the user's Codaclean `username` and their `password` **encoded in Base64**. Send your API key in the `x-api-key` header.

    The response contains an `idToken` and a `refreshToken`.

    **See also:** [Authentication](/api/authentication)
  </Step>

  <Step title="Make your first call">
    Call [`GET /hello`](/api/endpoints/hello) with both headers:

    | Header          | Value              |
    | --------------- | ------------------ |
    | `x-api-key`     | Your API key       |
    | `Authorization` | `Bearer <idToken>` |

    A `200` response confirms that both credentials are accepted.
  </Step>

  <Step title="Pick your use case">
    <CardGroup cols={2}>
      <Card title="Download CODA files" icon="building-columns" href="/api/guides/sync-coda-files">
        List new bank statements, download them, and acknowledge them.
      </Card>

      <Card title="Download CODB files" icon="users" href="/api/guides/sync-codb-files">
        Same flow for payroll files.
      </Card>

      <Card title="Onboard a customer" icon="building" href="/api/guides/onboard-customer">
        Create a customer and request its mandates.
      </Card>

      <Card title="Upload files" icon="upload" href="/api/guides/upload-files">
        Send CODA or CODB files to Codaclean.
      </Card>
    </CardGroup>
  </Step>
</Steps>

## Base URLs

| Environment | Base URL                           |
| ----------- | ---------------------------------- |
| Production  | `https://api.codaclean.io/v1`      |
| Staging     | `https://api.test.codaclean.io/v1` |

**See also:** [Environments](/api/environments)