---
title: "Bancolombia Accounts"
method: POST
path: "/co/bancolombia/accounts/v1"
tags: ["Colombia", "Bancolombia"]
---

# Bancolombia Accounts

`POST /co/bancolombia/accounts/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/co/bancolombia/accounts/v1`
- Auth: HTTP bearer

Read the accounts the connected Bancolombia customer holds, with their type, currency and available balance. Runs as your organization's own Bancolombia connection.

Supports async delivery: set `Prefer: wait=N` for an inline result, pass `callback_url` to receive a POST when ready, or poll `GET /jobs/{id}`.

## Headers

- `Idempotency-Key` string
- `Prefer` string

## Request body

- object
  - `connection_id` string: Optional. Run as this connection (`conn_…`). Empty lets Croma pick among your organization's connections, moving to the next one when one reaches its daily allowance.
  - `callback_url` string, uri: POST the job result here when it finishes.

## Response `200`

Successful response

- BancolombiaAccountsResponse
  - `data` BancolombiaAccountsData, required
    - `count` number, required: Number of accounts returned.
    - `accounts` object[], required
      - `number` string, required: The account number.
      - `name` string, nullable, required: The product's name as Bancolombia shows it, usually the holder's name.
      - `custom_name` string, nullable, required: The nickname the customer gave the account, when they set one.
      - `type` 'savings' | 'checking' | 'credit_card' | 'other', required: The account kind: `savings` (ahorros), `checking` (corriente), `credit_card`, or `other`.
      - `type_raw` string, nullable, required: Bancolombia's own account-type label, e.g. `CUENTA_DE_AHORRO`.
      - `currency` string, required: The account's currency, ISO 4217, e.g. `COP`.
      - `status` string, nullable, required: The account's status as Bancolombia reports it, e.g. `ACTIVO`.
      - `plan_name` string, nullable, required: The product plan, e.g. `PLAN PREMIUM`, when given.
      - `available_balance` number, nullable, required: The available balance (saldo disponible), in the account's currency.
      - `current_balance` number, nullable, required: The current balance (saldo actual), in the account's currency.
      - `effective_balance` number, nullable, required: The effective balance (saldo efectivo), in the account's currency.
      - `allow_credit` boolean, nullable, required: Whether the account can receive credits.
      - `allow_debit` boolean, nullable, required: Whether the account can be debited.
      - `holder_relation` string, nullable, required: The connected customer's relation to the account, e.g. `TITULAR`.
      - `joint_holder` boolean, nullable, required: Whether the account has more than one holder.
      - `opening_date` string, nullable, required: When the account was opened, `yyyy-mm-dd`, when given.
      - `office` object, nullable, required: The branch office the account belongs to.
        - `code` string, nullable, required: The branch office code, when given.
        - `name` string, nullable, required: The branch office name, e.g. `CALLE 79`, when given.
    - `checked_at` string, required: When Bancolombia was read (ISO 8601).

## Other responses

- `202`: Accepted — the result is being computed asynchronously. Poll `job.status_url` (GET /jobs/{id}) or supply `callback_url` to have the result POSTed to you. Returned when `Prefer: wait` elapses before completion, or immediately when `callback_url` is set.
- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)