Bestellstatus abrufen

Rufe den aktuellen Status und die Details einer Bestellung anhand ihrer ID oder ihres Tokens ab. Verwende diesen Endpunkt, um den Bereitstellungsfortschritt nach einer Bestellung ueber die API oder MCP abzufragen.

Anfrage

GET /api/v1/orders/:id

Der :id-Parameter akzeptiert entweder die Bestell-ID (MongoDB ObjectId) oder das Bestell-Token (UUID).

Header

Header	Erforderlich	Wert
`Authorization`	Ja	`Bearer DEIN_API_SCHLÜSSEL`

Erforderlicher Scope

vps:provision für VPS-Bestellungen
domains:provision für Domain-Bestellungen

Antwort

{
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "COMPLETED",
    "type": "DOMAIN",
    "channel": "api",
    "totalNet": 0.00,
    "totalGross": 0.00,
    "currency": "EUR",
    "interval": "12 months",
    "provisionedResourceId": "507f1f77bcf86cd799439022",
    "provisionedAt": "2026-03-29T12:00:00.000Z",
    "createdAt": "2026-03-29T11:59:00.000Z",
    "updatedAt": "2026-03-29T12:00:00.000Z"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`id`	string	Bestell-ID
`token`	string	Bestell-Token (UUID)
`status`	string	Aktueller Status (siehe unten)
`type`	string	Bestelltyp: `VM` oder `DOMAIN`
`channel`	string	Herkunftskanal: `shop`, `api` oder `mcp`
`totalNet`	number	Nettopreis (ohne MwSt.)
`totalGross`	number	Bruttopreis (inkl. MwSt.)
`currency`	string	Währungscode (`EUR`)
`interval`	string	Abrechnungsintervall (z.B. `1 month`, `12 months`)
`provisionedResourceId`	string\|null	ID der bereitgestellten VPS oder Domain (nach Bereitstellung gesetzt)
`provisionedAt`	string\|null	ISO 8601 Zeitstempel der abgeschlossenen Bereitstellung
`createdAt`	string	ISO 8601 Zeitstempel der Bestellerstellung
`updatedAt`	string	ISO 8601 Zeitstempel der letzten Aktualisierung

Bestellstatus

Status	Beschreibung
`PENDING`	Zahlung eingeleitet, warte auf Bestätigung
`PROCESSING`	Zahlung bestätigt, Bereitstellung läuft
`COMPLETED`	Vollständig bereitgestellt und aktiv
`FAILED`	Zahlung fehlgeschlagen
`CANCELED`	Bestellung wurde storniert
`PROVISION_FAILED`	Zahlung erfolgreich, aber Bereitstellung fehlgeschlagen (Erstattung ausgestellt)
`EXPIRED`	Bestellung vor Zahlung abgelaufen

Fehlerantworten

Status	Code	Beschreibung
404	`NOT_FOUND`	Bestellung nicht gefunden oder gehört nicht zum authentifizierten Benutzer
403	`INSUFFICIENT_SCOPE`	API-Schlüssel hat nicht den erforderlichen `vps:provision`- oder `domains:provision`-Scope

Beispiel

# Bestellung nach ID abrufen
curl https://hosting.site.quest/api/v1/orders/507f1f77bcf86cd799439011 \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

# Bestellung nach Token abrufen
curl https://hosting.site.quest/api/v1/orders/a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

Diese Daten sind auch über das MCP-Tool get_order_status verfügbar.