# Get a form

**Publié le** : 2026-05-08
**Catégorie** : Forms & Reviews

## `GET /forms/:id`

**Get a form**

Returns a form with its complete field schema and settings.

Required permissions: `forms.view`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | Yes | Unique identifier |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `401` | Unauthorized — invalid or missing API token |
| `403` | Forbidden — insufficient permissions |
| `404` | Not found |


### Examples

```bash
curl https://api.lynkow.com/v1/forms/1 \
  -H "Authorization: Bearer $API_TOKEN"
```

### Response Example

```json
{
  "data": {
    "id": 1,
    "name": "Contact Form",
    "slug": "contact-form",
    "status": "active",
    "locale": "en",
    "submissionCount": 134,
    "schema": [
      {
        "name": "name",
        "type": "text",
        "label": "Full Name",
        "required": true,
        "placeholder": "Your name"
      },
      {
        "name": "email",
        "type": "email",
        "label": "Email Address",
        "required": true,
        "placeholder": "you@example.com"
      },
      {
        "name": "message",
        "type": "textarea",
        "label": "Message",
        "required": true,
        "placeholder": "How can we help?"
      },
      {
        "name": "rating",
        "type": "rating",
        "label": "How would you rate us?",
        "required": false
      }
    ],
    "successMessage": "Thank you for your message!",
    "redirectUrl": null,
    "createdAt": "2025-01-05T10:00:00.000Z",
    "updatedAt": "2025-03-20T08:15:00.000Z"
  }
}
```

---