---
title: List forms
description: List a certificate's request, unlock, and correction forms
method: GET
path: /api/v1/workspaces/{slug}/certificates/{id}/forms
group: Forms
scopes: certificates:read
---

# List forms

# List forms

Returns all three form kinds for a certificate. A kind the certificate has never
configured comes back with an empty field list and `enabled: false`, so clients
never have to branch on absence.

## Authorization

```http
Authorization: Bearer vc_...
```

Requires `certificates:read` (or full access).

## Path parameters

  
- `slug*` string — Workspace slug Example: `acme`.

  
- `id*` string — Certificate id Example: `550e8400-e29b-41d4-a716-446655440000`.

## Request

```bash
curl "https://api.verifycate.com/api/v1/workspaces/acme/certificates/550e8400-e29b-41d4-a716-446655440000/forms" \
  -H "Authorization: Bearer vc_your_api_key"
```

## Response

### 200

```json
{
  "items": [
    { "kind": "request", "enabled": true, "title": "Apply", "fields": [], "current_version": 1 },
    { "kind": "unlock", "enabled": true, "title": "Event Feedback", "fields": [], "current_version": 3 },
    { "kind": "correction", "enabled": false, "title": "", "fields": [], "current_version": 0 }
  ]
}
```