SMS Verification API: sms-activate Compatible

Basic Information

Base URL
https://www.sms9527api.com/openapi/v1

In the Profile > API Token > Generate Token
Authorization: Bearer <API_KEY>

Use your profile API Key for numbers, SMS, renewals, transfers, reservations, eSIM, wallet, tickets and messages. Write requests require Idempotency-Key; retries must use the same key and parameters.

Download OpenAPI specification

API Endpoints

Account balance

/openapi/v1/account/balance

GET

https://www.sms9527api.com/openapi/v1/account/balance

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/account/balance' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

{
  "code": 200,
  "data": {
    "balance": 100,
    "frozen_balance": 0,
    "user_id": "customer-id"
  },
  "msg": "ok"
}

Purchase monthly rental number

/openapi/v1/long_term/generation

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/generation

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`complete_numbers`	array	body	Optional	Complete numbers used to match available numbers. · Up to 500 items
`country_id`	string	body	Required	Country code, e.g. US; use the country list.
`days`	integer	body	Required	Duration in days.
`exclude_numbers`	array	body	Optional	Number segments to exclude from the selection. · Up to 500 items
`exp_num`	integer	body	Optional	Number quantity requested. · ≤ 500
`is_all_project`	boolean	body	Optional	Search all projects instead of a single project.
`keyword`	string	body	Optional	Project identifier returned by the corresponding project list.
`numbers`	array	body	Optional	Phone numbers to process. · Up to 500 items
`order_group`	string	body	Optional	Order group identifier used to group generated orders.
`with_voice_code`	boolean	body	Optional	Only include numbers or projects with voice code support.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/generation' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"country_id":"US","days":1}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Monthly rental batch list

/openapi/v1/long_term/generation/list

GET

https://www.sms9527api.com/openapi/v1/long_term/generation/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`batch_number`	string	query	Optional	Number batch ID from the batch list.
`country_id`	string	query	Optional	Country code, e.g. US; use the country list.
`keyword`	string	query	Optional	Project identifier returned by the corresponding project list.
`number`	string	query	Optional	Phone number or number filter.
`is_expiring`	boolean	query	Optional	Filter for numbers that are expiring soon.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/generation/list?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Batch reset SMS code receiving links

/openapi/v1/long_term/number/batch/reset

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/number/batch/reset

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	body	Required	Country code, e.g. US; use the country list.
`keyword`	string	body	Required	Project identifier returned by the corresponding project list.
`numbers`	array	body	Required	Phone numbers to process. · Up to 500 items

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/batch/reset' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"country_id":"US","numbers":["replace-with-numbers"],"keyword":"replace-with-project-id"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Number range inventory

/openapi/v1/long_term/number/count

GET

https://www.sms9527api.com/openapi/v1/long_term/number/count

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`is_all_project`	boolean	query	Optional	Search all projects instead of a single project.
`country_id`	string	query	Required	Country code, e.g. US; use the country list.
`keyword_id`	string	query	Optional	Project ID returned by the corresponding project list.
`days`	integer	query	Required	Duration in days.
`with_voice_code`	boolean	query	Optional	Only include numbers or projects with voice code support.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/count?country_id=US&days=1' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Check whether number exists

/openapi/v1/long_term/number/exists

GET

https://www.sms9527api.com/openapi/v1/long_term/number/exists

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`number`	string	query	Required	Phone number or number filter.
`keyword`	string	query	Required	Project identifier returned by the corresponding project list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/exists?number=replace-with-number&keyword=replace-with-project-id' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Export number expiration times

/openapi/v1/long_term/number/expire/export

POST

https://www.sms9527api.com/openapi/v1/long_term/number/expire/export

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	body	Required	Country code, e.g. US; use the country list.
`keyword`	string	body	Required	Project identifier returned by the corresponding project list.
`numbers`	array	body	Required	Phone numbers to process. · Up to 500 items

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/expire/export' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  --data '{"country_id":"US","numbers":["replace-with-numbers"],"keyword":"replace-with-project-id"}'

