MagicDoorAPI
SupportOpen MagicDoor
Bank feeds

Get a bank feed connection

Fetches one connection with whether a manual refresh is allowed right now, the last refresh attempt, and the last sync. Requires the reconciliations:read permission.

GET
https://services.magicdoor.com/accounting/company-portal/bank-feeds/connections/{connectionId}

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

connectionIdstringrequired

Snowflake id of the bank feed connection.

example: 1830472847398408100

Response

200 · The connection, its refresh capability, and its most recent refresh attempt and sync.

idstring

Snowflake id of the bank feed connection.

companyIdstring

The company that owns the connection.

providerConnectionIdstring

The provider's own identifier for the linked institution. An opaque token — do not parse it. An empty string when the provider has not supplied one.

statusstring

Active while the feed is working, RequiresReauth when the bank needs the user to sign in again, Disconnected once the link has been removed. The value is written exactly as it appears here, in PascalCase — these particular status fields are plain strings rather than the camelCase enums used elsewhere in the API.

ActiveRequiresReauthDisconnected
lastSyncedstring · date-time

When transactions were last pulled from the bank, in the company's timezone. Absent until the first sync finishes.

lastRefreshRequestedstring · date-time

When a manual refresh was last asked for, in the company's timezone. Absent until one is.

accountsAccount[]

The bank accounts this connection feeds.

createdstring · date-time

When the connection was made, in the company's timezone.

updatedstring · date-time

When the connection last changed, in the company's timezone.

refreshCapabilityobject

Whether a manual refresh can be asked for at this moment. Check it before offering the button.

latestRefreshAttemptobject

The most recent manual refresh attempt. Absent when none has been made.

latestBankFeedSyncobject

The most recent pull of transactions from the bank. Absent when none has run.

401 · The access token is missing, expired, or not for this company.

403 · The caller does not hold the `reconciliations:read` permission.

404 · No bank feed connection with this id belongs to the caller's company.