E-signature

Get a signature request

esign_get · Reads only · Markdown

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

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Has Jana signed the trade agreement yet?

Your agent callsesign_getFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "request_id": "1b3d5f7a-9c1e-4d3f-8a5b-7d9f1b3d5e8c"
}
What comes back
{
  "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"
    }
  ]
}

Use it when

Someone asks whether a document is signed.

What it does

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.

What comes back

The request with its status, each signer's status and its history; once completed, the signed PDF's file and download link. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
request_idRequiredstringThe request_id esign_send returned. Exactly 36 characters.

The call

Over MCP, call esign_get on https://api.conecto.chat/mcp/esign. Over REST:

Terminal
curl -X POST 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"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No signature request of the business has that request_id.Find it with esign_list.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md