GET /api/v1/mail/jobs/{job_id}

Статус outbox-задачи.

Base URL: https://<host>/ (пример: http://localhost:5000). Соглашения, обзор Public API, Swagger UI.

Аутентификация: X-API-Key (mail:send)

Path params:

Param	Описание
`job_id`	ID задачи из `/send`

Response 200 — data (MailJobStatusResponseData):

Поле	Тип	Описание
`job_id`	string
`status`	string	pending / sent / failed / unknown
`attempts`	int	число попыток
`last_error`	string \	null	последняя ошибка
`sent_at`	string \	null	ISO timestamp

Errors: 404 not_found, 503 mail_unavailable

Заголовки запроса

Заголовок	Обяз.	Описание
`X-API-Key`	да	Ключ с scope mail:send

Пример успешного ответа

{
  "success": true,
  "data": {
    "job_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "sent",
    "attempts": 1,
    "last_error": null,
    "sent_at": "2026-09-18T12:00:00Z"
  }
}

Пример ошибки

{
  "success": false,
  "error": {
    "code": "not_found",
    "message": "Job not found"
  }
}

Пример curl

curl http://localhost:5000/api/v1/mail/jobs/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: YOUR_API_KEY"

См. также: POST /send.