Archivos y lotes
Listar lotes de mensajes
Enumera los lotes de mensajes que creó su organización.
Descripción general
Devuelve los lotes de mensajes que su organización creó a través de esta API, comenzando por los más recientes. La lista muestra el estado que TokenLab registró por última vez para cada lote. Para consultar un lote específico ahora, recupérelo.
Notas
limites de 1 a 1000 y el valor predeterminado es 20.- Para paginar, pase
after_id(lotes más antiguos) obefore_id(lotes más recientes) con un ID de lote de la lista. No envíe ambos. TokenLab devuelve un400si el ID es desconocido o si se envía cualquier otro parámetro de consulta. - Los lotes eliminados no aparecen en la lista.
has_moreestruecuando hay más lotes disponibles.
Solicitud
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"Respuesta
{
"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
}Campos importantes
dataarray
Lotes de mensajes, ordenados del más reciente al más antiguo.
first_idstring|null
ID del primer lote en
data.last_idstring|null
ID del último lote en
data.has_moreboolean
Hay más lotes disponibles cuando
has_more es true.Autorización
BearerAuth AuthorizationBearer <token>
Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de consulta
before_id?string
Devuelve lotes anteriores a este ID de lote. No se puede combinar con after_id.
after_id?string
Devuelve lotes posteriores a este ID de lote. No se puede combinar con before_id.
limit?integer
Número máximo de lotes a devolver
Rango
1 <= value <= 1000predeterminado
20Respuesta
application/json
application/json
application/json
application/json
application/json
application/json
application/json