Developer REST API

# List US numbers
curl -s "https://instant-sms.com/api/v1/countries/us/numbers" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

# Read an inbox, pulling from the upstream provider first
curl -s "https://instant-sms.com/api/v1/numbers/14165550198/messages?sync=1" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

# Same read without the upstream pull (faster, database only)
curl -s "https://instant-sms.com/api/v1/numbers/14165550198/messages" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

const BASE = 'https://instant-sms.com/api/v1';
const headers = {
  Authorization: `Bearer ${process.env.INSTANTSMS_API_TOKEN}`,
  Accept: 'application/json',
};

const get = async (path) => {
  const response = await fetch(`${BASE}${path}`, { headers });
  if (! response.ok) throw new Error(`${response.status} ${await response.text()}`);
  return response.json();
};

// Pick a Canadian number for your test
const { data: numbers } = await get('/countries/ca/numbers');
const number = numbers.find((n) => n.active);
console.log('Using number:', number.number);

// Trigger the SMS in your app here, then poll for the code
const digits = number.number.replace(/\D/g, '');
let code;

for (let attempt = 0; attempt < 24; attempt++) {
  const { data: messages } = await get(`/numbers/${digits}/messages?sync=1`);
  code = messages.find((m) => m.code)?.code;
  if (code) break;
  await new Promise((resolve) => setTimeout(resolve, 5000));
}

console.log('Verification code:', code);

use Illuminate\Support\Facades\Http;

$api = Http::baseUrl('https://instant-sms.com/api/v1')
    ->withToken(config('services.instantsms.token'))
    ->acceptJson()
    ->throw();

// List numbers and pick an active one
$numbers = $api->get('/countries/ca/numbers')->json('data');
$number = collect($numbers)->firstWhere('active', true);
$digits = preg_replace('/\D/', '', $number['number']);

// Trigger the SMS in your app here, then poll for the code
$code = null;

for ($attempt = 0; $attempt < 24; $attempt++) {
    $messages = $api->get("/numbers/{$digits}/messages", ['sync' => 1])->json('data');
    $code = collect($messages)->firstWhere('code', '!=', null)['code'] ?? null;

    if ($code !== null) {
        break;
    }

    sleep(5);
}

// Use $code in your Pest / PHPUnit assertion