Integrator quota

Your integrator account has provisioning limits that cap how much you can provision across all of your managed organizations. They are separate from any single organization's plan: this page is about your limits as an integrator, not an end customer's subscription. Read them to gate your own UI and to avoid hitting a wall mid-flow.

¶Reading your quota

curl "${auth[@]}" "$B/integrator"

{ "enabled": true,
  "limits": { "maxManagedOrgs": 1, "maxManagedProcesses": 10, "maxVotes": 1000,
              "maxEmails": 500, "maxSMS": 200 },
  "usage":  { "managedOrgs": 1, "managedProcesses": 2, "sentVotes": 134,
              "sentEmails": 87, "sentSMS": 12 } }

var q = await Get("/integrator");
var limits = q.GetProperty("limits");
int orgsLeft = limits.GetProperty("maxManagedOrgs").GetInt32()
             - q.GetProperty("usage").GetProperty("managedOrgs").GetInt32();

q = get("/integrator").json()
orgs_left = q["limits"]["maxManagedOrgs"] - q["usage"]["managedOrgs"]

¶Limits and usage

Every limit has a matching counter under usage. Compare the two to see how much headroom you have before you provision more.

¶Tiers

Free tier. Allows one managed organization with modest limits on processes, votes and OTP messages - enough to build and test a full integration. Deleting the managed org frees the slot, and the cascade also rolls back your usage counters. See Managed organizations to provision and delete them.

Custom tier. Beyond the free tier, integrator limits are set on a custom plan agreed directly with Vocdoni. After the agreement, your negotiated allowances - how many managed organizations and published processes you can run, how many votes you can relay, and your email/SMS OTP budget - are provisioned on your integrator account and surface in GET /integrator. There is no self-serve upgrade for integrator quotas: to raise a limit, talk to the Vocdoni team through the API Dashboard or your account contact, and the new values take effect once your plan is updated.