Stripe

Retrieve a connected Stripe account

Retrieve a connected Stripe account by its id (UUID v7). Returns its name, external account id, assigned series (series_id), effective per-account auto-invoicing configuration and status. Returns 404 if the account does not exist or belongs to another company.

get/companies/{company}/connected-accounts/{account}

Request

Base URL: https://api.factuarea.com/v1
URL: https://api.factuarea.com/v1/companies/{company}/connected-accounts/{account}
Auth: one of:
- HTTP bearer
- API key in header X-API-Key

Path parameters

companystring uuid required

Public identifier (UUID v7) of the company. Get it from GET /v1/me (data.scope[].id).

accountstring uuid required

Public identifier (UUID v7) of the connected payment account.

Headers

Factuarea-Versionstring date

Example:2026-06-01

Pin the API version (YYYY-MM-DD, Stripe-style date versioning) for this request; omit to use the key's pinned version, or the latest if none. Unsupported version → 400 unsupported_api_version; malformed → 400 parameter_invalid_format. The effective version is echoed in the Factuarea-Version response header. See the Versioning guide.

Response

Example response

{
  "data": {
    "id": "0192e7c2-4d5e-7f3b-a012-3c4d5e6f7081",
    "object": "connected_account",
    "name": "Tienda principal",
    "external_account_id": "acct_1QabcDEF2ghIJklm",
    "external_account_name": "Tienda principal S.L.",
    "series_id": "0192e7b1-3c4d-7e2a-9f01-2b3c4d5e6f70",
    "simplified_threshold_cents": 40000,
    "refunds_enabled": true,
    "default_line_concept": "Cobro Stripe",
    "invoice_note": "Pago recibido. Gracias por su compra.",
    "connection_method": "account_links",
    "authorization_status": "authorized",
    "status": "active",
    "connected_at": "2026-06-15T10:30:00+00:00",
    "fee_expenses_tax_treatment": "reverse_charge_eu",
    "fee_expenses_since": "2026-01"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.