---
title: "Return the rollup status for a magic-link batch (internal)."
method: GET
path: "/scoped-magic-link/batch/{batch}"
tags: ["MagicLink"]
---

# Return the rollup status for a magic-link batch (internal).

`GET /scoped-magic-link/batch/{batch}`

Return the rollup status for a batch.

Unscoped findOrFail is intentional: privateEndpoint + app-token-only gate
the route and the id is the batch's own surrogate key (not a tenant
resource), so there is no cross-org IDOR surface.

## Path parameters

- `batch` integer, required

## Response `200`

Batch status rollup.

- object
  - `id` integer
  - `organization_id` string
  - `action_scope` string
  - `status` string
  - `total_count` integer
  - `completed_count` integer
  - `failed_count` integer
  - `progress_percentage` integer
  - `is_complete` boolean
  - `is_processing` boolean
  - `started_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `error_message` string, nullable

## Other responses

- `403` — Caller is an external app, or an internal app carrying member context (application tokens only).
- `404` — No batch exists with this id.

---

[API](https://skmtc.net/gofundme/apis/gofundme-pro-api.md) · [All operations](https://skmtc.net/gofundme/apis/gofundme-pro-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gofundme/gofundme-pro-api/revisions/d22bb925eeed/schema)