---
title: "Stripe connection status"
method: GET
path: "/companies/{companyId}/integrations/stripe/connection"
tags: ["Stripe Connect"]
---

# Stripe connection status

`GET /companies/{companyId}/integrations/stripe/connection`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/integrations/stripe/connection`
- Auth: HTTP bearer

Read-only. For an allowlisted company the payload may carry `accountingBlock`, which separates codes that need accountant review (`accountCodes`) from codes that self-heal on the next sync through the audited adoption path (`adoptableCodes`).

## Response `200`

Connection status

- StripeConnectionStatusResponse
  - `success` true, required
  - `data` StripeConnectionStatus, required
    - `status` 'not_connected' | 'auth_initiated' | 'connected' | 'importing' | 'synced' | 'error', required
    - `stripeAccountId` string, nullable
    - `livemode` boolean, nullable
    - `importedCount` integer
    - `backfillStartedAt` string, date-time, nullable
    - `backfillCompletedAt` string, date-time, nullable
    - `lastSyncAt` string, date-time, nullable
    - `lastSyncAttemptAt` string, date-time, nullable
    - `lastWebhookReceivedAt` string, date-time, nullable
    - `errorMessage` string, nullable
    - `accounts` StripeConnectionAccountSummary[]
      - `connectionId` string, uuid, required
      - `stripeAccountId` string, required
      - `status` string, required
      - `livemode` boolean, nullable, required
      - `lastSyncAt` string, date-time, nullable, required
      - `errorMessage` string, nullable, required
    - `accountingBlock` StripeAccountingBlock: Stage-A Stripe GL guard state for the company (#1453A). Present only for companies on the guard allowlist.
      - `code` 'STRIPE_GL_ACCOUNT_REBIND_REQUIRED', required
      - `action` 'accountant_review', required
      - `message` string, required
      - `accountCodes` string[], required: Codes with a blocking collision, or missing while connected. These need accountant review and fail every connect, sync, and post.
      - `adoptableCodes` string[], required: Codes whose rows conform on accounting shape and name evidence. They are normalized automatically by the audited adoption path on the next connect or sync; no action is required.

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)