> ## 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 product

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

Returns a product by its Stripe ID.

Uses the Stripe account selected by the app's stored credentials. Live keys select the live catalog and test keys select the test catalog. Products and prices belong to that Stripe account, so multiple apps configured with the same account share the same catalog. Check `livemode` on each returned product or price to see which catalog the call used.

Requires read access to the app.



## OpenAPI

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


        Returns a product by its Stripe ID.


        Uses the Stripe account selected by the app's stored credentials. Live
        keys select the live catalog and test keys select the test catalog.
        Products and prices belong to that Stripe account, so multiple apps
        configured with the same account share the same catalog. Check
        `livemode` on each returned product or price to see which catalog the
        call used.


        Requires read access to the app.
      operationId: get_product_api_apps__app_id__payments_stripe_products__product_id__get
      parameters:
        - name: product_id
          in: path
          required: true
          schema:
            type: string
            description: Stripe product ID in the configured account.
            title: Product Id
          description: Stripe product ID in the configured account.
          example: prod_T7mK2p9Q4r6S8v
        - 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
      responses:
        '200':
          description: The operation result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StripeCatalogProduct'
        '400':
          description: >-
            Stripe is not set up for this app, its keys are missing, or its test
            sandbox has expired. Install the Stripe integration before listing
            products.
        '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. Setup and
            catalog operations also return `app_payment_management_not_allowed`
            when the app's workspace restricts payment management.
        '404':
          description: The app is outside the credential's granted workspace.
        '409':
          description: The workspace requires an unlocked SSO session.
        '429':
          description: >-
            `rate_limited`: More than 420 requests in a minute per user, a
            budget shared by the Stripe status, sandbox, product and price
            reads. A successful response reports the budget in
            `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`
            (Unix seconds); retry after `Retry-After` seconds. See [Rate
            limits](/developers/references/apps-api/get-started/rate-limits) for
            the multiplier your plan gets.
          content:
            application/json:
              examples:
                rate_limited:
                  summary: rate_limited
                  value:
                    error:
                      code: rate_limited
                      message: Rate limit exceeded.
                      details: {}
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
        '503':
          description: >-
            Database temporarily unavailable (`database_unavailable`): the data
            cluster did not answer in time. Retry after the `Retry-After`
            seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
              examples:
                database_unavailable:
                  summary: database_unavailable
                  value:
                    error:
                      code: database_unavailable
                      message: Database temporarily unavailable, please retry
                      details: {}
      security:
        - PersonalAccessTokenAuth:
            - read_only
        - WorkspaceApiKeyAuth:
            - read_only
        - WorkspaceApiKeyBearerAuth:
            - read_only
components:
  schemas:
    StripeCatalogProduct:
      properties:
        id:
          type: string
          title: Id
          description: Stripe product ID.
          example: prod_T7mK2p9Q4r6S8v
        name:
          type: string
          title: Name
          description: Product name.
          example: Studio membership
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Product description, or `null` when none is set.
          example: Access to weekly classes.
        active:
          type: boolean
          title: Active
          description: Whether the product is active.
          example: true
        images:
          items:
            type: string
          type: array
          title: Images
          description: >-
            Product image URLs. Neither Create nor Update Stripe product takes
            an `images` field, so this stays empty unless you add images
            directly in the Stripe dashboard for the account these credentials
            point to.
          example:
            - https://example.com/membership.jpg
        metadata:
          additionalProperties: true
          type: object
          title: Metadata
          description: Metadata stored on the product.
          example:
            category: membership
        livemode:
          type: boolean
          title: Livemode
          description: >-
            `true` when the product is in the live catalog, `false` when it's in
            the test catalog.
          example: false
      type: object
      required:
        - id
        - name
        - description
        - active
        - images
        - metadata
        - livemode
      title: StripeCatalogProduct
      description: A product in the Stripe account configured for the app.
    StandardErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/StandardError'
          description: What went wrong.
      type: object
      required:
        - error
      title: StandardErrorEnvelope
      description: The error body returned in the standard envelope.
    StandardError:
      properties:
        code:
          type: string
          title: Code
          description: >-
            Stable machine-readable cause of the failure. Match on this, not on
            `message`.
          example: not_found
        message:
          type: string
          title: Message
          description: Human-readable explanation. It isn't a stable contract.
          example: App not found
        details:
          additionalProperties: true
          type: object
          title: Details
          description: >-
            Structured context for the failure, or an empty object when there's
            none.
          example: {}
      type: object
      required:
        - code
        - message
      title: StandardError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.
    WorkspaceApiKeyAuth:
      type: apiKey
      in: header
      name: api_key
      description: >-
        Workspace API key, sent as `api_key: <key>`. Each operation that accepts
        one lists what the key needs: a permission, `read_only` or
        `full_access`, like a personal access token, or a scope. A key without
        the scope gets 403 `workspace_api_key_scope_required`.
    WorkspaceApiKeyBearerAuth:
      type: http
      scheme: bearer
      description: >-
        Workspace API key, sent as `Authorization: Bearer <key>`. Accepted
        wherever `api_key` is, with the same permission.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.