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

# List top-up packs

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

Lists the top-up credit amounts you can buy for your workspace, with their prices. Top-up credits are extra message and integration credits on top of your plan.

Message credits come in packs of 50 and integration credits in packs of 1,000. You can buy up to 8 packs of each type in one purchase, and every pack costs the same. Send the `credits` values you want to [Create top-up checkout](/api-reference/create-top-up-checkout) or [Buy top-up with saved card](/api-reference/buy-top-up-with-saved-card).

Any member of the workspace can list the packs, but only the workspace owner can buy them. The workspace needs a paid plan other than Enterprise. Listing doesn't check whether the plan is past due, but buying does. A workspace whose plan is paid through the App Store or Google Play can't buy top-ups, and one billed through Wix can buy them only where Base44 has turned on Wix top-ups. A read-only token is refused, and workspace API keys aren't accepted.

<Note>Top-ups are only available to accounts Base44 has enrolled in top-up credits. Other accounts get a 403.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/billing/topup/presets
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/billing/topup/presets:
    get:
      summary: List top-up packs
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Lists the top-up credit amounts you can buy for your workspace, with
        their prices. Top-up credits are extra message and integration credits
        on top of your plan.


        Message credits come in packs of 50 and integration credits in packs of
        1,000. You can buy up to 8 packs of each type in one purchase, and every
        pack costs the same. Send the `credits` values you want to [Create
        top-up checkout](/api-reference/create-top-up-checkout) or [Buy top-up
        with saved card](/api-reference/buy-top-up-with-saved-card).


        Any member of the workspace can list the packs, but only the workspace
        owner can buy them. The workspace needs a paid plan other than
        Enterprise. Listing doesn't check whether the plan is past due, but
        buying does. A workspace whose plan is paid through the App Store or
        Google Play can't buy top-ups, and one billed through Wix can buy them
        only where Base44 has turned on Wix top-ups. A read-only token is
        refused, and workspace API keys aren't accepted.


        <Note>Top-ups are only available to accounts Base44 has enrolled in
        top-up credits. Other accounts get a 403.</Note>


        <Warning>The response includes fields beyond the ones documented here.
        Don't rely on undocumented response fields, as they can change at any
        time.</Warning>
      operationId: get_topup_presets_api_billing_topup_presets_get
      responses:
        '200':
          description: The amounts you can buy and their prices.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TopUpPacks'
              example:
                presets:
                  message_credits:
                    - credits: 0
                      total_cents: 0
                    - credits: 50
                      total_cents: 1500
                    - credits: 100
                      total_cents: 3000
                  integration_credits:
                    - credits: 0
                      total_cents: 0
                    - credits: 1000
                      total_cents: 1500
                    - credits: 2000
                      total_cents: 3000
                currency: usd
        '400':
          description: >-
            The workspace is on the free plan or Enterprise, or its billing
            doesn't support top-ups.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            Your account isn't enrolled in top-up credits, or your token is
            read-only.
        '429':
          description: Rate limit exceeded (60 requests a minute).
      security:
        - PersonalAccessTokenAuth:
            - full_access
components:
  schemas:
    TopUpPacks:
      properties:
        presets:
          $ref: '#/components/schemas/TopUpPackOptions'
          description: The amounts you can buy of each credit type, with their prices.
        currency:
          type: string
          enum:
            - usd
            - ils
          title: Currency
          description: >-
            Currency of every price, and the currency you pay in. `ils` when the
            workspace's plan is billed in shekels, `usd` otherwise.
          example: usd
      type: object
      required:
        - presets
        - currency
      title: TopUpPacks
    TopUpPackOptions:
      properties:
        message_credits:
          items:
            $ref: '#/components/schemas/TopUpPack'
          type: array
          title: Message Credits
          description: Message credit amounts you can buy, from 0 to 400 in steps of 50.
          example:
            - credits: 0
              total_cents: 0
            - credits: 50
              total_cents: 1500
            - credits: 100
              total_cents: 3000
        integration_credits:
          items:
            $ref: '#/components/schemas/TopUpPack'
          type: array
          title: Integration Credits
          description: >-
            Integration credit amounts you can buy, from 0 to 8,000 in steps of
            1,000.
          example:
            - credits: 0
              total_cents: 0
            - credits: 1000
              total_cents: 1500
            - credits: 2000
              total_cents: 3000
      type: object
      required:
        - message_credits
        - integration_credits
      title: TopUpPackOptions
    TopUpPack:
      properties:
        credits:
          type: integer
          title: Credits
          description: >-
            Number of credits. Send it as `message_credits` or
            `integration_credits` to buy this amount.
          example: 100
        total_cents:
          type: integer
          title: Total Cents
          description: >-
            Price of this amount in the smallest unit of `currency` (cents or
            agorot), before any VAT.
          example: 3000
      type: object
      required:
        - credits
        - total_cents
      title: TopUpPack
  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`.

````

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