List signatures
Every signature in the workspace, or the signatures of one address.
Runs the real call on your workspace.
GET /signatures
Every signature in the workspace, or the signatures of one address.
Example
Needs settings:read. An address keeps a list of named signatures. Without address the list holds every address, sorted by address and then oldest first. With it, only the signatures of that address, or of a catch-all written *@acme.com.
curl "$OE/[email protected]" -H "$AUTH"{ "object": "list", "data": [ { "object": "signature", "id": "sig_2b7e9c41d0a54f3e8c6d1a90", "address": "[email protected]", "name": "Work", "html": "<p>Ada Lovelace<br />Head of Research, Acme Ltd</p>", "isDefault": true, "isReplyDefault": false, "createdAt": "2026-09-02T08:14:03.117Z", "updatedAt": "2026-10-01T10:05:12.031Z" }, { "object": "signature", "id": "sig_8f2c1a9b7d3e4f60a1b2c3d4", "address": "[email protected]", "name": "Short", "html": "<p>Ada<br />Acme Ltd</p>", "isDefault": false, "isReplyDefault": true, "createdAt": "2026-10-12T09:14:03.117Z", "updatedAt": "2026-10-12T09:14:03.117Z" } ], "hasMore": false, "nextCursor": null}isDefault marks the signature new mail from the address carries, and isReplyDefault the one its replies and forwards carry. At most one signature of an address holds each, one signature can hold both, and an address may have neither.
The list pages with limit and cursor, as every list does. An address that only ever had the single signature of earlier versions shows it as one signature called Signature, default for both.
A key or an app limited to particular addresses or domains reaches only the signatures of the addresses it holds, and those of a catch-all only when it holds the domain whole.