Menu

Mattering Forms API

Forms, fields, submissions and cross-app mappings for Mattering Forms.

User APIhttps://forms.mattering.io/api/user/v1/ Service tierhttps://forms.mattering.io/api/internal/ 9 MCP tools

Resources

14 endpoints, 13 on the User API, 1 service-only.

ResourceEndpointsMethodsTiers
Forms 2 GETPOST User API
Mappings 3 GETPOSTDELETE User API
Org erasure 1 POST User API
Org export 1 POST User API
Search 1 GET User API
Spaces 1 GET User API
Submissions 1 GET User API
User erasure 1 POST User API
User export 1 POST User API
Workspaces 1 GETPOST User API

Service tier only

These resources are reachable with the internal secret only. They are documented for operators and for anyone reading the MCP tools that wrap them.

ResourceEndpointsMethods
Custom fields 1 GET

MCP tools

The Mattering MCP gateway exposes 9 tools for Forms. Each wraps one of the endpoints above on the User API, forwarding your token.

See the Forms MCP tools

Shape against the shared standard

Mattering is converging every app on one API shape (the Base API Template). This is where Forms stands, measured from its code. Read it before assuming the envelope on one app matches another.

Yes User tier mounted (/api/user/v1/)
Not yet Internal tier versioned (/api/internal/v1/)
Not yet One api_urls.py included on both tiers
Not yet Responses use the {data, meta} envelope 0 of 14 endpoints
Not yet Collection reads paginate with meta.total 2 of 6 list endpoints paginate
Not yet Errors carry a snake_case code and a detail 31 of 32 error returns use a stable code

Source: FormsCore/api_urls.py, MatteringForms/urls.py. Regenerated by tools/build_api_docs.py.

Start Free Explore our Products