Repository navigation
API site filter
github-actions[bot] edited this page Oct 14, 2026
·
1 revision
Where Statamic's REST API or GraphQL exposes forms, their form listings take an optional site filter, which lists only the forms assigned to that site, together with the forms that have no sites.
| Surface | Parameter | Example |
|---|---|---|
REST, GET /api/forms
|
site query parameter |
/api/forms?site=es |
GraphQL, forms query |
site argument |
forms(site: "es") |
curl 'https://example.com/api/forms?site=es'{
forms(site: "es") {
handle
title
}
}- Without the filter, or with
site: nullin GraphQL, the listings are Statamic's. - A
sitethat names no configured site is an error rather than an empty list: the REST API answers 422 with a message, and GraphQL answers avalidationerror. - The filter narrows only the forms the API already exposes.
- The single-form endpoint and query are unchanged.
- Submissions are not filtered.
Home | README | Repository
Written against v0.6.1. These pages are edited in docs/wiki/ through a pull request; an edit made in the wiki is overwritten by the next publish.
Guides for site builders
- Showing a form on some sites only
- Giving each site its own title, email and store
- Checking a form's site in a template
Guides for administrators
Guides for developers
Troubleshooting
Reference
- Configuration
- Per-site title, email and store
- Control Panel access
- Attribute command
- API site filter
- Form assigned tag
- Site form view
- README
Project