---
title: "Use this API to search"
method: GET
path: "/v2.1/sign/request/list"
tags: ["Document Execution Platform"]
---

# Use this API to search

`GET /v2.1/sign/request/list`

You need to call this API with a custom Search Query to search your existing documents.

**Important:** Fair use limits may apply to GET APIs to ensure system stability.

## Query parameters

- `q` string
- `status` string
- `max` integer
- `offset` integer

## Response `200`

Response Data

- ListApiResponse
  - `status` integer — if success then 1, else 0.
  - `messages` Message[]
    - `code` string — Message Code.
    - `message` string — Success/Error Message.
  - `data` ListApiResponseData
    - `count` integer — Count of total number of available documents.
    - `documents` ListData[]
      - `name` string — Name of the document.
      - `documentId` string — Document ID.
      - `irn` string — Internal Reference Number.
      - `folderId` string — Folder ID.
      - `folderName` string — Folder Name.
      - `status` string — Document Status. Possible values- DRAFT, SENT, RECEIVED, SIGNED, COMPLETED, EXPIRED.

---

[API](https://skmtc.dev/leegality/apis/leegality-documentation-gateway.md) · [All operations](https://skmtc.dev/leegality/apis/leegality-documentation-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leegality/leegality-documentation-gateway/revisions/0290f3a2dc73/schema)