Get Form

Retrieves a single form by its ID.


GET /v1/forms/{formId}

Request


curl https://api.formtorch.com/v1/forms/a1b2c3d4e5 \
  -H "Authorization: Bearer YOUR_API_KEY"

Path parameters

Parameter	Description
`formId`	The 10-character form ID

Response


{
  "id": "a1b2c3d4e5",
  "name": "Contact Form",
  "projectId": "p9q8r7s6t5",
  "endpoint": "https://formtorch.com/f/a1b2c3d4e5",
  "submissionCount": 142,
  "spamCount": 7,
  "webhooks": [
    {
      "id": "wh1a2b3c4d",
      "url": "https://yoursite.com/api/webhooks/formtorch",
      "createdAt": "2025-02-01T08:00:00.000Z"
    }
  ],
  "createdAt": "2025-01-10T09:00:00.000Z",
  "updatedAt": "2025-03-01T14:22:00.000Z"
}

Response fields

Field	Type	Description
`id`	string	Form ID
`name`	string	Form display name
`projectId`	string	Parent project ID
`endpoint`	string	Full submission endpoint URL
`submissionCount`	integer	Non-spam submission count
`spamCount`	integer	Spam submission count
`webhooks`	array	Configured webhook endpoints
`createdAt`	string	ISO 8601 creation timestamp
`updatedAt`	string	ISO 8601 last updated timestamp

Error responses

Status	Code	Description
`404`	`form_not_found`	No form with this ID in your account