Une API REST puissante et simple
Intégrez, automatisez et livrez en toute confiance.
Envoyez des SMS, passez des appels spoofés, consultez votre solde et récupérez les tarifs en direct depuis votre propre code. Cinq endpoints, une clé, du JSON en entrée comme en sortie : les mêmes tarifs et le même solde que dans votre tableau de bord.
Bac à sable API
REQUÊTE
curl https://app.spoofcallerid.com/v1/me \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"curl https://app.spoofcallerid.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"curl https://app.spoofcallerid.com/v1/prices?type=all \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"curl -X POST https://app.spoofcallerid.com/v1/sms \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"text": "Your code is 4821",
"sender_id": "Spoof",
"country": "GB"
}'curl -X POST https://app.spoofcallerid.com/v1/calls \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"caller_id": "+18005550199",
"to_country": "GB",
"record": false
}'curl -X POST https://app.spoofcallerid.com/v1/sms \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"text": "Your code is 4821",
"sender_id": "Spoof",
"country": "GB"
}'RÉPONSE
{
"id": 1042,
"username": "you",
"email": "[email protected]",
"balance": 25.5,
"currency": "EUR",
"status": "active"
}{
"balance": 25.5,
"currency": "EUR"
}{
"success": true,
"type": "all",
"count": 200,
"cached_ttl": 3600,
"data": [
{
"country": "United Kingdom",
"iso": "GB",
"prefix": "44",
"call": 0.1,
"call_initblock": 1,
"call_billingblock": 1,
"call_tiers": [
{
"rate": 0.1,
"routes": 1
},
{
"rate": 0.4,
"routes": 1
},
{
"rate": 0.85,
"routes": 1
}
],
"sms": 0.0906,
"sms_routes": [
{
"name": "Route 1",
"rate": 0.0906
},
{
"name": "Route 2",
"rate": 0.0924
}
],
"hlr": null,
"currency": "EUR"
}
]
}{
"success": true,
"message": "SMS sent successfully.",
"data": {
"cost": 0.0906,
"newBalance": 25.4094,
"segments": 1,
"encoding": "gsm7",
"route": "",
"batchId": "7f3c2a91"
}
}{
"success": true,
"message": "Call placed successfully.",
"data": {
"id": 318,
"status": "dialing",
"cost": 0.5,
"newBalance": 25.0,
"currentBalance": 25.0,
"estimatedMinutes": 5,
"toNumber": "+447700900123",
"displayNumber": "+18005550199",
"ami_ref": "spoof_1042_1763190000"
}
}{
"error": {
"code": "insufficient_balance",
"message": "Insufficient balance.",
"details": {
"cost": 0.0906,
"balance": 0.02
}
}
}Avis de sécurité important
Gardez votre clé API et votre secret confidentiels. Utilisez-les uniquement depuis votre serveur, jamais dans du code côté client. En cas de fuite, régénérez-les dans Compte → API & clés : l'ancienne paire cesse immédiatement de fonctionner.
Authentification
BearerChaque requête transmet votre clé et votre secret dans un seul en-tête, séparés par deux-points. Les requêtes et les réponses sont au format JSON via HTTPS.
Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET
URL de base : https://app.spoofcallerid.com/v1
Obtenir le compte
GET /v1/me
Renvoie le compte propriétaire de la clé : id, nom d'utilisateur, e-mail, solde et statut.
curl https://app.spoofcallerid.com/v1/me \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"{
"id": 1042,
"username": "you",
"email": "[email protected]",
"balance": 25.5,
"currency": "EUR",
"status": "active"
}Obtenir le solde
GET /v1/balance
Votre solde actuel en euros. Appel peu coûteux : utilisez-le avant un envoi important.
curl https://app.spoofcallerid.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"{
"balance": 25.5,
"currency": "EUR"
}Obtenir les tarifs
GET /v1/prices
Tarifs d'appel et de SMS en direct pour chaque destination, la même liste que Couverture & tarifs. Mis en cache pendant une heure.
Paramètres :
type: facultatif.all(par défaut),smsouvoice.
curl https://app.spoofcallerid.com/v1/prices?type=all \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"{
"success": true,
"type": "all",
"count": 200,
"cached_ttl": 3600,
"data": [
{
"country": "United Kingdom",
"iso": "GB",
"prefix": "44",
"call": 0.1,
"call_initblock": 1,
"call_billingblock": 1,
"call_tiers": [
{
"rate": 0.1,
"routes": 1
},
{
"rate": 0.4,
"routes": 1
},
{
"rate": 0.85,
"routes": 1
}
],
"sms": 0.0906,
"sms_routes": [
{
"name": "Route 1",
"rate": 0.0906
},
{
"name": "Route 2",
"rate": 0.0924
}
],
"hlr": null,
"currency": "EUR"
}
]
}Envoyer un SMS
POST /v1/sms
Envoie un SMS avec le sender ID de votre choix et débite votre solde par segment de message.
Paramètres :
to: obligatoire. Numéro du destinataire avec l'indicatif pays, par ex.+447700900123.text: obligatoire. Texte du message, jusqu'à 160 caractères.sender_id: obligatoire. Nom ou numéro affiché comme expéditeur, 1 à 20 lettres ou chiffres.country: facultatif. Code pays ISO (par ex.GB) lorsqueton'a pas d'indicatif pays.route: facultatif. Une route spécifique pour la destination ; la moins chère est utilisée par défaut.
curl -X POST https://app.spoofcallerid.com/v1/sms \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"text": "Your code is 4821",
"sender_id": "Spoof",
"country": "GB"
}'{
"success": true,
"message": "SMS sent successfully.",
"data": {
"cost": 0.0906,
"newBalance": 25.4094,
"segments": 1,
"encoding": "gsm7",
"route": "",
"batchId": "7f3c2a91"
}
}Passer un appel spoofé
POST /v1/calls
Passe un appel affichant le caller ID de votre choix. Le coût estimé est réservé sur votre solde au début de l'appel.
Paramètres :
to: obligatoire. Numéro à appeler, au format international ou local avecto_country.caller_id: obligatoire. Le numéro que verra votre correspondant.to_country: facultatif. Pays ISO deto, par ex.GB.caller_country: facultatif. Pays ISO decaller_id.record: facultatif.truepour enregistrer l'appel. Par défautfalse.plan: facultatif. Identifiant du forfait d’appel. Chaque forfait facture selon son tarif et son palier ; par défaut Worldwide.
curl -X POST https://app.spoofcallerid.com/v1/calls \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
-H "Content-Type: application/json" \
-d '{
"to": "+447700900123",
"caller_id": "+18005550199",
"to_country": "GB",
"record": false
}'{
"success": true,
"message": "Call placed successfully.",
"data": {
"id": 318,
"status": "dialing",
"cost": 0.5,
"newBalance": 25.0,
"currentBalance": 25.0,
"estimatedMinutes": 5,
"toNumber": "+447700900123",
"displayNumber": "+18005550199",
"ami_ref": "spoof_1042_1763190000"
}
}Erreurs
4xx / 5xxChaque échec renvoie le statut HTTP ci-dessous et un corps JSON avec un error.code stable sur lequel vous pouvez vous appuyer.
invalid_request400 — Le corps n'est pas un JSON valide ou un champ a un type incorrect.unauthorized401 — L'en-tête Authorization est absent ou mal formé, ou la clé/le secret est incorrect.insufficient_balance402 — Votre solde ne couvre pas le coût.error.detailsindique le coût et le solde.not_found404 — Endpoint inexistant. Vérifiez le chemin et le préfixe/v1.method_not_allowed405 — Méthode HTTP incorrecte ; l'en-têteAllowindique la bonne.validation_failed422 — Un champ est manquant ou invalide ;error.messageindique lequel.internal_error500 — Une erreur s'est produite de notre côté. Réessayez, puis contactez le support.provider_rejected502 — L'opérateur a refusé le message ou l'appel ; rien n'a été facturé.service_unavailable503 — Une dépendance est temporairement indisponible. Réessayez avec un délai croissant.
{
"error": {
"code": "insufficient_balance",
"message": "Insufficient balance.",
"details": {
"cost": 0.0906,
"balance": 0.02
}
}
}
Connectez votre assistant IA (MCP)
5 toolsLe serveur MCP Spoofcallerid transforme chaque endpoint en outil pour Claude ou tout client MCP : get_account, get_balance, get_prices, send_sms et make_spoof_call. Un seul fichier, aucune dépendance, Node.js 18+. Les deux outils qui consomment du solde demandent d'abord une confirmation.
Télécharger le serveur MCP · Manifeste JSON
{
"mcpServers": {
"spoofcallerid": {
"command": "node",
"args": [
"/path/to/spoofcallerid-mcp.mjs"
],
"env": {
"SPOOFCALLERID_API_KEY": "YOUR_API_KEY:YOUR_API_SECRET"
}
}
}
}
Questions fréquentes
Où obtenir ma clé API ?
Comment m'authentifier ?
Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET avec chaque requête. Gardez le secret sur votre serveur, jamais dans un navigateur ni dans une application mobile.Combien coûte une requête ?
POST /v1/sms et POST /v1/calls sont facturés aux mêmes tarifs que le tableau de bord, affichés dans Couverture & tarifs et dans GET /v1/prices.