Skip to content
Protocol primitive

Provision device

A dedicated mobile device context pinned to a city.

POSTapi.tikultra.com/v1/devices/provisionHeavy · 10 credits
Upstream/service/2/device_register/Growth and up

Parameters

NameTypeDescription
osstringandroid or ios.
e.g. android
app_flavourstringWhich app to run as.
e.g. tiktok
app_versionstringA release of that app. Defaults to the current default for (os, app_flavour).
e.g. 47.6.3
regionrequiredstringTwo-letter country code for egress and storefront.
e.g. US
citystringA city in that region. See the supported cities list.
e.g. miami
hardware_templatestringOne of 237 Android or 15 iOS hardware profiles. Omit for a random one.

Pricing

PlanPer callPer 1,000 calls
Starter10 credits$1.16
Growth10 credits$0.79
Scale10 credits$0.58

Growth and up.

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

curl -X POST https://api.tikultra.com/v1/devices/provision \
  -H "x-api-key: $TIKULTRA_KEY" \
  -H "content-type: application/json" \
  -d '{"os":"android","app_flavour":"tiktok","app_version":"47.6.3","region":"US","city":"miami"}'
{
  "status": "provisioned",
  "device": {
    "device_id": "7392011847562901234",
    "install_id": "7392011998877665544",
    "os": "android",
    "app_flavour": "tiktok",
    "app_version": "47.6.3",
    "aid": 1233,
    "model": "Pixel 8 Pro",
    "os_version": "14",
    "region": "US",
    "city": "miami",
    "bootstrapped": true,
    "report_sequence": 3
  }
}
Try it in the playgroundFull reference in the docs

More in Devices, signing & primitives

GET/v1/resolveResolve2 crPOST/v1/resolveResolve (POST)2 crGET/v1/tools/id-converterID converter2 crPOST/v1/tools/protobuf-decodeProtobuf decode2 crPOST/v1/jobs/submitSubmit batch jobper taskGET/v1/jobs/{id}Get jobFreeGET/v1/devicesList devicesFreeGET/v1/devices/templatesHardware templatesFreeGET/v1/apps/versionsApp versionsFreeGET/v1/devices/{id}Get deviceFreePOST/v1/devices/{id}/bootstrapBootstrap device10 crPOST/v1/devices/{id}/reportDevice security report10 crPOST/v1/crypto/signSign request2 crPOST/v1/crypto/x-cylonsX-Cylons token2 crPOST/v1/crypto/x-argus/decryptX-Argus decrypt2 crPOST/v1/crypto/x-ladon/decryptX-Ladon decrypt2 crPOST/v1/crypto/x-gorgon/decryptX-Gorgon decrypt2 crPOST/v1/crypto/ttencrypt/encryptTTEncrypt encode2 crPOST/v1/crypto/ttencrypt/decryptTTEncrypt decode2 crPOST/v1/crypto/zstd/compresszstd compress2 crPOST/v1/crypto/zstd/decompresszstd decompress2 crPOST/v1/crypto/passport-hashPassport identifier hash2 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API keySee pricing