# List signatures

Source: https://docs.maylee.app/api-reference/signatures/list-signatures

`GET https://api.maylee.app/api/v1/signatures`

Scope: `read`.

Call this to turn a signature name into the id that `signature` takes on a send or a draft.

## Example request

```bash
curl -X GET "https://api.maylee.app/api/v1/signatures" \
  -H "Authorization: Bearer $MAYLEE_KEY"
```

## Responses

### 200

Signatures of the workspace.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | array of Signature | yes |  |
| `items[].id` | string | yes |  |
| `items[].isDefault` | boolean | yes | The one applied when a send does not ask for another. |
| `items[].name` | string | yes |  |
| `items[].position` | integer | yes |  |
| `items[].aliasEmail` | string or null | no |  |
| `items[].createdAt` | string (date-time) | no |  |
| `items[].mailboxId` | string or null | no |  |
| `items[].updatedAt` | string (date-time) | no |  |

```json
{
  "items": [
    {
      "id": "string",
      "isDefault": true,
      "name": "string",
      "position": 0,
      "aliasEmail": "string",
      "createdAt": "2026-09-24T09:30:00.000Z",
      "mailboxId": "string",
      "updatedAt": "2026-09-24T09:30:00.000Z"
    }
  ]
}
```

### 401

Missing, malformed, revoked or expired API key.

### 403

Key lacks the required scope, or outbound sending is not enabled on it.

### 429

Per-minute rate limit (`RATE_LIMIT_EXCEEDED`) or monthly quota (`QUOTA_EXCEEDED`) exhausted.

Errors use the format `{ "code", "error", "details" }`: see [Errors](/errors.md).