Retrieve a signup form
GET/v1/forms/{id}
One form, with the address of its hosted page.
Required scope: contacts:manage
Parameters
| Name | In | Description |
|---|---|---|
idrequired | path | The form id. |
Example
curl -X GET 'https://api.sendsend.email/v1/forms/ID' \
-H "Authorization: Bearer $SENDSEND_API_KEY"Response 200
{
"id": "frm_Bn6…",
"object": "form",
"audience_id": "aud_7Qe2…",
"name": "Footer signup",
"title": "Join the newsletter",
"double_opt_in": true,
"from": "Acme <news@mail.acme.com>",
"confirm_subject": null,
"success_url": null,
"confirmed_url": "https://acme.com/welcome",
"topic_ids": [],
"collect_name": false,
"active": true,
"url": "https://api.sendsend.email/f/frm_Bn6…",
"created_at": "2026-10-06T15:00:00.000Z",
"updated_at": "2026-10-06T15:00:00.000Z"
}Errors
| Status | Code | When |
|---|---|---|
| 404 | not_found | No such resource in this project. |
| 401 | unauthorized | The API key is missing, invalid or revoked. |
| 403 | forbidden | The key does not have the scope this endpoint needs. |
Every error has the same shape. See Errors.