# List a record's e-signature events

One deal contract's envelope trail, newest first — what was sent, seen and signed, and when. Read-only here on purpose: the entries are written by the contract moves themselves, and by an external signer's webhook if one is ever wired up. There is no signing vendor in this service. Deals page only.

Access class: `def:read`.

## Endpoint

`GET /v1/definitions/{key}/rows/{rowId}/signing-events`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| key | path | string | Yes |
| rowId | path | string | Yes |
| body | query | null | No |
| params | query | object | No |
| query | query | object | No |

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": [
    {
      "event": "string",
      "externalEventId": "",
      "id": "",
      "occurredAt": "string",
      "payload": {},
      "signerEmail": "string",
      "signerName": "string"
    }
  ]
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```