Dateien & Batch-Jobs
Nachrichten-Batches auflisten
Listet die Nachrichten-Batches auf, die von Ihrer Organisation erstellt wurden.
Ü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
limitliegt zwischen 1 und 1000 und ist standardmäßig auf 20 gesetzt.- Um zu blättern, übergeben Sie
after_id(ältere Batches) oderbefore_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 Status400zurück. - Gelöschte Batches werden nicht aufgelistet.
has_moreisttrue, wenn weitere Batches folgen.
Anfrage
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"Antwort
{
"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
data.data.has_more auf true gesetzt ist.Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Abfrageparameter
Gibt Batches vor dieser Batch-ID zurück. Kann nicht mit after_id kombiniert werden.
Gibt Batches nach dieser Batch-ID zurück. Kann nicht mit before_id kombiniert werden.
Maximale Anzahl der zurückzugebenden Batches
1 <= value <= 100020Antwort
application/json
application/json
application/json
application/json
application/json
application/json
application/json