Skip to navigation
API Referencesms-number

Order Sms Number

View as Markdown

Rent an SMS number using the reseller wallet. SMS it receives are forwarded to the linked eSIM and kept in its inbox. The number can only receive SMS. To safely retry, reuse the same transaction_id with the same product and days.

Authentication

x-api-keystring

API key generated from the dashboard (Settings → API Keys). Each key is limited to 8 requests per 1-second window.

Request

This endpoint expects an object.
transaction_idstringRequired1-100 characters

Reseller-assigned transaction ID

product_idstringRequiredformat: "uuid"
daysintegerRequired1-365
esim_idstring or nullOptional>=1 character
eSIM to forward SMS to. It must be yours, active and on a plan with smsStatus 1 or 2. Can be set later.

Response

Successful response
idstring>=1 character
SimJuno SMS number rental ID
transaction_idstring or null

Reseller-assigned transaction ID; null for numbers rented on simjuno.com

namestring
phone_numberstring

Rented number in international format, without the +

daysdouble
statusenum
Allowed values:
amountdouble

Amount charged, in units of 1/10,000 USD (30000 = $3.00)

expires_atstring
esim_idstring or null

eSIM that received SMS are forwarded to; null keeps them in the inbox only

message_countdouble
refundable_untilstring or null

Refundable until then if no SMS has arrived; null when it can’t be refunded

created_atstring

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
412
Precondition Failed Error
429
Too Many Requests Error
500
Internal Server Error