unlimited-messaging

Official Python client for the Unlimited Messaging API — send and receive WhatsApp messages programmatically.

Website: unlimitedmessaging.app
Docs: docs.unlimitedmessaging.app
API reference: api.unlimitedmessaging.app
GitHub: unlimitedmessaging/unlimited-messaging-sdk
PyPI: unlimited-messaging

Installation

pip install unlimited-messaging

Quick start

import os
from unlimited_messaging import UnlimitedMessagingApi

client = UnlimitedMessagingApi(
    token=os.environ["API_TOKEN"],
)

# Send a WhatsApp message
message = client.message.send(
    recipient="+33612345678",
    text="Hello!",
)

print(message.id, message.status)

Authentication

Get your API token from the dashboard and pass it as the token argument.

client = UnlimitedMessagingApi(token="your_api_token")

Examples

Send a message

message = client.message.send(
    recipient="+33612345678",
    text="Hello from the SDK!",
    sim_id="optional-sim-id",  # force a specific SIM
)

List messages

result = client.message.find_all(
    page=1,
    limit=20,
    status="DELIVERED",   # PENDING | SENDING | SENT | DELIVERED | READ | FAILED
    search="keyword",
)

print(f"{result.total} messages")
for msg in result.data:
    print(msg.id, msg.status, msg.text)

Get a single message

msg = client.message.find_one("message-id")
print(msg.id, msg.status, msg.text)

List linked SIMs

sims = client.sim.get_linked_sims()

for sim in sims:
    print(sim.id, sim.phone_number)

Async support

import asyncio
from unlimited_messaging import AsyncUnlimitedMessagingApi

client = AsyncUnlimitedMessagingApi(token="your_api_token")

async def main():
    message = await client.message.send(
        recipient="+33612345678",
        text="Hello async!",
    )
    print(message.id, message.status)

asyncio.run(main())

API reference

Method	Description
`message.send`	Send a WhatsApp message
`message.find_all`	List messages with pagination and filters
`message.find_one`	Get a single message by ID
`sim.get_linked_sims`	List linked SIMs

Official documentation: docs.unlimitedmessaging.app Full OpenAPI spec: openapi.yaml

Metadata

Release files for unlimited-messaging 0.1.21

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unlimited-messaging 0.1.21
File	Size	Uploaded
unlimited_messaging-0.1.21.tar.gz	65.2 kB	Oct 3, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for unlimited-messaging 0.1.21
File	Interpreter	ABI	Platform	Reset
unlimited_messaging-0.1.21-py3-none-any.whl 168.0 kB Oct 3, 2026	Python 3	none	any	Details

Total release size: 233.2 kB

Release files / unlimited_messaging-0.1.21.tar.gz

Download URL	unlimited_messaging-0.1.21.tar.gz
Size	65.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`b9a42f3252ddb3af6499c51a7de1e4563d0af77ca6ed6a11326a969d5d839262`
BLAKE2b-256 checksum How to use checksums	`04a8d055621d37a2dde4ca5d231ffa2ccc4d6c2209c3ea58f473a7967596d0fb`
Upload date	Oct 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`

Release files / unlimited_messaging-0.1.21-py3-none-any.whl

Download URL	unlimited_messaging-0.1.21-py3-none-any.whl
Size	168.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`158dce20720879aaff564de254f8c0369842eb6fa1cbd29874f450e318552a71`
BLAKE2b-256 checksum How to use checksums	`1d0c04153eb08427fb4de3bae7ba1ca394719d5487b59d4447f9be12ef252842`
Upload date	Oct 3, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`