Account

Buy credits

Changed on

Purchase additional credits for your organization. Saved-card purchases cost $20.00 per 1,000 credits on a subscription, or $30.00 per 1,000 credits on a pay-as-you-go plan. A one-time payment authorization charges the pay-as-you-go rate. This endpoint immediately charges real money. Confirm with a human operator before calling it from an agent.

<span>⚡ <strong>Rate limit:</strong> 2 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> FREE! No credits are charged for this API. <span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

post/v1/buy-credits

Request

  • Base URL
    https://api.fiber.ai
  • URL
    https://api.fiber.ai/v1/buy-credits
  • Auth
    none declared

Request body

apiKeystring required

Your Fiber API key

subscriptionIdstring nullable

The subscription to add credits to. Required when the organization has more than one subscription, or when charging a saved payment method. Must be omitted when paying with a one-time payment authorization; sending both is rejected.

creditsToBuyinteger required

Number of credits to purchase. One-time payment authorizations require at least 100 credits. Saved-card purchases require at least 1,000 credits.

sharedPaymentGrantedTokenstring nullable

A one-time payment authorization from your payment provider. When set, this purchase charges that authorization instead of a saved card. Each purchase needs a freshly minted authorization.

idempotencyKeystring nullable

A unique key to safely retry a purchase. If a request fails or times out, resend with the same key to avoid being charged twice. When omitted, each call is a new purchase.

Response

Default Response

advicestring[] nullable

Tips, recommendations, and suggestions for using this API effectively.

Changes

  • f8a78c729da9Revision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the new optional request property

    • info

      the request property became nullable

    • info

      the request property became optional

    • info

      the request property's min was decreased from 1000.00 to 100.00

    • info

      added the optional property to the response with the status

  • 4002aa81d4fbRevision changes
    • breaking

      added the new required request property

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became optional for the status

    • info

      the response's property default value was removed for the status