Welcome to eskiz-pkg, the open source Python SDK for Eskiz.uz SMS API.
You can use it for both synchronous and asynchronous applications with automatic token refresh.
| ✅ Sync & Async Support | ✅ Automatic Token Refresh |
| ✅ Batch SMS Sending | ✅ International SMS |
| ✅ Message Templates | ✅ Detailed Reporting |
$ pip install eskiz-pkg
$ pip install eskiz-pkg[async]
URL: https://notify.eskiz.uz/api/
Email: test@eskiz.uz
Password: j6DWtQjjpLDNjWEk74Sx
Example for send SMS:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
text = "Hello from Python"
resp = eskiz_client.send_sms(
phone_number=998888351717,
message=text
)
print(resp)
Response
id='e837dec2-2f5a-44a9-a1d1-6fcc13e94d86' message='Waiting for SMS provider' status='waiting'
Example for refresh token:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
resp = eskiz_client.refresh_token()
print(resp)
Response
eyJleHAiOjE3MjA4NTQ5NTUsImlhdCI6MTcxODI2Mjk1NSwicm9sZSI6InVzZXIiLCJzaWduIjoiNjU5OWQ1MWU4ZjU0NTFmMjc3OTQ1MTA3N2NmMzdmMTMxM2QzYjkzMDk1Y
Example for checking the SMS balance:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
balance = eskiz_client.get_balance()
print(f"Remaining SMS credits: {balance}")
Response
Remaining SMS credits: 0
Example for sending multiple SMS messages in a single request:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
messages = [
{"user_sms_id": "msg1", "to": 998888351717, "text": "Hello from Python 1"},
{"user_sms_id": "msg2", "to": 998888351718, "text": "Hello from Python 2"}
]
resp = eskiz_client.send_batch_sms(
messages=messages,
dispatch_id=123 # Optional
)
print(resp)
Response
id='9309c090-8bc5-4fae-9d82-6b84af55affe' message='Waiting for SMS provider' status=['waiting', 'waiting']
Example for sending SMS to international numbers:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
resp = eskiz_client.send_global_sms(
mobile_phone="12025550123", # US number
message="Hello from Python",
country_code="US"
)
print(resp)
Response
success=True
Example for retrieving user messages within a date range:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
resp = eskiz_client.get_user_messages(
start_date="2023-11-01 00:00",
end_date="2023-11-02 23:59",
page_size="20"
)
print(f"Total messages: {resp.data.total}")
for msg in resp.data.result:
print(f"Message to {msg.to}: {msg.message} - Status: {msg.status}")
Example for retrieving user messages by dispatch ID:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
resp = eskiz_client.get_user_messages_by_dispatch(
dispatch_id="123"
)
print(f"Total messages: {resp.data.total}")
for msg in resp.data.result:
print(f"Message to {msg.to}: {msg.message} - Status: {msg.status}")
Example for retrieving status of a dispatch:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
resp = eskiz_client.get_dispatch_status(
user_id="1",
dispatch_id="123"
)
for status_item in resp.data:
print(f"Status: {status_item.status}, Total: {status_item.total}")
Example for retrieving status of a specific message by ID:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
resp = eskiz_client.get_message_status(
message_id="c779e2c3-9140-4b0f-862d-ee5639c3f5e0"
)
print(f"Message to {resp.data.to}: {resp.data.message} - Status: {resp.data.status}")
Example for retrieving user templates:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
resp = eskiz_client.get_templates()
for template in resp.result:
print(f"Template ID: {template.id}, Template: {template.template}")
Example for exporting messages for a specific month:
Request
from eskiz.client.sync import ClientSync
eskiz_client = ClientSync(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
)
csv_data = eskiz_client.export_messages(
year="2025",
month="1"
)
# Save to file
with open("messages_export.csv", "w") as f:
f.write(csv_data)
print("Export saved to messages_export.csv")
The library also provides an async client for use with modern Python applications using asyncio.
import asyncio
from eskiz.client import AsyncClient
async def main():
async with AsyncClient(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
) as client:
# Send SMS
response = await client.send_sms(
phone_number=998888351717,
message="Hello from Python"
)
print(response)
# Check balance
balance = await client.get_balance()
print(f"Balance: {balance}")
asyncio.run(main())
import asyncio
from eskiz.client import AsyncClient
async def main():
async with AsyncClient(
email="test@eskiz.uz",
password="j6DWtQjjpLDNjWEk74Sx",
) as client:
messages = [
{"user_sms_id": "msg1", "to": 998888351717, "text": "Hello from Python 1"},
{"user_sms_id": "msg2", "to": 998888351718, "text": "Hello from Python 2"}
]
response = await client.send_batch_sms(messages=messages)
print(response)
asyncio.run(main())
FAQs
Python client for Eskiz.uz SMS API
We found that eskiz-pkg demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
npm now supports Trusted Publishing with OIDC, enabling secure package publishing directly from CI/CD workflows without relying on long-lived tokens.
Research
/Security News
A RubyGems malware campaign used 60 malicious packages posing as automation tools to steal credentials from social media and marketing tool users.
Security News
The CNA Scorecard ranks CVE issuers by data completeness, revealing major gaps in patch info and software identifiers across thousands of vulnerabilities.