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
Bearer

Chaque 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), sms ou voice.
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) lorsque to n'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 avec to_country.
  • caller_id : obligatoire. Le numéro que verra votre correspondant.
  • to_country : facultatif. Pays ISO de to, par ex. GB.
  • caller_country : facultatif. Pays ISO de caller_id.
  • record : facultatif. true pour enregistrer l'appel. Par défaut false.
  • 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 / 5xx

Chaque échec renvoie le statut HTTP ci-dessous et un corps JSON avec un error.code stable sur lequel vous pouvez vous appuyer.

  • invalid_request 400 — Le corps n'est pas un JSON valide ou un champ a un type incorrect.
  • unauthorized 401 — L'en-tête Authorization est absent ou mal formé, ou la clé/le secret est incorrect.
  • insufficient_balance 402 — Votre solde ne couvre pas le coût. error.details indique le coût et le solde.
  • not_found 404 — Endpoint inexistant. Vérifiez le chemin et le préfixe /v1.
  • method_not_allowed 405 — Méthode HTTP incorrecte ; l'en-tête Allow indique la bonne.
  • validation_failed 422 — Un champ est manquant ou invalide ; error.message indique lequel.
  • internal_error 500 — Une erreur s'est produite de notre côté. Réessayez, puis contactez le support.
  • provider_rejected 502 — L'opérateur a refusé le message ou l'appel ; rien n'a été facturé.
  • service_unavailable 503 — 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 tools

Le 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 ?
Connectez-vous au tableau de bord et ouvrez Compte → API & clés. La régénération crée une nouvelle clé et un nouveau secret ; le secret n'est affiché qu'une fois et l'ancienne paire cesse immédiatement de fonctionner.
Comment m'authentifier ?
Envoyez 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 ?
La consultation de votre compte, de votre solde et des tarifs est gratuite. 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.
Quelle longueur peut avoir un SMS ?
Jusqu'à 160 caractères par requête. Un texte GSM-7 tient en 160 caractères dans un seul segment ; les emojis ou les caractères non latins passent en Unicode, qui contient 70 caractères par segment, et chaque segment est facturé.
Un assistant IA peut-il utiliser l'API ?
Oui. Téléchargez le serveur MCP Spoofcallerid, donnez-lui votre clé, et Claude ou tout client MCP pourra consulter votre solde et les tarifs, envoyer des SMS et passer des appels. Les outils qui consomment du solde demandent d'abord une confirmation.