Pepvote Support Center

Get Public Quadratic Credit Options

GET
/public/voting-events/{idOrCode}/quadratic-credits/options

Credit top-up pricing for one quadratic position on a pay-to-vote poll.

Authorization

bearerAuth
AuthorizationBearer <token>

A key in the form pepvote_api_ followed by 32 hexadecimal characters.

In: header

Header Parameters

User-Agentstringrequired

Name and version of the calling integration. Required on every request.

Path Parameters

idOrCodestringrequired

Voting event ID or code.

Query Parameters

positionIdstringrequired

A quadratic position.

visitorIdstringrequired

The same visitorId used to cast.

  • Pattern: ^vi_[0-9a-fA-F]{16,128}$

Response Body

application/json

application/json

curl -X GET "https://example.com/public/voting-events/string/quadratic-credits/options?positionId=string&visitorId=string" \  -H "User-Agent: my-app/1.0"
{
  "data": {
    "balance": {
      "_id": "string",
      "_creationTime": 0,
      "votingEventId": "string",
      "positionId": "string",
      "voterKey": "string",
      "baseCreditsGranted": 0,
      "purchasedCredits": 0,
      "reservedPurchasedCredits": 0,
      "reservedPurchaseCount": 0,
      "topUpCount": 0,
      "spentCredits": 0,
      "expiredCredits": 0,
      "availableCredits": 0,
      "finalizedAt": 0,
      "updatedAt": 0
    },
    "maximumAdditionalCredits": 0,
    "pricing": {
      "_id": "string",
      "pricingModel": "ratio",
      "currency": "string",
      "amountPerCredit": 0,
      "minimumPurchaseCredits": 0,
      "maximumPurchaseCredits": 0,
      "tiers": [
        {
          "_id": "string",
          "creditAmount": 0,
          "amount": 0,
          "currency": "string",
          "label": "string",
          "active": true,
          "sortOrder": 0
        }
      ]
    }
  }
}
{
  "error": {
    "code": "bad_request",
    "message": "string",
    "details": {
      "field": "string",
      "parameter": "string",
      "limit": 0,
      "retryAfterSeconds": 0,
      "feature": "string",
      "plan": "string"
    }
  }
}
Was this helpful?

Last updated September 6, 2026