Leistungsstarke & einfache REST API
Integrieren, automatisieren und zuverlässig zustellen.
Senden Sie SMS, tätigen Sie Spoof-Anrufe, prüfen Sie Ihr Guthaben und rufen Sie Live-Preise direkt aus Ihrem Code ab. Fünf Endpunkte, ein Key, JSON rein und raus – mit denselben Preisen und demselben Guthaben wie in Ihrem Dashboard.
API-Playground
ANFRAGE
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"
}'ANTWORT
{
"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
}
}
}Wichtiger Sicherheitshinweis
Halten Sie Ihren API-Key und Ihr Secret vertraulich. Verwenden Sie sie nur auf Ihrem Server, niemals in clientseitigem Code. Falls sie in falsche Hände geraten, erzeugen Sie unter Konto → API & Keys neue – das alte Paar funktioniert dann sofort nicht mehr.
Authentifizierung
BearerJede Anfrage enthält Ihren Key und Ihr Secret in einem Header, getrennt durch einen Doppelpunkt. Anfragen und Antworten sind JSON über HTTPS.
Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET
Basis-URL: https://app.spoofcallerid.com/v1
Konto abrufen
GET /v1/me
Gibt das Konto zurück, dem der Key gehört: ID, Benutzername, E-Mail, Guthaben und Status.
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"
}Guthaben abrufen
GET /v1/balance
Ihr aktuelles Guthaben in Euro. Kostengünstige Abfrage – nutzen Sie sie vor einem großen Versand.
curl https://app.spoofcallerid.com/v1/balance \
-H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"{
"balance": 25.5,
"currency": "EUR"
}Preise abrufen
GET /v1/prices
Aktuelle Anruf- und SMS-Preise für jedes Ziel, dieselbe Liste wie unter Abdeckung & Preise. Eine Stunde lang zwischengespeichert.
Parameter:
type: Optional.all(Standard),smsodervoice.
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"
}
]
}SMS senden
POST /v1/sms
Sendet eine SMS mit der von Ihnen gewählten Absender-ID und belastet Ihr Guthaben pro Nachrichtensegment.
Parameter:
to: Pflichtfeld. Empfängernummer mit Landesvorwahl, z. B.+447700900123.text: Pflichtfeld. Nachrichtentext, bis zu 160 Zeichen.sender_id: Pflichtfeld. Als Absender angezeigter Name oder Nummer, 1–20 Buchstaben oder Ziffern.country: Optional. ISO-Ländercode (z. B.GB), wenntokeine Landesvorwahl enthält.route: Optional. Eine bestimmte Route für das Ziel; standardmäßig wird die günstigste verwendet.
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"
}
}Spoof-Anruf tätigen
POST /v1/calls
Tätigt einen Anruf mit der von Ihnen gewählten Anrufer-ID. Die geschätzten Kosten werden bei Anrufbeginn von Ihrem Guthaben reserviert.
Parameter:
to: Pflichtfeld. Anzurufende Nummer im internationalen Format oder lokal mitto_country.caller_id: Pflichtfeld. Die Nummer, die der Angerufene sieht.to_country: Optional. ISO-Land vonto, z. B.GB.caller_country: Optional. ISO-Land voncaller_id.record: Optional.true, um den Anruf aufzuzeichnen. Standard:false.plan: Optional. ID des Anruftarifs. Jeder Tarif rechnet mit eigenem Preis und Takt ab; Standard ist 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"
}
}Fehler
4xx / 5xxJeder Fehler liefert den unten genannten HTTP-Status und einen JSON-Body mit einem stabilen error.code, auf den Sie verzweigen können.
invalid_request400 — Der Body ist kein gültiges JSON oder ein Feld hat den falschen Typ.unauthorized401 — Der Authorization-Header fehlt, ist fehlerhaft oder Key/Secret ist falsch.insufficient_balance402 — Ihr Guthaben deckt die Kosten nicht.error.detailsenthält Kosten und Guthaben.not_found404 — Dieser Endpunkt existiert nicht. Prüfen Sie den Pfad und das Präfix/v1.method_not_allowed405 — Falsche HTTP-Methode; der HeaderAllownennt die richtige.validation_failed422 — Ein Feld fehlt oder ist ungültig;error.messagenennt das Feld.internal_error500 — Auf unserer Seite ist ein Fehler aufgetreten. Wiederholen Sie die Anfrage und kontaktieren Sie dann den Support.provider_rejected502 — Der Netzbetreiber hat die Nachricht oder den Anruf abgelehnt; es wurde nichts berechnet.service_unavailable503 — Ein abhängiger Dienst ist vorübergehend nicht erreichbar. Mit Backoff erneut versuchen.
{
"error": {
"code": "insufficient_balance",
"message": "Insufficient balance.",
"details": {
"cost": 0.0906,
"balance": 0.02
}
}
}
KI-Assistenten verbinden (MCP)
5 toolsDer Spoofcallerid MCP-Server macht jeden Endpunkt zu einem Tool für Claude oder jeden anderen MCP-Client: get_account, get_balance, get_prices, send_sms und make_spoof_call. Eine Datei, keine Abhängigkeiten, Node.js 18+. Die beiden Tools, die Guthaben verbrauchen, fragen vorher nach einer Bestätigung.
MCP-Server herunterladen · JSON-Manifest
{
"mcpServers": {
"spoofcallerid": {
"command": "node",
"args": [
"/path/to/spoofcallerid-mcp.mjs"
],
"env": {
"SPOOFCALLERID_API_KEY": "YOUR_API_KEY:YOUR_API_SECRET"
}
}
}
}
Häufig gestellte Fragen
Wo erhalte ich meinen API-Key?
Wie authentifiziere ich mich?
Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET mit. Bewahren Sie das Secret auf Ihrem Server auf – niemals im Browser oder in einer mobilen App.Was kostet eine Anfrage?
POST /v1/sms und POST /v1/calls kosten dasselbe wie im Dashboard – siehe Abdeckung & Preise und GET /v1/prices.