API reference / Connected sessions / Email sign-in: verify code

Email sign-in: verify code

Finish signing in with the one-time code.

POSTapi.tikultra.com/v1/account/login/otp/verifyPremium · 25 credits
Upstream
/passport/email/login/
Access
Growth and up
Runs on
FullPool
Billing
Failed calls are free

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

emailstringrequired

The same email. For example [email protected].

codestringrequired

The code from the email. For example 482913.

Client and egress

Executes on the dedicated FullPool mobile context and city-level egress bound to account_id. See Connected sessions.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

status_codeinteger

Upstream TikTok mobile status code (0 indicates success).

account_idstring

Connected session identifier bound to a dedicated FullPool mobile context.

statusstring

Current lifecycle or health status.

healthstring

Decoded health value.

uidstring

Numeric 64-bit TikTok user ID.

sec_uidstring

Encrypted stable account identifier used across mobile endpoints.

usernamestring

Decoded username value.

device_idstring

Provisioned mobile device identifier.

session_persistedboolean

Whether session persisted is enabled or true.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

Accounts you own only. Connected sessions are for accounts you own or are authorized to operate. Available on Growth and Scale.