> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Stripe integration status

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns setup state without returning API keys. With no sandbox, returns the app ID and the model defaults. Requires read access to the app.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/payments/stripe/status
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - ApiKeyAuth: []
paths:
  /api/apps/{app_id}/payments/stripe/status:
    get:
      summary: Get Stripe integration status
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns setup state without returning API keys. With no sandbox, returns
        the app ID and the model defaults. Requires read access to the app.
      operationId: >-
        get_stripe_integration_status_api_apps__app_id__payments_stripe_status_get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the Base44 app.
            title: App Id
          description: ID of the Base44 app.
          example: 6820f3a4e7b91d003c45a1f2
        - name: check_transactions
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Whether to look for any checkout session in sandbox mode. Defaults
              to false. A session does not prove payment, and lookup failures
              report false.
            default: false
            title: Check Transactions
          description: >-
            Whether to look for any checkout session in sandbox mode. Defaults
            to false. A session does not prove payment, and lookup failures
            report false.
          example: false
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StripeIntegrationStatusResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            The credential is not permitted or you don't have the required app
            access. A missing app also fails the app access check.
        '404':
          description: The app is outside the credential's granted workspace.
        '409':
          description: The workspace requires an unlocked SSO session.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    StripeIntegrationStatusResponse:
      properties:
        app_id:
          type: string
          title: App Id
          description: ID of the Base44 app.
          example: 6820f3a4e7b91d003c45a1f2
        stripe_mode:
          anyOf:
            - type: string
            - type: 'null'
          title: Stripe Mode
          description: >-
            Mode inferred from available credentials and sandbox state. Either
            `sandbox` or `live`, or `null` when neither is available. Defaults
            to `null`.
          example: sandbox
        sandbox_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Sandbox Status
          description: >-
            Stored sandbox status. Either `unclaimed`, `claimed`, or `expired`,
            or `null` without a sandbox. Defaults to `null`.
          example: unclaimed
        sandbox_is_claimable:
          type: boolean
          title: Sandbox Is Claimable
          description: >-
            Whether the sandbox is unclaimed, has not expired, and has a stored
            claim link. Defaults to false.
          default: false
          example: true
        sandbox_claim_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Sandbox Claim Url
          description: >-
            Stored claim link, or `null` when the sandbox is not claimable or
            you are a workspace viewer. Treat this link as a credential.
            Defaults to `null`.
          example: https://dashboard.stripe.com/claim/example
        sandbox_days_until_expiry:
          anyOf:
            - type: integer
            - type: 'null'
          title: Sandbox Days Until Expiry
          description: >-
            Whole days until sandbox expiration, or `null` for a claimed sandbox
            or when no expiration is stored. Defaults to `null`.
          example: 30
        sandbox_account_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Sandbox Account Id
          description: >-
            Stripe sandbox account ID, or `null` without a sandbox. Defaults to
            `null`.
          example: acct_T7mK2p9Q4r6S8v
        test_mode_configured:
          type: boolean
          title: Test Mode Configured
          description: Whether test credentials are available. Defaults to false.
          default: false
          example: true
        live_mode_configured:
          type: boolean
          title: Live Mode Configured
          description: >-
            Whether live credentials or a connected live account are available.
            This alone does not mean the app has switched to live keys. Defaults
            to false.
          default: false
          example: false
        live_mode_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Live Mode Method
          description: >-
            Available live authentication method. Either `direct_keys` or
            `platform_auth`, or `null` when neither is available. Direct keys
            take precedence. Defaults to `null`.
          example: direct_keys
        live_keys_configured:
          type: boolean
          title: Live Keys Configured
          description: Stored completion flag for live key setup. Defaults to false.
          default: false
          example: false
        live_account_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Live Account Id
          description: >-
            Connected live Stripe account ID, or `null` before activation.
            Defaults to `null`.
          example: acct_L8nP3q5R7s9T2v
        has_tested_payment:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Has Tested Payment
          description: >-
            Whether Stripe reports any checkout session when requested in
            sandbox mode. False also covers a failed lookup, and a session does
            not prove payment. Otherwise `null`. Defaults to `null`.
          example: false
      type: object
      required:
        - app_id
      title: StripeIntegrationStatusResponse
      description: Comprehensive Stripe integration status response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: Personal API key.

````