---
title: "Check Status"
method: GET
path: "/api/openbanking/status/{consent_link_id}"
tags: ["openbanking"]
---

# Check Status

`GET /api/openbanking/status/{consent_link_id}`

## Request

- Base URL: `https://api.earmarkiq.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.earmarkiq.app/api/openbanking/status/{consent_link_id}`
- Auth: HTTP bearer

Check consent_link status. If authorized, fetch and store bank accounts.

A closed attempt answers from our own row, without Finexer: a link
whose consent was cancelled / failed / expired stays "new" or "sent" at
Finexer for ever, so polling it could never tell the app the attempt
was over — 26 minutes of it on 26 Sep (EQ-55). The webhook closes the
PendingBankAuth (finexer_webhooks._close_pending_auth); this is where
the app learns of it.

## Path parameters

- `consent_link_id` string, required

## Response `200`

Successful Response

- StatusResponse
  - `status` string, required
  - `accounts` StatusAccount[]
    - `institution` string, required
    - `institution_logo` string, nullable
    - `account_name` string, nullable
    - `account_type` string, nullable
    - `id` string, required
  - `reason` string, nullable

## Other responses

- `422`: Validation Error

---

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