Recipient lookup

curl -sS https://api.isnap.ai/v1/lookup \
  -H "Authorization: Bearer $ISNAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle": "+14155550123", "from_line_id": "line_8Xk2mQ4vTn7Bw9Rz3Lc6Yp1Hd"}'

import { ISnapClient, QuotaExceededError } from '@isnap/sdk'

const client = new ISnapClient({ apiKey: process.env.ISNAP_API_KEY ?? '', maxRetries: 2 })

async function canReceiveImessage(handle: string): Promise<boolean | null> {
  // Every call counts against the lookup limits, repeats included: repeat at most 3 times.
  for (let attempt = 0; attempt < 3; attempt++) {
    const result = await client.lookup.check({ handle, from_line_id: 'line_8Xk2mQ4vTn7Bw9Rz3Lc6Yp1Hd' })
    if (!result.pending) return result.imessage
    await new Promise(resolve => setTimeout(resolve, (result.retry_after ?? 4) * 1000))
  }
  return null // No definite answer after 3 calls: treat it as unknown.
}

try {
  console.log(await canReceiveImessage('+14155550123'))
} catch (err) {
  if (err instanceof QuotaExceededError && err.code === 'lookup_rate_limit_exceeded') {
    console.error(`Lookup limit reached: retry after ${err.retryAfter} seconds`)
  } else {
    throw err
  }
}

import os
import time

import requests

API = "https://api.isnap.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['ISNAP_API_KEY']}"}


def can_receive_imessage(handle):
    """Return True, False, or None when the answer is unknown."""
    # Every call counts against the lookup limits, repeats included: repeat at most 3 times.
    for _ in range(3):
        response = requests.post(
            f"{API}/v1/lookup",
            headers=HEADERS,
            json={"handle": handle, "from_line_id": "line_8Xk2mQ4vTn7Bw9Rz3Lc6Yp1Hd"},
            timeout=30,
        )
        if response.status_code == 429:
            error = response.json()["error"]
            raise SystemExit(f"{error['code']}: retry after {error['retry_after']} seconds")
        response.raise_for_status()
        result = response.json()["data"]
        if response.status_code == 200:
            return result["imessage"]
        time.sleep(result.get("retry_after") or 4)
    return None  # No definite answer after 3 calls: treat it as unknown.


print(can_receive_imessage("+14155550123"))