API · 27 Oct 2026
SMS-COOL API Documentation Guide: Order Numbers and Read Codes
By Team SMS-COOL
The SMS verification API documentation is the fastest path to automating number orders and code reading. Instead of clicking through a dashboard, your app can request a number, poll for the message and close the order. This guide explains the typical flow and the concepts you need to build a reliable integration.
Direct answer: The SMS-COOL API lets you order a virtual number, read incoming codes and cancel orders programmatically. You authenticate with your API key, call the order endpoint, poll the message endpoint and close or cancel the order.
What Can You Build With the API?
The API is designed for developers who need automated verification. Common uses include testing pipelines, sign-up automation and reseller platforms. Read the full reference at https://sms-cool.com/api-docs.
- Order numbers automatically
- Read incoming codes
- Cancel failed orders
- Track order status
Typical API Flow
- Authenticate with your API key.
- List available services and countries.
- Create an order for a number.
- Poll the message endpoint for the code.
- Close the order on success or cancel on failure.
Key Concepts to Understand
| Concept | Meaning |
|---|---|
| API key | Your authentication token |
| Order | A reserved virtual number |
| Status | Pending, received or cancelled |
| Polling | Repeated checks for the message |
How Do You Handle Errors?
Build retries with backoff and handle the cancel path. A virtual number not receiving SMS may still happen, so your code should cancel the order and try a different number. Log every response for debugging.
How to Keep Your API Key Safe
- Store keys in environment variables
- Never expose keys in client-side code
- Rotate keys regularly
- Limit permissions where possible
How to Cancel an SMS Verification Order and Get a Refund
Use the cancel endpoint within the allowed window to trigger a cancel SMS verification order refund. Cancel before reading a code, and check the status field to confirm the refund.
Frequently Asked Questions
Where is the API documentation?
At https://sms-cool.com/api-docs, with endpoints and parameters.
Do I need an account to use the API?
Yes. Register first, then generate your API key.
Can I automate refunds?
You can call the cancel endpoint programmatically within the window.
What if a number fails?
Cancel the order and retry with a different number or country.
Conclusion
The SMS verification API documentation gives you everything to order numbers and read codes automatically. Read the reference at SMS-COOL API docs and start building.
Related reading: https://sms-cool.com/blog.