---
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-08-31T13:00:27.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 August 25, 2026

[

### Compete in OpenAI’s WebMCP Challenge with Netlify

](/blog/compete-openai-webmcp-challenge)

-   ![Profile picture of Karthik Puvvada](/_astro/e5524d3c315ad5114e1d5300d8991bfe902916fe-192x192_Z1w18MB.webp)
    
    Karthik Puvvada
    

News & Announcements August 19, 2026

[

### New clarifying questions in Agent Runners

](/blog/new-clarifying-questions-in-agent-runners)

-   ![Profile picture of Taylor Barnett-Torabi](/_astro/cf4624da8c1286738397b6fecb53bad504df140b-400x400_ZsvK0s.webp)
    
    Taylor Barnett-Torabi
    

Opinions & Insights August 14, 2026

[

### The full power of Git, without the friction: A conversation with Netlify CTO Dana Lawson

](/blog/netlify-source-with-netlify-cto-dana-lawson)

-   ![Profile picture of Dana Lawson](/_astro/856bf146d0c05c9dc25d45b59f7eac955fbbd644-512x512_1n84rs.webp)
    
    Dana Lawson
    

![](/_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/)