# listForms

The org's lead-capture forms (embed forms): name, slug, status (DRAFT | ACTIVE | INACTIVE), lifetime submissions, public URL, folderId. The id feeds getForm, listFormSubmissions and getFormAnalytics.

- Call: `POST https://server.goliathdata.com/api/v1/call` with `{ "operationId": "listForms", "variables": {...} }`
- Scope: `READ`
- Type: query
- Idempotency: a read; rejects `Idempotency-Key`
- Rate-limited: no

## Variables

None.

## Response (data, an example)

```json
{
  "embedFormQuery": {
    "list": [
      {
        "id": "<ID>",
        "name": "…",
        "slug": "…",
        "status": "DRAFT",
        "source": "…",
        "ownerType": "ORG",
        "publicUrl": "…",
        "shortUrl": "…",
        "submissionCount": 0,
        "folderId": "<ID>",
        "createdAt": "2026-01-01T00:00:00.000Z",
        "updatedAt": "2026-01-01T00:00:00.000Z"
      }
    ]
  }
}
```

## Example

```bash
curl https://server.goliathdata.com/api/v1/call \
  -H "Authorization: Bearer $GOLIATH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operationId": "listForms",
    "variables": {}
  }'
```