---
title: "The accounts a connection shares"
method: GET
path: "/api/v1/banking/ponto/connections/{id}/accounts"
tags: ["Money"]
---

# The accounts a connection shares

`GET /api/v1/banking/ponto/connections/{id}/accounts`

## Request

- Base URL: `http://localhost:5180`
- URL: `http://localhost:5180/api/v1/banking/ponto/connections/{id}/accounts`
- Auth: API key in cookie `better-auth.session_token`

What the organization shares right now, each with the portfolio account it looks like or already feeds. It is how a connection whose redirect was left half way, or that landed in another team, is picked up again,. A connection a newer grant replaced answers for that grant. A shared account nobody here reads comes back with its IBAN masked and no balance, except to the person who shared it.

## Path parameters

- `id` string, required

## Response `200`

What the connection reaches.

- object
  - `ok` unknown, required
  - `data` object, required
    - `connectionId` string, required: Stable record id, e.g. `lse_012`.
    - `teamId` string, required: The team the connection belongs to.
    - `organizationName` string: The Ponto organization the owner consented for.
    - `accounts` object[], required: What the owner shared. Each is linked with `/ponto/link`.
      - `id` string, required: Ponto’s own id for the account. Hand it back to `/ponto/link`.
      - `iban` string
      - `currency` string
      - `description` string
      - `institution` string: The bank’s name, as Ponto knows it.
      - `institutionId` string
      - `balance` number: The balance Ponto last saw, in cents.
      - `authorizationExpiresAt` string: When the bank’s consent for this account is expected to run out.
      - `suggestedBankAccountId` string: The portfolio account with the same IBAN, where it may be paired.
      - `linkedBankAccountId` string: The portfolio account this already feeds.
      - `readElsewhere` boolean: Another connection on this team already reads the same IBAN, so this one is left at Ponto and cannot be linked.
      - `heldElsewhere` boolean: Another team the caller is on holds this IBAN and this team does not, so it is never paired here.
    - `startedFrom` string: The portfolio account the connection was started from.
    - `stoppedElsewhere` number: Connections on other teams this grant replaced. Ponto feeds one team at a time, so they stopped there.
    - `stopped` number: Accounts this team was reading that stopped, because the new grant shared none.
    - `notShared` string[]: Portfolio accounts an older grant read that this one did not share, so they stopped here.
    - `stoppedOn` object[]: The teams among `stoppedElsewhere` the caller is on, named because they can open them. Anyone else is told only how many.
      - `teamId` string, required: Stable record id, e.g. `lse_012`.
      - `name` string, required
    - `ownerMustConnect` boolean: The caller is no longer an owner of the team, so the grant is kept and nothing was linked.
  - `meta` object, required
    - `requestId` string, required: Echoed in the x-request-id header. Quote it in a bug report.

## Other responses

- `400`: The connection is not live, or the bank refused.
- `404`: No such connection on this team.
- `409`: Another check is reading the bank right now, so ask again in a moment.

---

[API](https://skmtc.dev/dardaris/apis/dardaris-api.md) · [All operations](https://skmtc.dev/dardaris/apis/dardaris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dardaris/apis/dardaris-api/revisions/4aff33835c73?raw)