Archivos y lotes

Listar lotes de mensajes

Enumera los lotes de mensajes que creó su organización.

GET
/v1/messages/batches

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

  • limit es de 1 a 1000 y el valor predeterminado es 20.
  • Para paginar, pase after_id (lotes más antiguos) o before_id (lotes más recientes) con un ID de lote de la lista. No envíe ambos. TokenLab devuelve un 400 si el ID es desconocido o si se envía cualquier otro parámetro de consulta.
  • Los lotes eliminados no aparecen en la lista.
  • has_more es true cuando hay más lotes disponibles.

Ejemplo

Solicitud

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"

Ejemplo de respuesta

Respuesta

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
}

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

Rango1 <= value <= 1000
predeterminado20

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json

application/json