Home
Support Forums

API Deprecation notice: `/api/v1/forms` (`listForms`) will be deprecated on December 10th, 2020

On December 10th 2020, we will be retiring the /api/v1/forms endpoint from Netlify’s API. This is documented as listForms in our API documentation: https://open-api.netlify.com/#operation/listForms

This endpoint uses an implicit site-based filter, so it may not return all the forms for all the sites you have access to. This can cause unexpected results, especially if you’re part of multiple teams.

You can access a site’s forms via /api/v1/sites/:id/forms (https://open-api.netlify.com/#operation/listSiteForms), and get all sites via the /api/v1/sites (https://open-api.netlify.com/#operation/listSites) endpoint. Combining those 2 endpoints you can get the full list of forms from the sites you want.

We’ve updated our API documentation adding the deprecated tag. Please update your apps accordingly.

2 Likes