# List a deal's signature requests

Every envelope this deal's contract has been through, newest first, with each signer's state: waiting, viewed, signed or declined.

Access class: `def:read`.

## Endpoint

`GET /v1/definitions/{key}/rows/{rowId}/contract/signature-requests`

## 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": [
    {
      "cancelledAt": "string",
      "cancelledReason": "string",
      "completedAt": "string",
      "createdAt": "string",
      "createdBy": 1,
      "dealId": "",
      "documentId": "",
      "documentTitle": "string",
      "expiresAt": "string",
      "id": "",
      "message": "string",
      "purpose": "string",
      "rowId": "",
      "signers": [
        "string"
      ],
      "signingOrder": "string",
      "status": "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"
}
```