Sign up

API → Payments → Update balance for an org
hidden

Parameters

Name

Type

Req.

Returns

  • 200 OK

    successful operation

    Name

    Type

    Req.

    body

    object
    optional
    Object Properties

    • created_at

      string / ISO-8601
      optional

    • id

      string / UUID
      optional

    • map_id

      string / UUID
      optional

    • modeling_app_enterprise_price

      oneOf
      optional
      One of

      • flat

        object
        optional
        Object Properties

        • interval

          string
          optional
          Possible values
          • day:  Day.
          • month:  Month.
          • week:  Week.
          • year:  Year.

        • price

          number / USD Price
          optional

        • type

          string
          optional
          Possible values
          • flat

      • per_user

        object
        optional
        Object Properties

        • interval

          string
          optional
          Possible values
          • day:  Day.
          • month:  Month.
          • week:  Week.
          • year:  Year.

        • price

          number / USD Price
          optional

        • type

          string
          optional
          Possible values
          • per_user

      • enterprise

        object
        optional
        Object Properties

        • type

          string
          optional
          Possible values
          • enterprise

    • monthly_credits_remaining

      number / USD Price
      optional

    • pre_pay_cash_remaining

      number / USD Price
      optional

    • pre_pay_credits_remaining

      number / USD Price
      optional

    • subscription_details

      object
      optional
      Object Properties

      • modeling_app

        object
        optional
        Object Properties

        • annual_discount

          integer
          optional

        • description

          string
          optional

        • features

          array
          optional
          Array of

        • name

          string
          optional
          Possible values
          • free:  The free tier.
          • pro:  The pro tier.
          • team:  The team tier.
          • enterprise:  The enterprise tier.

        • pay_as_you_go_credits

          number / USD Price
          optional

        • price

          oneOf
          optional
          One of

          • flat

            object
            optional
            Object Properties

            • interval

              string
              optional
              Possible values
              • day:  Day.
              • month:  Month.
              • week:  Week.
              • year:  Year.

            • price

              number / USD Price
              optional

            • type

              string
              optional
              Possible values
              • flat

          • per_user

            object
            optional
            Object Properties

            • interval

              string
              optional
              Possible values
              • day:  Day.
              • month:  Month.
              • week:  Week.
              • year:  Year.

            • price

              number / USD Price
              optional

            • type

              string
              optional
              Possible values
              • per_user

          • enterprise

            object
            optional
            Object Properties

            • type

              string
              optional
              Possible values
              • enterprise

        • share_links

          array
          optional

        • support_tier

          string
          optional
          Possible values
          • community:  Community support.
          • standard:  Standard support.
          • premium:  Premium support.
          • priority:  Priority support.

        • training_data_behavior

          string
          optional
          Possible values
          • always:  The data is always used for training and cannot be turned off.
          • default_on:  The data is used for training by default, but can be turned off.
          • default_off:  The data is not used for training by default, but can be turned on.

        • type

          oneOf
          optional
          One of

          • individual

            object
            optional
            Object Properties

            • type

              string
              optional
              Possible values
              • individual

          • organization

            object
            optional
            Object Properties

            • saml_sso

              boolean
              optional

            • type

              string
              optional
              Possible values
              • organization

        • zoo_tools_included

          array
          optional

    • subscription_id

      string
      optional

    • total_due

      number / USD Price
      optional

    • updated_at

      string / ISO-8601
      optional
put
/orgs/{id}/payment/balance
$ curl -X PUT "https://api.zoo.dev/orgs/{id}/payment/balance" \
	--header "Authorization: Bearer $TOKEN" \
	--header "Content-Type: application/json" \
	--data '{
  "monthly_credits_remaining": "2.71",
  "pre_pay_cash_remaining": "14.60",
  "pre_pay_credits_remaining": "42.75"
}'
200 OK
Response
{
  "created_at": "2025-04-01T00:20:23.550Z",
  "id": "98f354dd-f602-437f-9ace-689c7b7b6500",
  "map_id": "6cbe8013-f0f4-4a4a-9259-0f976726c2c2",
  "modeling_app_enterprise_price": {
    "interval": "year",
    "price": "51.58",
    "type": "flat"
  },
  "monthly_credits_remaining": "22.76",
  "pre_pay_cash_remaining": "6.46",
  "pre_pay_credits_remaining": "28.89",
  "subscription_details": {
    "modeling_app": {
      "annual_discount": 29,
      "description": "VaXkusr1W8XosI8I531wcIa97szJ3",
      "features": [
        {
          "info": "Po9a03qIsDt"
        }
      ],
      "name": "enterprise",
      "pay_as_you_go_credits": "10.68",
      "price": {
        "type": "enterprise"
      },
      "share_links": [
        "public"
      ],
      "support_tier": "community",
      "training_data_behavior": "default_on",
      "type": {
        "type": "individual"
      },
      "zoo_tools_included": [
        "text_to_cad"
      ]
    }
  },
  "subscription_id": "PNgrG",
  "total_due": "12.79",
  "updated_at": "2025-04-01T00:20:23.550Z"
}