---
title: "The organization's Stripe account, read from Stripe"
method: GET
path: "/projects/v1/{project_id}/stripe/account"
tags: ["Projects"]
---

# The organization's Stripe account, read from Stripe

`GET /projects/v1/{project_id}/stripe/account`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/projects/v1/{project_id}/stripe/account`
- Auth: one of:
  - HTTP bearer
  - API key in header `SIGN-IN-WITH-X`
  - HTTP bearer
  - HTTP bearer

Retrieves the account from Stripe on every read (never a stored state presented as current): status (onboarding until details are submitted and charges enabled; active; restricted when Stripe disabled charges or lists past-due requirements; disconnected), the Stripe flags, requirements, capabilities, custody "organization", platform_fee_bps 0, and next_actions (complete_onboarding while incomplete, open_stripe_dashboard once active). 404 STRIPE_ACCOUNT_NOT_FOUND inside the caller's own authority when the organization has none; 403 without one. Never lifecycle-gated.

## Path parameters

- `project_id` string, required: Run402 project ID. Public IDs are not UUIDs.

## Headers

- `SIGN-IN-WITH-X` string, required

## Response `200`

The account state.

- StripeAccount
  - `org_id` string, uuid, required
  - `scope` 'organization', required
  - `account_id` string, nullable, required: The Stripe account id (acct_…); null only while the create is still being confirmed.
  - `status` 'creating' | 'onboarding' | 'active' | 'restricted' | 'disconnected', required
  - `livemode` boolean
  - `charges_enabled` boolean, required
  - `payouts_enabled` boolean, required
  - `details_submitted` boolean, required
  - `requirements` object, required
    - `currently_due` string[]
    - `past_due` string[]
    - `eventually_due` string[]
    - `disabled_reason` string, nullable
  - `capabilities` object, required: Stripe capability statuses by name (card_payments, sepa_debit_payments: active, pending, inactive, unrequested).
  - `country` string, nullable
  - `default_currency` string, nullable
  - `dashboard` 'full', required
  - `custody` 'organization', required
  - `platform_fee_bps` 0, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `disconnected_at` string, date-time, nullable
  - `next_actions` NextAction[], required
    - `type` string, required: Advisory machine-readable action type such as retry, authenticate, submit_payment, fund_wallet, renew_tier, check_usage, resume_deploy, edit_request, edit_migration, contact_support, upgrade_client, poll (poll the project events feed — appended when the envelope carries a correlated_platform_incident), or hand_to_member (on a commit/promote response that just activated a public site: show the human urls.site and urls.console, relay Run402's offer to promote the build on @run402com, and ask yes or no — see `credited_as` below).
    - `method` string
    - `path` string
    - `auth` string
    - `why` string
    - `credited_as` string, nullable: `hand_to_member` only. The caller's own live presence name in the project's default room, else that room's most recently active live presence, else `null` — in which case `why` tells the agent that joining the room with a name (`run402 rooms join --name ...`) is how the promotion credits it.
    - `body` object: `hand_to_member` only. A ready-to-send `POST /feedback/v1` template: `{ project_id, message: "promote: yes", handle? }`.

## Other responses

- `403`: Not authorized on the project.
- `404`: STRIPE_ACCOUNT_NOT_FOUND: the organization has no live account (only inside the caller's authority).
- `503`: STRIPE_CONNECT_UNAVAILABLE: the platform's Stripe configuration is absent or Stripe did not answer (Retry-After).

---

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