Consultar el estado de procesamiento de solicitudes

Utiliza este endpoint para comprobar si Braze ha terminado de procesar un grupo de solicitudes asíncronas del endpoint /users/track.

Importante

Este endpoint está en fase beta. Si te interesa participar en la beta, ponte en contacto con tu director de cuentas de Braze.

Una respuesta satisfactoria de /users/track significa que Braze recibió tu solicitud y la puso en cola para su procesamiento. Para confirmar que el procesamiento ha finalizado, incluye el mismo group_id en cada solicitud relacionada de /users/track y, a continuación, llama a este endpoint con ese group_id. Cuando el status del grupo sea completed, puedes realizar de forma segura las acciones que dependen de esos datos, como desencadenar un Canvas o lanzar una campaña.

Para el flujo de trabajo completo, los requisitos de ID de grupo, los límites y la retención, consulta Seguimiento del estado de procesamiento de solicitudes.

Requisitos previos

Para utilizar este endpoint, necesitarás una clave de API con el permiso users.track.status. El permiso users.track no incluye acceso a este endpoint.

Cualquier clave de API en el espacio de trabajo con el permiso users.track.status puede consultar cualquier grupo en ese espacio de trabajo, independientemente de qué clave de API envió las solicitudes /users/track.

Límite de velocidad

Braze aplica un límite de velocidad de 1500 solicitudes por minuto por espacio de trabajo a este endpoint, como se documenta en Límites de velocidad de la API. Este límite es independiente del límite de velocidad de /users/track.

Las respuestas correctas incluyen los encabezados X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset para que puedas hacer seguimiento de cuánto queda de tu ventana actual.

Parámetros de consulta

Ejemplo de solicitud

1
2

curl --location --request GET 'https://rest.iad-01.braze.com/users/track/status?group_id=loyalty_backfill_2026-09-23' \
--header 'Authorization: Bearer YOUR_REST_API_KEY'

Respuesta

1
2
3
4
5
6
7
8
9
10
11
12

{
  "results": [
    {
      "group_id": (string) the group ID from your request,
      "status": (string) the processing status of the group, either "processing" or "completed",
      "received": (integer) the number of /users/track requests Braze accepted for this group,
      "done": (integer) the number of accepted requests Braze has finished processing,
      "processing": (integer) the number of accepted requests Braze is still processing,
      "final_completion_time": (string or null) when the last request in the group finished processing, in ISO 8601 format (UTC). This is null until the status is "completed".
    }
  ]
}

El array results contiene un objeto cuando Braze encuentra el grupo. Está vacío cuando el grupo no existe en el espacio de trabajo o cuando su periodo de retención de 24 horas ha finalizado. Braze devuelve un array results vacío en ambos casos, por lo que un array vacío no indica si un grupo existió alguna vez.

Parámetros de respuesta

Un estado completed significa que Braze terminó de procesar cada solicitud del grupo, incluidas las solicitudes en las que Braze rechazó algunos objetos. Este endpoint solo informa sobre el recuento de solicitudes y no informa resultados de atributos, eventos o compras individuales. Para encontrar objetos rechazados, comprueba el array errors en cada respuesta de /users/track.

Ejemplos de respuesta

Grupo aún en procesamiento

1
2
3
4
5
6
7
8
9
10
11
12

{
  "results": [
    {
      "group_id": "loyalty_backfill_2026-09-23",
      "status": "processing",
      "received": 4,
      "done": 3,
      "processing": 1,
      "final_completion_time": null
    }
  ]
}

Grupo completado

1
2
3
4
5
6
7
8
9
10
11
12

{
  "results": [
    {
      "group_id": "loyalty_backfill_2026-09-23",
      "status": "completed",
      "received": 4,
      "done": 4,
      "processing": 0,
      "final_completion_time": "2026-09-23T18:58:57.123Z"
    }
  ]
}

Grupo no encontrado o expirado

1
2
3

{
  "results": []
}

Solución de problemas

La siguiente tabla enumera los errores que puede devolver este endpoint y cómo resolverlos.

Para otros códigos de estado y mensajes de error, consulta Errores fatales y respuestas.