Response Example File download

Success returns text or a file stream; errors return code/msg JSON.

Query number expiration times

/openapi/v1/long_term/number/expire/query

POST

https://www.sms9527api.com/openapi/v1/long_term/number/expire/query

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	body	Required	Country code, e.g. US; use the country list.
`keyword`	string	body	Required	Project identifier returned by the corresponding project list.
`numbers`	array	body	Required	Phone numbers to process. · Up to 500 items

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/expire/query' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  --data '{"country_id":"US","numbers":["replace-with-numbers"],"keyword":"replace-with-project-id"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Export all numbers

/openapi/v1/long_term/number/export/all

GET

https://www.sms9527api.com/openapi/v1/long_term/number/export/all

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	query	Optional	Country code, e.g. US; use the country list.
`keyword`	string	query	Optional	Project identifier returned by the corresponding project list.
`domain`	string	query	Optional	Export domain returned by the business export domain list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/export/all' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example File download

Success returns text or a file stream; errors return code/msg JSON.

Export batch numbers

/openapi/v1/long_term/number/export/down

GET

https://www.sms9527api.com/openapi/v1/long_term/number/export/down

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`batch_number`	string	query	Optional	Number batch ID from the batch list.
`keyword`	string	query	Optional	Project identifier returned by the corresponding project list.
`domain`	string	query	Optional	Export domain returned by the business export domain list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/export/down' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example File download

Success returns text or a file stream; errors return code/msg JSON.

Export remaining project numbers

/openapi/v1/long_term/number/export/remaining

GET

https://www.sms9527api.com/openapi/v1/long_term/number/export/remaining

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`keyword_id`	string	query	Required	Project ID returned by the corresponding project list.
`country_id`	string	query	Required	Country code, e.g. US; use the country list.
`days`	integer	query	Required	Duration in days.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/export/remaining?keyword_id=replace-with-project-id&country_id=US&days=1' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example File download

Success returns text or a file stream; errors return code/msg JSON.

Reset batch SMS code receiving links

/openapi/v1/long_term/number/export/reset

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/number/export/reset

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`batch_number`	string	body	Required	Number batch ID from the batch list.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/export/reset' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"batch_number":"replace-with-batch-number"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Batch number list

/openapi/v1/long_term/number/list

GET

https://www.sms9527api.com/openapi/v1/long_term/number/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`batch_number`	string	query	Required	Number batch ID from the batch list.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`number`	string	query	Optional	Phone number or number filter.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/list?batch_number=replace-with-batch-number&page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

SMS code receiving records

/openapi/v1/long_term/number/msg/list

GET

https://www.sms9527api.com/openapi/v1/long_term/number/msg/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`number`	string	query	Optional	Phone number or number filter.
`keyword`	string	query	Optional	Project identifier returned by the corresponding project list.
`time_range`	integer	query	Required	Look back 1, 7 or 30 days.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/msg/list?page=1&size=20&time_range=1' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Export reset numbers

/openapi/v1/long_term/number/reset/export

GET

https://www.sms9527api.com/openapi/v1/long_term/number/reset/export

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`reset_id`	string	query	Required	Link reset record ID from the link reset record list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/reset/export?reset_id=replace-with-reset-id' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example File download

Success returns text or a file stream; errors return code/msg JSON.

Link reset records

/openapi/v1/long_term/number/reset/list

GET

https://www.sms9527api.com/openapi/v1/long_term/number/reset/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`country_id`	string	query	Optional	Country code, e.g. US; use the country list.
`keyword`	string	query	Optional	Project identifier returned by the corresponding project list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/reset/list?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Project inventory

/openapi/v1/long_term/project/count

GET

https://www.sms9527api.com/openapi/v1/long_term/project/count

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	query	Required	Country code, e.g. US; use the country list.
`keyword_id`	string	query	Optional	Project ID returned by the corresponding project list.
`is_all_project`	boolean	query	Optional	Search all projects instead of a single project.
`days`	integer	query	Required	Duration in days.
`complete_numbers`	string	query	Optional	Complete numbers used to match available numbers.
`with_voice_code`	boolean	query	Optional	Only include numbers or projects with voice code support.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/project/count?country_id=US&days=1' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Monthly rental project list

/openapi/v1/long_term/template/drop

GET

https://www.sms9527api.com/openapi/v1/long_term/template/drop

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	query	Required	Country code, e.g. US; use the country list.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`keyword`	string	query	Optional	Project identifier returned by the corresponding project list.
`with_voice_code`	boolean	query	Optional	Only include numbers or projects with voice code support.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/template/drop?country_id=US&page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Voice code price

/openapi/v1/long_term/voice_code/price

GET

https://www.sms9527api.com/openapi/v1/long_term/voice_code/price

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	query	Required	Country code, e.g. US; use the country list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/voice_code/price?country_id=US' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Purchase voice code

/openapi/v1/long_term/voice_code/upgrade

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/voice_code/upgrade

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`all_selected`	boolean	body	Optional	Select all matching numbers; at most 500 per operation.
`excluded_ids`	array	body	Optional	Number record IDs excluded from an all-matching selection. · Up to 500 items
`selection_filter`	object	body	Optional	Filters used when selecting all matching numbers.
`selection_filter.country_id`	string	body	Optional	Country code, e.g. US; use the country list.
`selection_filter.expire_end`	integer	body	Optional	Expiration end time as a Unix timestamp.
`selection_filter.expire_start`	integer	body	Optional	Expiration start time as a Unix timestamp.
`selection_filter.group_id`	string	body	Optional	Number group ID from the group list.
`selection_filter.keyword`	string	body	Optional	Project identifier returned by the corresponding project list.
`selection_filter.number`	string	body	Optional	Phone number or number filter.
`selection_filter.status`	string	body	Optional	Status filter.
`uuids`	array	body	Optional	Number UUIDs to upgrade. · Up to 500 items

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/voice_code/upgrade' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Create number group

/openapi/v1/long_term/group/create

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/group/create

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`description`	string	body	Optional	Number group description.
`group_name`	string	body	Required	Number group name.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/group/create' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"group_name":"replace-with-group-name"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Delete number group

/openapi/v1/long_term/group/delete/{id}

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/group/delete/{id}

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`id`	string	path	Required	Record ID from the corresponding list.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/group/delete/replace-with-id' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Number group list

/openapi/v1/long_term/group/list

GET

https://www.sms9527api.com/openapi/v1/long_term/group/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/group/list' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Update number group

/openapi/v1/long_term/group/update/{id}

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/group/update/{id}

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`id`	string	path	Required	Record ID from the corresponding list.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`description`	string	body	Optional	Number group description.
`group_name`	string	body	Optional	Number group name.
`sort_order`	integer	body	Optional	Display sort order.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/group/update/replace-with-id' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Export group numbers (query filter)

/openapi/v1/long_term/number/group/export

GET

https://www.sms9527api.com/openapi/v1/long_term/number/group/export

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`AllSelected`	boolean	query	Optional	Select all matching numbers.
`SelectionFilter`	object	query	Optional	Filters used when selecting all matching numbers.
`ExcludedIDs`	array	query	Optional	Number record IDs excluded from an all-matching selection. · Up to 500 items
`group_id`	string	query	Optional	Number group ID from the group list.
`number_ids`	string	query	Optional	Number record IDs to process.
`domain`	string	query	Optional	Export domain returned by the business export domain list.
`status`	string	query	Optional	Status filter.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/group/export' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example File download

Success returns text or a file stream; errors return code/msg JSON.

Export group numbers (JSON body)

/openapi/v1/long_term/number/group/export

POST

https://www.sms9527api.com/openapi/v1/long_term/number/group/export

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`all_selected`	boolean	body	Optional	Select all matching numbers; at most 500 per operation.
`domain`	string	body	Optional	Export domain returned by the business export domain list.
`excluded_ids`	array	body	Optional	Number record IDs excluded from an all-matching selection. · Up to 500 items
`group_id`	string	body	Optional	Number group ID from the group list.
`number_ids`	string	body	Optional	Number record IDs to process.
`selection_filter`	object	body	Optional	Filters used when selecting all matching numbers.
`selection_filter.country_id`	string	body	Optional	Country code, e.g. US; use the country list.
`selection_filter.expire_end`	integer	body	Optional	Expiration end time as a Unix timestamp.
`selection_filter.expire_start`	integer	body	Optional	Expiration start time as a Unix timestamp.
`selection_filter.group_id`	string	body	Optional	Number group ID from the group list.
`selection_filter.keyword`	string	body	Optional	Project identifier returned by the corresponding project list.
`selection_filter.number`	string	body	Optional	Phone number or number filter.
`selection_filter.status`	string	body	Optional	Status filter.
`status`	string	body	Optional	Status filter.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/group/export' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  --data '{}'

Response Example File download

Success returns text or a file stream; errors return code/msg JSON.

Batch set number groups

/openapi/v1/long_term/number/group/set

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/number/group/set

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`all_selected`	boolean	body	Optional	Select all matching numbers; at most 500 per operation.
`excluded_ids`	array	body	Optional	Number record IDs excluded from an all-matching selection. · Up to 500 items
`group_id`	string	body	Optional	Number group ID from the group list.
`ids`	array	body	Optional	Number record IDs, up to 500. · Up to 500 items
`keyword`	string	body	Optional	Project identifier returned by the corresponding project list.
`numbers`	array	body	Optional	Phone numbers to process. · Up to 500 items
`selection_filter`	object	body	Optional	Filters used when selecting all matching numbers.
`selection_filter.country_id`	string	body	Optional	Country code, e.g. US; use the country list.
`selection_filter.expire_end`	integer	body	Optional	Expiration end time as a Unix timestamp.
`selection_filter.expire_start`	integer	body	Optional	Expiration start time as a Unix timestamp.
`selection_filter.group_id`	string	body	Optional	Number group ID from the group list.
`selection_filter.keyword`	string	body	Optional	Project identifier returned by the corresponding project list.
`selection_filter.number`	string	body	Optional	Phone number or number filter.
`selection_filter.status`	string	body	Optional	Status filter.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/group/set' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Set number auto-renewal

/openapi/v1/long_term/number/manage/auto-renew

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/number/manage/auto-renew

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`enabled`	boolean	body	Required	Whether the feature is enabled.
`id`	string	body	Required	Record ID from the corresponding list.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/manage/auto-renew' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"id":"replace-with-id","enabled":false}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Batch set auto-renewal

/openapi/v1/long_term/number/manage/auto-renew/batch

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/number/manage/auto-renew/batch

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`all_selected`	boolean	body	Optional	Select all matching numbers; at most 500 per operation.
`enabled`	boolean	body	Required	Whether the feature is enabled.
`excluded_ids`	array	body	Optional	Number record IDs excluded from an all-matching selection. · Up to 500 items
`ids`	array	body	Optional	Number record IDs, up to 500. · Up to 500 items
`selection_filter`	object	body	Optional	Filters used when selecting all matching numbers.
`selection_filter.country_id`	string	body	Optional	Country code, e.g. US; use the country list.
`selection_filter.expire_end`	integer	body	Optional	Expiration end time as a Unix timestamp.
`selection_filter.expire_start`	integer	body	Optional	Expiration start time as a Unix timestamp.
`selection_filter.group_id`	string	body	Optional	Number group ID from the group list.
`selection_filter.keyword`	string	body	Optional	Project identifier returned by the corresponding project list.
`selection_filter.number`	string	body	Optional	Phone number or number filter.
`selection_filter.status`	string	body	Optional	Status filter.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/manage/auto-renew/batch' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"enabled":false}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Number management list

/openapi/v1/long_term/number/manage/list

GET

https://www.sms9527api.com/openapi/v1/long_term/number/manage/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`country_id`	string	query	Optional	Country code, e.g. US; use the country list.
`keyword`	string	query	Optional	Project identifier returned by the corresponding project list.
`number`	string	query	Optional	Phone number or number filter.
`status`	string	query	Optional	Status filter.
`group_id`	string	query	Optional	Number group ID from the group list.
`expire_start`	integer	query	Optional	Expiration start time as a Unix timestamp.
`expire_end`	integer	query	Optional	Expiration end time as a Unix timestamp.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/long_term/number/manage/list?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Batch renew by number ID

/openapi/v1/long_term/number/manage/renew

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/number/manage/renew

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`all_selected`	boolean	body	Optional	Select all matching numbers; at most 500 per operation.
`excluded_ids`	array	body	Optional	Number record IDs excluded from an all-matching selection. · Up to 500 items
`ids`	array	body	Optional	Number record IDs, up to 500. · Up to 500 items
`selection_filter`	object	body	Optional	Filters used when selecting all matching numbers.
`selection_filter.country_id`	string	body	Optional	Country code, e.g. US; use the country list.
`selection_filter.expire_end`	integer	body	Optional	Expiration end time as a Unix timestamp.
`selection_filter.expire_start`	integer	body	Optional	Expiration start time as a Unix timestamp.
`selection_filter.group_id`	string	body	Optional	Number group ID from the group list.
`selection_filter.keyword`	string	body	Optional	Project identifier returned by the corresponding project list.
`selection_filter.number`	string	body	Optional	Phone number or number filter.
`selection_filter.status`	string	body	Optional	Status filter.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/manage/renew' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Number voice code purchase summary

/openapi/v1/long_term/number/manage/selection/voice-summary

POST

https://www.sms9527api.com/openapi/v1/long_term/number/manage/selection/voice-summary

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`all_selected`	boolean	body	Optional	Select all matching numbers; at most 500 per operation.
`excluded_ids`	array	body	Optional	Number record IDs excluded from an all-matching selection. · Up to 500 items
`selection_filter`	object	body	Optional	Filters used when selecting all matching numbers.
`selection_filter.country_id`	string	body	Optional	Country code, e.g. US; use the country list.
`selection_filter.expire_end`	integer	body	Optional	Expiration end time as a Unix timestamp.
`selection_filter.expire_start`	integer	body	Optional	Expiration start time as a Unix timestamp.
`selection_filter.group_id`	string	body	Optional	Number group ID from the group list.
`selection_filter.keyword`	string	body	Optional	Project identifier returned by the corresponding project list.
`selection_filter.number`	string	body	Optional	Phone number or number filter.
`selection_filter.status`	string	body	Optional	Status filter.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/manage/selection/voice-summary' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  --data '{}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Batch transfer by number ID

/openapi/v1/long_term/number/manage/transfer

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/long_term/number/manage/transfer

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`all_selected`	boolean	body	Optional	Select all matching numbers; at most 500 per operation.
`excluded_ids`	array	body	Optional	Number record IDs excluded from an all-matching selection. · Up to 500 items
`ids`	array	body	Optional	Number record IDs, up to 500. · Up to 500 items
`remark`	string	body	Optional	Remark or note sent with the operation.
`selection_filter`	object	body	Optional	Filters used when selecting all matching numbers.
`selection_filter.country_id`	string	body	Optional	Country code, e.g. US; use the country list.
`selection_filter.expire_end`	integer	body	Optional	Expiration end time as a Unix timestamp.
`selection_filter.expire_start`	integer	body	Optional	Expiration start time as a Unix timestamp.
`selection_filter.group_id`	string	body	Optional	Number group ID from the group list.
`selection_filter.keyword`	string	body	Optional	Project identifier returned by the corresponding project list.
`selection_filter.number`	string	body	Optional	Phone number or number filter.
`selection_filter.status`	string	body	Optional	Status filter.
`target_user_id`	string	body	Required	ID of the user receiving the numbers.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/long_term/number/manage/transfer' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"target_user_id":"replace-with-target-user-id"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Expiring number statistics

/openapi/v1/number/expiring/count

GET

https://www.sms9527api.com/openapi/v1/number/expiring/count

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/number/expiring/count' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Renew number

/openapi/v1/number/renew

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/number/renew

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	body	Required	Country code, e.g. US; use the country list.
`keyword`	string	body	Required	Project identifier returned by the corresponding project list.
`number`	string	body	Required	Phone number or number filter.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/number/renew' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"country_id":"US","keyword":"replace-with-project-id","number":"replace-with-number"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Renewal order details

/openapi/v1/number/renew/order/detail

GET

https://www.sms9527api.com/openapi/v1/number/renew/order/detail

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`order_no`	string	query	Required	Order number from the order list.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/number/renew/order/detail?order_no=replace-with-order-no&page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Export renewal order numbers

/openapi/v1/number/renew/order/export

GET

https://www.sms9527api.com/openapi/v1/number/renew/order/export

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`order_no`	string	query	Required	Order number from the order list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/number/renew/order/export?order_no=replace-with-order-no' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example File download

Success returns text or a file stream; errors return code/msg JSON.

Renewal order list

/openapi/v1/number/renew/order/list

GET

https://www.sms9527api.com/openapi/v1/number/renew/order/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`status`	string	query	Optional	Status filter.
`order_no`	string	query	Optional	Order number from the order list.
`number`	string	query	Optional	Phone number or number filter.
`start_time`	integer	query	Optional	Start time as a Unix timestamp.
`end_time`	integer	query	Optional	End time as a Unix timestamp.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/number/renew/order/list?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Renewal price

/openapi/v1/number/renew/price

GET

https://www.sms9527api.com/openapi/v1/number/renew/price

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	query	Required	Country code, e.g. US; use the country list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/number/renew/price?country_id=US' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Transfer number

/openapi/v1/number/transfer

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/number/transfer

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`keyword`	string	body	Required	Project identifier returned by the corresponding project list.
`numbers`	string	body	Required	Phone numbers to process.
`remark`	string	body	Optional	Remark or note sent with the operation.
`target_user_id`	string	body	Required	ID of the user receiving the numbers.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/number/transfer' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"numbers":"replace-with-numbers","target_user_id":"replace-with-target-user-id","keyword":"replace-with-project-id"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Transfer records

/openapi/v1/number/transfer/list

GET

https://www.sms9527api.com/openapi/v1/number/transfer/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 100
`type`	string	query	Optional	Record type filter.
`start_time`	integer	query	Optional	Start time as a Unix timestamp.
`end_time`	integer	query	Optional	End time as a Unix timestamp.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/number/transfer/list?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Reserve all projects

/openapi/v1/reservation/create

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/reservation/create

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	body	Required	Country code, e.g. US; use the country list.
`exp_num`	integer	body	Required	Number quantity requested. · ≥ 1 · ≤ 500

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/reservation/create' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"exp_num":1,"country_id":"US"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Reservation records

/openapi/v1/reservation/list

GET

https://www.sms9527api.com/openapi/v1/reservation/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`status`	integer	query	Optional	Status filter.
`reservation_no`	string	query	Optional	Reservation number from the reservation list.
`country_id`	string	query	Optional	Country code, e.g. US; use the country list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/reservation/list?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Reserve single project

/openapi/v1/reservation/single/create

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/reservation/single/create

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`country_id`	string	body	Required	Country code, e.g. US; use the country list.
`exp_num`	integer	body	Required	Number quantity requested. · ≥ 1 · ≤ 500
`keyword_id`	string	body	Required	Project ID returned by the corresponding project list.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/reservation/single/create' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"exp_num":1,"country_id":"US","keyword_id":"replace-with-project-id"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Create eSIM order

/openapi/v1/esim/order/create

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/esim/order/create

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`package_id`	string	body	Required	eSIM package identifier.
`quantity`	integer	body	Required	Quantity to purchase. · ≥ 1 · ≤ 500

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/esim/order/create' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"package_id":"replace-with-package-id","quantity":1}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Extract eSIM order

/openapi/v1/esim/order/extract

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/esim/order/extract

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`order_no`	string	body	Required	Order number from the order list.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/esim/order/extract' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"order_no":"replace-with-order-no"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

eSIM order list

/openapi/v1/esim/order/list

GET

https://www.sms9527api.com/openapi/v1/esim/order/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`status`	integer	query	Optional	Status filter.
`order_no`	string	query	Optional	Order number from the order list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/esim/order/list?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

eSIM packages

/openapi/v1/esim/package/drop

GET

https://www.sms9527api.com/openapi/v1/esim/package/drop

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/esim/package/drop' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

eSIM price

/openapi/v1/esim/price/config

GET

https://www.sms9527api.com/openapi/v1/esim/price/config

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`package_id`	string	query	Required	eSIM package identifier.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/esim/price/config?package_id=replace-with-package-id' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Create recharge order

/openapi/v1/create/transaction

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/create/transaction

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`amount`	number	body	Required	Recharge amount.
`pay_type`	string	body	Required	Payment method.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/create/transaction' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"amount":1,"pay_type":"replace-with-pay-type"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Deduction records

/openapi/v1/deduction/record

GET

https://www.sms9527api.com/openapi/v1/deduction/record

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/deduction/record?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Recharge records

/openapi/v1/recharge/record

GET

https://www.sms9527api.com/openapi/v1/recharge/record

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/recharge/record?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Support ticket categories

/openapi/v1/ticket/categories

GET

https://www.sms9527api.com/openapi/v1/ticket/categories

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/ticket/categories' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Create support ticket

/openapi/v1/ticket/create

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/ticket/create

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`category`	string	body	Optional	Support ticket category.
`content`	string	body	Required	Support ticket content.
`priority`	integer	body	Optional	Support ticket priority.
`title`	string	body	Required	Support ticket title.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/ticket/create' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"title":"replace-with-title","content":"replace-with-content"}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Support ticket details

/openapi/v1/ticket/detail/{ticket_no}

GET

https://www.sms9527api.com/openapi/v1/ticket/detail/{ticket_no}

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`ticket_no`	string	path	Required	Ticket number from the ticket list.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/ticket/detail/replace-with-ticket-no' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Support ticket list

/openapi/v1/ticket/list

GET

https://www.sms9527api.com/openapi/v1/ticket/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`status`	string	query	Optional	Status filter.
`category`	string	query	Optional	Support ticket category.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/ticket/list?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

View inbox message and mark as read

/openapi/v1/message/detail

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/message/detail

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`id`	integer	body	Required	Record ID from the corresponding list.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/message/detail' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"id":1}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Inbox message list

/openapi/v1/message/list

GET

https://www.sms9527api.com/openapi/v1/message/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`is_read`	string	query	Optional	Read status filter: 0 unread, 1 read.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/message/list?page=1&size=20' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Mark inbox message as read

/openapi/v1/message/read

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/message/read

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`message_id`	integer	body	Required	Inbox message ID from the inbox message list.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/message/read' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id' \
  -H 'Content-Type: application/json' \
  --data '{"message_id":1}'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Mark all inbox messages as read

/openapi/v1/message/read/all

POST

Write requests require Idempotency-Key. Retry with the same key and request content; do not use a new key while the result is pending or uncertain.

https://www.sms9527api.com/openapi/v1/message/read/all

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Idempotency-Key`	string	header	Required	8–128 letters, digits or ._:-. Unique per new operation; reuse for retries.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X POST 'https://www.sms9527api.com/openapi/v1/message/read/all' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Idempotency-Key: replace-with-unique-request-id'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Unread inbox message count

/openapi/v1/message/unread/count

GET

https://www.sms9527api.com/openapi/v1/message/unread/count

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/message/unread/count' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

{
  "code": 200,
  "data": {
    "count": 3
  },
  "msg": "ok"
}

Free trial countries

/openapi/v1/free_trial/country/list

GET

https://www.sms9527api.com/openapi/v1/free_trial/country/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/free_trial/country/list' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Free trial numbers

/openapi/v1/free_trial/number/list

GET

https://www.sms9527api.com/openapi/v1/free_trial/number/list

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`country_id`	string	query	Required	Country code, e.g. US; use the country list.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/free_trial/number/list?page=1&size=20&country_id=US' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Free trial SMS code records

/openapi/v1/free_trial/number/msg

GET

https://www.sms9527api.com/openapi/v1/free_trial/number/msg

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.
`page`	integer	query	Required	Page number, starting at 1. · ≥ 1 · ≤ 1000000
`size`	integer	query	Required	Records per page. · ≥ 1 · ≤ 500
`number`	string	query	Required	Phone number or number filter.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/free_trial/number/msg?page=1&size=20&number=replace-with-number' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Public free numbers

/openapi/v1/number/free

GET

https://www.sms9527api.com/openapi/v1/number/free

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/number/free' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Country list

/openapi/v1/country/code/drop

GET

https://www.sms9527api.com/openapi/v1/country/code/drop

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/country/code/drop' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Business export domain list

/openapi/v1/domain/drop

GET

https://www.sms9527api.com/openapi/v1/domain/drop

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/domain/drop' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

Project dropdown list

/openapi/v1/keyword/drop

GET

https://www.sms9527api.com/openapi/v1/keyword/drop

Request Parameters

Parameter Name	Parameter Type	Location	Required	Parameter Description
`Authorization`	string	header	Required	Profile API Key, formatted as Bearer <API_KEY>.
`Accept-Language`	string	header	Optional	Response language: zh-CN, en, ru.

Request example

curl -X GET 'https://www.sms9527api.com/openapi/v1/keyword/drop' \
  -H 'Authorization: Bearer <API_KEY>'

Response Example application/json

This illustrates the common envelope; data varies by operation. Check the business code and individual batch results even with HTTP 200.

{
  "code": 200,
  "msg": "ok",
  "data": null
}

SMS Verification API Documentation

Basic Information

API Endpoints

Account balance

Request Parameters

Request exampleCopy

Response Example application/json

Purchase monthly rental number

Request Parameters

Request exampleCopy

Response Example application/json

Monthly rental batch list

Request Parameters

Request exampleCopy

Response Example application/json

Batch reset SMS code receiving links

Request Parameters

Request exampleCopy

Response Example application/json

Number range inventory

Request Parameters

Request exampleCopy

Response Example application/json

Check whether number exists

Request Parameters

Request exampleCopy

Response Example application/json

Export number expiration times

Request Parameters

Request exampleCopy

Response Example File download

Query number expiration times

Request Parameters

Request exampleCopy

Response Example application/json

Export all numbers

Request Parameters

Request exampleCopy

Response Example File download

Export batch numbers

Request Parameters

Request exampleCopy

Response Example File download

Export remaining project numbers

Request Parameters

Request exampleCopy

Response Example File download

Reset batch SMS code receiving links

Request Parameters

Request exampleCopy

Response Example application/json

Batch number list

Request Parameters

Request exampleCopy

Response Example application/json

SMS code receiving records

Request Parameters

Request exampleCopy

Response Example application/json

Export reset numbers

Request Parameters

Request exampleCopy

Response Example File download

Link reset records

Request Parameters

Request exampleCopy

Response Example application/json

Project inventory

Request Parameters

Request exampleCopy

Response Example application/json

Monthly rental project list

Request Parameters

Request exampleCopy

Response Example application/json

Voice code price

Request Parameters

Request exampleCopy

Response Example application/json

Purchase voice code

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example

Request example