---
title: "Get recent reminder send outcomes"
method: GET
path: "/api/v1/send-log"
tags: ["Reminders"]
---

# Get recent reminder send outcomes

`GET /api/v1/send-log`

## Request

- Base URL: `https://volunteerreminder.com`
- URL: `https://volunteerreminder.com/api/v1/send-log`
- Auth: HTTP bearer

Recent reminder outcomes merged from the sent log and the dead-letter failure log, newest first. Requires the `read` scope.

## Query parameters

- `page` integer: 1-indexed page number. Default 1.
- `per_page` integer: Rows per page (max 100). Default 20.

## Response `200`

A page of send-outcome entries.

- SendLogResponse
  - `page` integer, required
  - `per_page` integer, required
  - `total` integer, required: Total matching rows across both sources.
  - `has_more` boolean, required
  - `entries` SendLogEntry[], required
    - `type` 'sent' | 'failed', required: 'sent' = a reminder was recorded as sent; 'failed' = a send definitively failed.
    - `occurred_at` number, required: Epoch milliseconds (UTC).
    - `channels` string[], required: Channels involved. A 'sent' row may have both; a 'failed' row has at most one (empty when the failed channel could not be determined).
    - `contact_id` number, nullable, required: The volunteer this outcome is about. Null for 'failed' (not attributable).
    - `contact_name` string, nullable, required: The volunteer's name. Null for 'failed'.
    - `schedule_occurrence_id` number, nullable, required: The shift instance. Only present for 'sent'.
    - `result` string, nullable, required: Free-text send result, when recorded. Only present for 'sent'.
    - `detail` string, nullable, required: Short failure reason (IDs only, no message content). Only present for 'failed'.

## Other responses

- `400`: The request failed schema validation (`validation_error`). On the import endpoints, also when the text is UTF-16 (Excel "Unicode Text"; `unsupported_encoding`): resend it as CSV UTF-8.
- `401`: Missing or invalid API key.
- `403`: The API key lacks a scope required by this endpoint.

---

[API](https://skmtc.dev/volunteerreminder/apis/volunteerreminder-api.md) · [All operations](https://skmtc.dev/volunteerreminder/apis/volunteerreminder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volunteerreminder/apis/volunteerreminder-api/revisions/f8e7e26ba96f?raw)