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
Bearer

Jede 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), sms oder 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"
        }
    ]
}
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), wenn to keine 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 mit to_country.
  • caller_id: Pflichtfeld. Die Nummer, die der Angerufene sieht.
  • to_country: Optional. ISO-Land von to, z. B. GB.
  • caller_country: Optional. ISO-Land von caller_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 / 5xx

Jeder Fehler liefert den unten genannten HTTP-Status und einen JSON-Body mit einem stabilen error.code, auf den Sie verzweigen können.

  • invalid_request 400 — Der Body ist kein gültiges JSON oder ein Feld hat den falschen Typ.
  • unauthorized 401 — Der Authorization-Header fehlt, ist fehlerhaft oder Key/Secret ist falsch.
  • insufficient_balance 402 — Ihr Guthaben deckt die Kosten nicht. error.details enthält Kosten und Guthaben.
  • not_found 404 — Dieser Endpunkt existiert nicht. Prüfen Sie den Pfad und das Präfix /v1.
  • method_not_allowed 405 — Falsche HTTP-Methode; der Header Allow nennt die richtige.
  • validation_failed 422 — Ein Feld fehlt oder ist ungültig; error.message nennt das Feld.
  • internal_error 500 — Auf unserer Seite ist ein Fehler aufgetreten. Wiederholen Sie die Anfrage und kontaktieren Sie dann den Support.
  • provider_rejected 502 — Der Netzbetreiber hat die Nachricht oder den Anruf abgelehnt; es wurde nichts berechnet.
  • service_unavailable 503 — 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 tools

Der 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?
Melden Sie sich im Dashboard an und öffnen Sie Konto → API & Keys. Beim Neugenerieren entstehen ein neuer Key und ein neues Secret; das Secret wird nur einmal angezeigt und das alte Paar funktioniert sofort nicht mehr.
Wie authentifiziere ich mich?
Senden Sie bei jeder Anfrage 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?
Das Abrufen von Konto, Guthaben und Preisen ist kostenlos. POST /v1/sms und POST /v1/calls kosten dasselbe wie im Dashboard – siehe Abdeckung & Preise und GET /v1/prices.
Wie lang darf eine SMS sein?
Bis zu 160 Zeichen pro Anfrage. GSM-7-Text passt mit 160 Zeichen in ein Segment; Emojis oder nicht-lateinische Buchstaben schalten auf Unicode um, das 70 Zeichen pro Segment fasst. Jedes Segment wird berechnet.
Kann ein KI-Assistent die API nutzen?
Ja. Laden Sie den Spoofcallerid MCP-Server herunter, hinterlegen Sie Ihren Key, und Claude oder jeder andere MCP-Client kann Guthaben und Preise abrufen, SMS senden und Anrufe tätigen. Tools, die Guthaben verbrauchen, fragen vorher nach einer Bestätigung.