Developer API & SDK

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

# Poll new messages (pass cursor from last poll)
curl -s "https://instant-sms.com/api/v1/numbers/14165550198/messages?after=1719859000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import { InstantSmsClient } from '@instantsms/sdk';

const client = new InstantSmsClient({
  apiKey: process.env.INSTANTSMS_API_KEY,
});

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

// Poll until a verification code arrives
let code;
for (let i = 0; i < 24; i++) {
  const { data: messages } = await client.messages.list(number.slug, {
    after: messages?.meta?.cursor,
  });
  code = messages.find((m) => m.code)?.code;
  if (code) break;
  await new Promise((r) => setTimeout(r, 5000));
}
console.log('Verification code:', code);

use InstantSms\InstantSmsClient;

$client = new InstantSmsClient(apiKey: config('services.instantsms.key'));

// List numbers and pick one
$numbers = $client->numbers()->forCountry('ca');
$number = collect($numbers)->firstWhere('active', true);

// Poll for the verification code
$code = null;
$cursor = null;

for ($attempt = 0; $attempt < 24; $attempt++) {
    $response = $client->messages()->forNumber($number->slug, after: $cursor);
    $cursor = $response->meta->cursor;
    $code = collect($response->data)->firstWhere('code', '!=', null)?->code;

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

    sleep(5);
}

// Use $code in your Pest / PHPUnit assertion