---
title: "List signature requests (signing link / batch)"
method: POST
path: "/signature_link/get_batch_status"
tags: ["Document AI — E-Signatures"]
---

# List signature requests (signing link / batch)

`POST /signature_link/get_batch_status`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/signature_link/get_batch_status`
- Auth: HTTP bearer

WHEN TO USE: signature status for specific documents (batch lookup by documents_id/pofid) or the detail of a single request. For a plain status-filtered list of all signature requests use po_esignatures_list_signature_requests instead.

## Request body

- object
  - `request_id` number: Specific request ID for detail view
  - `request_uuid` string: UUID of a request (Alternative to request_id)
  - `document_pofid` string: POFID to view all signatures of a document
  - `document_pofids` string[]: Deprecated alias for pofids.
  - `status` 'draft' | 'pending' | 'completed' | 'cancelled' | 'expired': Filter by status
  - `page` number: Page (default: 1)
  - `limit` number: Results per page (default: 20)
  - `pofids` string[]: POFID list for batch status (canonical). Alias: document_pofids.

## Response `200`

Success

- object
  - `success` boolean
  - `error` string

## Other responses

- `4XX`: Error
- `5XX`: Error

---

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