Dateien & Batch-Jobs

Nachrichten-Batches auflisten

Listet die Nachrichten-Batches auf, die von Ihrer Organisation erstellt wurden.

GET
/v1/messages/batches

Überblick

Gibt die Nachrichten-Batches zurück, die Ihre Organisation über diese API erstellt hat, beginnend mit dem neuesten. Die Liste zeigt den Status an, den TokenLab zuletzt für jedes Batch aufgezeichnet hat. Um ein einzelnes Batch sofort zu überprüfen, rufen Sie es ab.

Hinweise

  • limit liegt zwischen 1 und 1000 und ist standardmäßig auf 20 gesetzt.
  • Um zu blättern, übergeben Sie after_id (ältere Batches) oder before_id (neuere Batches) mit einer Batch-ID aus der Liste. Senden Sie nicht beides gleichzeitig. TokenLab gibt bei einer unbekannten ID oder bei anderen Abfrageparametern den Status 400 zurück.
  • Gelöschte Batches werden nicht aufgelistet.
  • has_more ist true, wenn weitere Batches folgen.

Beispiel

Anfrage

cURL
curl -X GET "https://api.tokenlab.sh/v1/messages/batches?limit=20" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01"

Antwortbeispiel

Antwort

200 OK
{
  "data": [
    {
      "id": "msgbatch_01ABC123",
      "type": "message_batch",
      "processing_status": "ended",
      "request_counts": { "processing": 0, "succeeded": 2, "errored": 0, "canceled": 0, "expired": 0 },
      "ended_at": "2026-11-01T10:20:00Z",
      "created_at": "2026-11-01T10:00:00Z",
      "expires_at": "2026-11-02T10:00:00Z",
      "cancel_initiated_at": null,
      "archived_at": null,
      "results_url": "https://api.tokenlab.sh/v1/messages/batches/msgbatch_01ABC123/results"
    }
  ],
  "first_id": "msgbatch_01ABC123",
  "last_id": "msgbatch_01ABC123",
  "has_more": false
}

Wichtige Felder

dataarray
Nachrichten-Batches, beginnend mit dem neuesten.
first_idstring|null
ID des ersten Batches in data.
last_idstring|null
ID des letzten Batches in data.
has_moreboolean
Weitere Batches sind verfügbar, wenn has_more auf true gesetzt ist.

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Abfrageparameter

before_id?string

Gibt Batches vor dieser Batch-ID zurück. Kann nicht mit after_id kombiniert werden.

after_id?string

Gibt Batches nach dieser Batch-ID zurück. Kann nicht mit before_id kombiniert werden.

limit?integer

Maximale Anzahl der zurückzugebenden Batches

Bereich1 <= value <= 1000
Standard20

Antwort

application/json

application/json

application/json

application/json

application/json

application/json

application/json