Quick start

1. Create an account at app.getsms.tech with your email or Google.

2. Open API keys and copy your sk_test_… test key. It simulates sends without charging anything (see Sandbox).

3. Send your first message:

   cURL

   curl -X POST https://api.getsms.tech/v1/messages/send \
     -H "x-api-key: sk_test_VOTRE_CLE" \
     -H "Content-Type: application/json" \
     -d '{"to": "+212612345678", "content": "Hello from GetSMS"}'

   Node.js

   const res = await fetch("https://api.getsms.tech/v1/messages/send", {
     method: "POST",
     headers: {
       "x-api-key": process.env.GETSMS_API_KEY,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({ to: "+212612345678", content: "Hello from GetSMS" }),
   });
   const { data } = await res.json();
   console.log(data.id, data.status); // "pending"

   Python

   import os, requests
   
   res = requests.post(
       "https://api.getsms.tech/v1/messages/send",
       headers={"x-api-key": os.environ["GETSMS_API_KEY"]},
       json={"to": "+212612345678", "content": "Hello from GetSMS"},
   )
   print(res.json()["data"]["status"])  # "pending"

   PHP

   <?php
   $ch = curl_init("https://api.getsms.tech/v1/messages/send");
   curl_setopt_array($ch, [
       CURLOPT_POST => true,
       CURLOPT_RETURNTRANSFER => true,
       CURLOPT_HTTPHEADER => [
           "x-api-key: " . getenv("GETSMS_API_KEY"),
           "Content-Type: application/json",
       ],
       CURLOPT_POSTFIELDS => json_encode([
           "to" => "+212612345678",
           "content" => "Hello from GetSMS",
       ]),
   ]);
   $response = json_decode(curl_exec($ch), true);

4. The response comes back right away with the pending status: the message is queued. Follow what happens next with webhooks or by retrieving the message.