---
name: "esign_get"
area: "esign"
title: "Get a signature request"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/esign_get"
mcp_server: "https://api.conecto.chat/mcp/esign"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/esign/esign_get"
---

# Get a signature request (`esign_get`)

Where a signature request stands: each signer's status, and the signed PDF once everyone signed.

Where a signature request stands: each signer's status (waiting, to sign, opened, signed, declined), and once everyone has signed, the signed PDF with its download link.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Someone asks whether a document is signed.

## Say this to your agent

> Has Jana signed the trade agreement yet?

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `request_id` | string | yes | The request_id esign_send returned. Exactly 36 characters. |  |  |

## Example

Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff.

MCP: call `esign_get` on the MCP server `https://api.conecto.chat/mcp/esign` with these arguments:

```json
{
  "request_id": "1b3d5f7a-9c1e-4d3f-8a5b-7d9f1b3d5e8c"
}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/esign_get \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"request_id": "1b3d5f7a-9c1e-4d3f-8a5b-7d9f1b3d5e8c"}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "esign_get",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "request_id": "1b3d5f7a-9c1e-4d3f-8a5b-7d9f1b3d5e8c",
    "title": "Trade account agreement",
    "status": "sent",
    "order": "parallel",
    "sent_at": "2026-10-14T08:00:00+00:00",
    "expires_at": "2026-11-13T08:00:00+00:00",
    "completed_at": null,
    "document_file_id": "c6b43db2-3888-496c-97ce-3bdbada0390c",
    "signers": [
      {
        "position": 1,
        "name": "Jana Weber",
        "email": "jana@weber-kuechenplanung.example",
        "status": "pending",
        "viewed_at": null,
        "signed_at": null,
        "decline_reason": null
      }
    ],
    "history": [
      {
        "event": "sent",
        "at": "2026-10-14T08:00:00+00:00",
        "signer": null
      },
      {
        "event": "asked",
        "at": "2026-10-14T08:00:00+00:00",
        "signer": "jana@weber-kuechenplanung.example"
      }
    ]
  }
}
```

`result`: The request with its status, each signer's status and its history; once completed, the signed PDF's file and download link.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `not_found` | 404 | No signature request of the business has that request_id. | Find it with esign_list. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [esign_send](https://conecto.chat/tools/esign/esign_send.md): Sends a PDF from the file store to up to 10 people to sign; each gets their own link by email. $0.50 a call.
- [esign_save_template](https://conecto.chat/tools/esign/esign_save_template.md): Saves a PDF once with its signature fields placed per signer role, to send again and again. $0.001 a call.
- [esign_send_template](https://conecto.chat/tools/esign/esign_send_template.md): Sends a saved template to new signers, one per role: one request, or up to 50 at once. $0.50 per request sent.
- [esign_list_templates](https://conecto.chat/tools/esign/esign_list_templates.md): The saved templates, with their roles and fields. Free up to 1,000,000 reads a month.
- [esign_delete_template](https://conecto.chat/tools/esign/esign_delete_template.md): Deletes a saved template; requests already sent from it stay as they are. Free.
- [esign_list](https://conecto.chat/tools/esign/esign_list.md): Signature requests, newest first, optionally of one status. Free up to 1,000,000 reads a month.
- [esign_signing_link](https://conecto.chat/tools/esign/esign_signing_link.md): One signer's signing link, to hand over yourself. Free up to 1,000,000 reads a month.
- [esign_remind](https://conecto.chat/tools/esign/esign_remind.md): Emails everyone who still has to sign a reminder with their link, at most once a day. $0.02 a call.
- [esign_cancel](https://conecto.chat/tools/esign/esign_cancel.md): Stops a request before everyone has signed; signers are told and their links stop working. Free.