---
title: "Handling form submissions via the Netlify API"
description: "Learn how to use the Netlify API to programmatically access, update, or delete your form submissions"
source: "https://www.netlify.com/blog/2021/12/17/handling-form-submissions-via-the-netlify-api/"
last_updated: "2026-07-10T21:15:17.000Z"
---
> Throughout December we’ll be [highlighting a different Netlify feature each day](https://www.netlify.com/blog/2021/12/01/highlighting-a-different-netlify-feature-each-day-in-december/?utm_campaign=featdaily21&utm_source=netlify&utm_medium=blog&utm_content=submissions-api). It might just be the thing you need to unlock those creative juices, and [dust off that domain](https://www.netlify.com/blog/2021/12/01/dusty-domains-your-forgotten-domains-raise-money-for-charity/?utm_campaign=featdaily21&utm_source=netlify&utm_medium=blog&utm_content=submissions-api) you registered but never deployed! Keep an eye [on the blog](https://www.netlify.com/blog/2021/12/01/highlighting-a-different-netlify-feature-each-day-in-december/?utm_campaign=featdaily21&utm_source=netlify&utm_medium=blog&utm_content=submissions-api) and on [Twitter](https://twitter.com/netlify) for each feature!

When [using Netlify Forms](/blog/2021/12/16/accepting-form-submissions-without-a-server/?utm_campaign=featdaily21&utm_source=netlify&utm_medium=blog&utm_content=submissions-api), you can access your submissions via the UI under the `Forms` tab of your site, but if you’d like to programmatically access them, you can use the Netlify API to do so.

A few endpoints and operations are available.

**Note: All URLs start with [https://api.netlify.com/api/v1](https://api.netlify.com/api/v1). SSL only.**

-   Get verified submissions for **all forms** of a site with a GET request to `/sites/{site_id}/submissions`.
-   Get verified submissions for a **specific form** of a site with a GET request to `/forms/{form_id}/submissions`.
-   Get spam submissions by adding the query parameter `state=spam` to the URLs mentioned above. _For example `/forms/{form_id}/submissions?state=spam`_.
-   Change submission state with the 2 following operations:
    -   PUT request to `/submissions/{submission_id}/spam` to mark a submission as spam.
    -   PUT request to `/submissions/{submission_id}/ham` to mark a submission as ham.
-   Delete submissions with a DELETE request to `/submissions/{submission_id}`

That’s it! From there you can manage your submissions whichever way you want!

## More information

-   [Docs: Handling Forms via the API](https://docs.netlify.com/api/get-started/?utm_campaign=featdaily21&utm_source=netlify&utm_medium=blog&utm_content=submissions-api#forms)

### Share

-   [X (fka Twitter)](https://twitter.com/intent/tweet?text=Handling form submissions via the Netlify API&url=https://www.netlify.com/blog/2021/12/17/handling-form-submissions-via-the-netlify-api//)
-   [LinkedIn](https://www.linkedin.com/shareArticle?mini=true&url=https%3A%2F%2Fwww.netlify.com%2Fblog%2F2021%2F12%2F17%2Fhandling-form-submissions-via-the-netlify-api%2F%2F)
-   [Facebook](https://www.facebook.com/sharer.php?u=https://www.netlify.com/blog/2021/12/17/handling-form-submissions-via-the-netlify-api//)
-   [Bluesky](https://bsky.app/intent/compose?text=Handling form submissions via the Netlify API+https://www.netlify.com/blog/2021/12/17/handling-form-submissions-via-the-netlify-api//)

* * *

### Tags

-   [Tips](/blog/tags/tips/)
-   [Netlify API](/blog/tags/netlify-api/)

## Keep reading

![](/images/blog-fallback-thumbnail.svg)

Guides & Tutorials December 1, 2021

[

### Highlighting a different Netlify feature each day in December

](/blog/2021/12/01/highlighting-a-different-netlify-feature-each-day-in-december)

-   ![Profile picture of Phil Hawksworth](/_astro/9cfe2bbe94bcb555ce3ac7683ac7905ad3fd32b1-400x400_Z18H6R1.webp)
    
    Phil Hawksworth
    

![](/_astro/3f45eb6eda4ea8814be310e3df4a7883a5bd9ba0-1200x675_ZcBDUS.webp)

Guides & Tutorials May 15, 2026

[

### How to build a real-time AI chatbot in minutes with Netlify Agent Runners (no backend)

](/blog/how-to-build-a-real-time-ai-chatbot-in-minutes-with-netlify-agent-runners-no-backend)

-   ![Profile picture of Nahrin Jalal](/_astro/f0e7c8f227a03fe58340c99ef5439d5a896c0733-272x272_Z23kDpD.webp)
    
    Nahrin Jalal
    

## Recent posts

News & Announcements June 25, 2026

[

### Netlify Functions, designed for Agent Experience

](/blog/netlify-functions-designed-for-agent-experience)

-   ![Profile picture of Eduardo Bouças](/_astro/52958f21e8450baf6d8e60302341a984e220c0cd-512x512_13VDlu.webp)
    
    Eduardo Bouças
    

News & Announcements June 24, 2026

[

### How we measure Netlify’s Agent Experience

](/blog/how-we-measure-netlify-agent-experience)

-   ![Profile picture of Sean Roberts](/_astro/bbf2243f8171dbddd80ab2103622106cef84d125-512x512_Z1d2LKE.webp)
    
    Sean Roberts
    

Guides & Tutorials May 15, 2026

[

### How to build a real-time AI chatbot in minutes with Netlify Agent Runners (no backend)

](/blog/how-to-build-a-real-time-ai-chatbot-in-minutes-with-netlify-agent-runners-no-backend)

-   ![Profile picture of Nahrin Jalal](/_astro/f0e7c8f227a03fe58340c99ef5439d5a896c0733-272x272_Z23kDpD.webp)
    
    Nahrin Jalal
    

![](/_astro/3f255b372fa958df35802666ee33b4609b2d71bd-1200x1586_1VtE2D.webp)

### How do the best dev and marketing teams work together?

[Access the report](https://www.netlify.com/reports/2024-leadership-trend-report/access/)