https://api.veloesim.com:2053Authorization header, including the literal Apikey prefix:veloesimApiKey to your own key. In generated examples, replace the placeholder locally. The wholesale API uses a different authentication value from VeloConnect or VeloVerify.GET /api/wholesale/organizations to read the organization name and balance.GET /api/wholesale/plans to find a plan. For multiple area IDs, repeat the query key: areaIds=5&areaIds=151.GET /api/wholesale/plans/{id}.dataAmount, in MB. For an unlimited plan isUnlimitedLabel is true and dataAmount is the text "Unlimited", so check isUnlimitedLabel before you treat dataAmount as a number. Each area of a plan lists the mobile networks the plan can use there.curl 'https://api.veloesim.com:2053/api/wholesale/plans?limit=6&offset=0&areaIds=5&areaIds=151' \
--header 'Authorization: Apikey YOUR_API_KEY'count and rows. The source does not specify pagination defaults or maximum sizes. Use explicit limit and offset values appropriate for your integration.POST /api/wholesale/orders purchases an eSIM plan. Its JSON body requires planId:{"planId": 2604}customerEmail assigns the plan to that customer, creates a VeloeSIM user, and sends the customer a password for the application. customerFullName is optional.iccid, iosSetup, androidSetup, matchingId, smdpAddress, profileStatus, installedAt, and assignedPlans. Give the customer iosSetup for an iPhone or androidSetup for an Android phone; smdpAddress and matchingId are for manual installation. Each entry of assignedPlans has its own id and the planId of the plan that was bought. Keep ICCIDs as strings so their full value is preserved. Assigned-plan quantities are explicitly in bytes.GET /api/wholesale/esims to list organization eSIMs and GET /api/wholesale/esims/{iccid} to read one.GET /api/wholesale/esims/{iccid}/top-up. They are filtered by the base area of the last plan assigned to the eSIM. For an eSIM at the end of its lifecycle (its profileStatus is END_OF_LIFE or DELETED) this call answers HTTP 400 with the message Esim is end of life: such an eSIM cannot be topped up.POST /api/wholesale/esims/{iccid}/top-up with the selected ID, for example {"planId": 5}. The answer is the eSIM with all of its assigned plans, including the new one. The status is checked at the moment of the top-up: for an END_OF_LIFE or DELETED eSIM a new eSIM with the plan is issued instead (take the plan from GET /api/wholesale/plans, because the top-up plan list answers with an error for such an eSIM), at the price of the plan, and the answer is that new eSIM. Compare iccid in the answer with the one you sent, and if it differs, give the customer the new eSIM's installation link.areaNames and areaRegions descriptions appear reversed in the source. Names are preserved; verify the matching behavior before relying on these filters.installedAt are not specified. Plan dataAmount is in MB and plan duration is in days. No values or error contracts have been invented./api/data-plans catalog is outside this wholesale reference.