---
title: "Fetch scheduled emails by batchId"
method: GET
path: "/smtp/emailStatus/{batchId}"
tags: ["Transactional emails"]
---

# Fetch scheduled emails by batchId

`GET /smtp/emailStatus/{batchId}`

Fetch scheduled batch of emails by batchId (Can retrieve data upto 30 days old)

## Path parameters

- `batchId` string, required

## Query parameters

- `startDate` string, date
- `endDate` string, date
- `sort` 'asc' | 'desc'
- `status` 'processed' | 'inProgress' | 'queued'
- `limit` integer
- `offset` integer

## Response `200`

Scheduled email batches

- GetScheduledEmailByBatchId
  - `count` integer — Total number of batches
  - `batches` GetScheduledEmailByBatchIdBatches[]
    - `scheduledAt` string, date-time, required — Datetime for which the batch was scheduled
    - `createdAt` string, date-time, required — Datetime on which the batch was scheduled
    - `status` 'inProgress' | 'queued' | 'processed' | 'error', required — Current status of the scheduled batch

## Other responses

- `400` — Invalid parameters passed
- `404` — Records for batchId not found

---

[API](https://skmtc.net/getbrevo/apis/brevo-api.md) · [All operations](https://skmtc.net/getbrevo/apis/brevo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbrevo/brevo-api/versions/2aec3cf66501/schema)