> ## Documentation Index
> Fetch the complete documentation index at: https://developers.luminpdf.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Send Reminder Emails
> Send reminder emails to selected signers whose status is NEED_TO_SIGN.
This endpoint requires the following scope:
`sign:requests`
## OpenAPI
````yaml POST /signature_request/remind/{signature_request_id}
openapi: 3.1.0
info:
version: 1.0.0
title: Lumin API Reference
description: >
The Lumin API Reference provides a comprehensive set of tools to integrate
document workflows — including editing, eSignatures, and automation — into
your applications.
Useful links:
- [Document Repository](https://github.com/luminpdf/luminsign-docs)
- [API
Definition](https://github.com/luminpdf/luminsign-docs/blob/main/openapi.yaml)
- [Authentication Guide](/tabs/guides/authentication/overview)
termsOfService: https://www.luminpdf.com/terms-of-use/
contact:
name: API Support
email: integration@luminpdf.com
url: https://help.luminpdf.com
servers:
- url: https://api.luminpdf.com/v1
description: Production server
security: []
tags:
- name: Signature Requests
description: Everything about Signature Requests
- name: Users
description: Everything about Users
- name: Templates
description: Everything about Templates
- name: Documents
description: Everything about Documents
- name: Workspaces
description: Everything about Workspaces
- name: Agreements
description: Everything about Agreements
paths:
/signature_request/remind/{signature_request_id}:
post:
tags:
- Signature Requests
summary: Send Reminder Emails
description: >
Send reminder emails to selected signers under a signature request whose
signer status is `NEED_TO_SIGN`.
**Notes:**
- Reminders sent to signers who already signed will be ignored (no email
sent).
- You can send reminders to up to 10 reminders per signer per day.
operationId: send-reminder-emails
parameters:
- in: path
name: signature_request_id
schema:
type: string
required: true
description: ID of the signature request
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SignatureRequestRemindRequest'
example:
emails:
- john@example.com
- jane@example.com
responses:
'200':
description: Returns signature request details and per-email reminder results.
content:
application/json:
schema:
type: object
required:
- signature_request
- reminders
properties:
signature_request:
$ref: '#/components/schemas/SignatureRequest'
description: Contains information about a signature request.
reminders:
type: array
description: >-
List of reminder email results for requested signer
emails.
items:
$ref: '#/components/schemas/ReminderResult'
example:
signature_request:
signature_request_id: 696d007913f3b8...
title: Signature request
created_at: 1768751225657
expires_at: 1927510980694
status: WAITING_FOR_OTHERS
signers:
- name: John Doe
email_address: john@example.com
status: WAITING_FOR_OTHERS
is_approved: true
group: 1
- name: Jane Doe
email_address: jane@example.com
status: NEED_TO_SIGN
is_approved: false
group: 2
updated_at: 1768751357064
details_url: >-
https://sign.luminpdf.com/auth?mode=view-contract&token=8647b08b...
signing_type: ORDER
reminders:
- email: john@example.com
signer_status: WAITING_FOR_OTHERS
email_status: BOUNCE
- email: jane@example.com
signer_status: NEED_TO_SIGN
email_status: SENT
4XX:
description: Unexpected error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
security:
- ApiKey: []
- BearerAuth:
- sign:requests
components:
schemas:
SignatureRequestRemindRequest:
type: object
required:
- emails
properties:
emails:
type: array
description: List of emails to send reminder.
items:
type: string
format: email
SignatureRequest:
type: object
required:
- signature_request_id
- title
- created_at
- expires_at
- details_url
- status
- signers
- signing_type
properties:
signature_request_id:
type: string
description: The unique identifier for the signature request.
title:
type: string
description: The title of the signature request.
created_at:
type: string
description: The time the signature request was created.
updated_at:
type: string
description: The time the signature request was last updated.
expires_at:
type: string
description: The time the signature request will expire.
details_url:
type: string
description: The url to view the signature request in the browser.
status:
type: string
description: The status of the signature request.
enum:
- NEED_TO_SIGN
- WAITING_FOR_OTHERS
- APPROVED
- REJECTED
- WAITING_FOR_PROCESSING
- FAILED
- CANCELLED
reason:
type: string
description: >-
The reason for the status FAILED or REJECTED of the signature
request.
signing_type:
type: string
description: Recipient signing flow.
enum:
- SAME_TIME
- ORDER
signers:
type: array
items:
properties:
email_address:
type: string
description: Email address of the signer.
name:
type: string
description: Name of the signer.
group:
type: number
description: >
The signing order of signer for the signature request with
`signing_type` is `ORDER`. Required if `signing_type` is
`ORDER`.
Only signers in `1st Signers` group will receive
email/notification, signers in subsequent groups will receive
email/notification when all signers in previous group has
signed.
Group starts incrementing at 1.
The default value for group always is 1 if `signing_type` is
`SAME_TIME.`
is_approved:
type: boolean
description: Whether the signer has approved the signature request.
status:
type: string
description: The status of the Signer.
enum:
- NEED_TO_SIGN
- APPROVED
- WAITING_FOR_OTHERS
- REJECTED
- FAILED
- WAITING_FOR_PROCESSING
description: The signers of the signature request.
ReminderResult:
type: object
required:
- email
- signer_status
- email_status
properties:
email:
type: string
format: email
description: The signer email that the reminder request targets.
signer_status:
type: string
description: >-
The signer status at the time of sending the reminder. One of:
NEED_TO_SIGN, APPROVED, REJECTED, WAITING_FOR_OTHERS
enum:
- NEED_TO_SIGN
- APPROVED
- REJECTED
- WAITING_FOR_OTHERS
email_status:
type: string
description: >
Result of reminder email delivery attempt.
- `SENT` – Sent an email successfully
- `EXCEED_DAILY_LIMIT` – Email not sent due to daily limit (**10
emails/signer/day**)
- `BOUNCE` – Email not sent because the signer already signed or is
not in turn to sign
enum:
- SENT
- EXCEED_DAILY_LIMIT
- BOUNCE
Error:
type: object
required:
- error_code
- error_message
properties:
error_code:
type: string
description: The system error code.
error_message:
type: string
description: The human-readable error message.
securitySchemes:
ApiKey:
type: apiKey
in: header
name: X-API-Key
description: >
Provide your API key in the `X-API-Key` header, e.g., `X-API-Key:
YOUR_API_KEY`.
BearerAuth:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://auth.luminpdf.com/oauth2/auth
tokenUrl: https://auth.luminpdf.com/oauth2/token
scopes:
openid: >-
Retrieve basic identity details (username, email, profile
picture).
offline_access: Request a refresh token for long-lived access. Private apps only.
profile.read: View basic user profile information.
workspaces: View and manage Workspaces and Spaces.
workspaces.read: View information about the authenticated user's Workspace.
templates: View and manage templates in a Workspace.
pdf:files: Create, edit, and delete PDF files in a Workspace.
pdf:files.read: Retrieve PDF documents stored in a Workspace.
sign:requests: Create, update, or view signature requests.
sign:requests.read: Retrieve signature requests.
agreements: Create, update, or delete AgreementGen documents.
description: >
OAuth 2.0 authorization code flow. Provide your access token in the
`Authorization` header, e.g., `Authorization: Bearer `. See the
[OAuth 2.0 guide](/tabs/guides/authentication/oauth2) for details.
````