AI Form API

AI Form API API

Create forms, share a public link, read responses as JSON or CSV, get a webhook per response. Every public form can also be filled by the visitor's own AI…

Developer tools#documents--productivity

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Create forms, share a public link, read responses as JSON or CSV, get a webhook per response.

Every public form can also be filled by the visitor's own AI agent (fill codes, /v1/fill, or the fill MCP).

Request bodies are limited to 64 KB. Rate-limited endpoints send RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset; 429 adds Retry-After.

Free plan: 30 requests/min and 1000/day per API key, 3 open forms, 100 responses per month.

Field types: short_text, long_text, email, number, url, phone, single_choice, multi_choice, checkbox, date, rating. At most 50 fields per form. Fill codes live 60 minutes.

Endpoints 22

Account

  • POSTSend a sign-in link/v1/signupSends a magic link to the address. The link signs in to the dashboard, which shows the first API key once. The answer is the same for known and unknown…
  • GETPlan, limits and current usage/v1/usage

Forms

  • GETList your forms/v1/formsNewest first, cursor pagination.
  • POSTCreate a form/v1/formsCreates an open form and returns its public URL. Free plan: 3 open forms. Fields asking for passwords, codes, card or account numbers, and passport or…
  • POSTCopy a form from Google Forms (draft)/v1/forms/importSend url (a public Google Forms link: docs.google.com/forms/... or forms.gle/...) or fields (a list of {label, type, required, options}). Returns a draft you…
  • GETRead a form/v1/forms/:id
  • DELETEDelete a form and all its responses/v1/forms/:id
  • PATCHChange title, description, fields or settings/v1/forms/:idSend only what changes. fields replaces the whole list. settings merges key by key and null removes a key.
  • POSTStop accepting responses/v1/forms/:id/close
  • POSTAccept responses again/v1/forms/:id/reopenCounts against the open-form quota like a new form.

Responses

  • GETRead responses as JSON or CSV/v1/forms/:id/responsesOldest first by default. CSV has one column per field id, then response_id, source, submitted_at. When more rows exist the CSV response carries an…
  • GETRead one response/v1/forms/:id/responses/:response_id

Webhooks

  • POSTCall a URL for each new response/v1/forms/:id/webhooksPOST {event:"response.created", form_id, response} with header X-AIFormAPI-Signature: t=<unix>,v1=<hex HMAC-SHA256(secret, t + "." + body)>. 5 s timeout, 1…
  • DELETERemove a webhook/v1/forms/:id/webhooks/:webhook_id

Public

  • GETPublic form schema/v1/public/forms/:slugNo owner data. Per IP: 60 per minute.
  • POSTSubmit a response as a person/v1/public/forms/:slug/responsesPer IP: 5 per minute and 30 per hour. Per form: 60 per minute. When Turnstile is on, send turnstile_token.
  • POSTReport a form/v1/public/abuse-reports

Agent fill

  • POSTGet a fill code and prompt for an AI agent/v1/public/forms/:slug/fill-tokensReturns a single-use code (valid 60 minutes, 5 POST attempts) and the ready-to-paste prompt. Per IP: 5 per minute and 30 per day. Per form: 200 per day.
  • GETRead the form and instructions for a fill code/v1/fill/:tokenFor agents that can only GET. Does not use up the code. 30 per hour per code.
  • POSTSubmit answers with a fill code/v1/fill/:tokenOne successful use per code. At most 5 POST attempts: the 6th gets 410 token_expired with details.reason "max_attempts". Per IP: 10 per minute.
  • GETRead a form for the static agent line/v1/agent/:slugThe address inside the one-line prompt an owner puts above a form. No fill code and no human check. Works only when the owner turned on agent_line (default on…
  • POSTSubmit answers through the static agent line/v1/agent/:slugNeeds the owner's switch (agent_line), the secret code if one is set, an open form and room in the owner's monthly quota. Fields asking for passwords, codes,…

API details

Base URL
https://aiformapi.com
Authentication
A bearer token in the Authorization header
Operations
22 operations on 17 pathsPOST 11GET 8DELETE 2PATCH 1
Main resources
Forms 8Agent fill 5Public 3Account 2Responses 2Webhooks 2
Response formats
application/json text/csv
Description format
OpenAPI 3.1.0, API version 0.1.0

How to test the AI Form API API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the AI Form API API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Send a sign-in link” (POST /v1/signup), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the AI Form API API?

Create forms, share a public link, read responses as JSON or CSV, get a webhook per response. Every public form can also be filled by the visitor's own AI… It is listed under Developer tools and has 22 endpoints.

Who publishes the AI Form API API?

It is listed from AI Form API's public API description (an OpenAPI document), not published by AI Form API on Swastik Codes. Anyone who controls aiformapi.com can claim the profile by adding a DNS TXT record.

What is the base URL of the AI Form API API?

Requests go to https://aiformapi.com. Endpoint paths are added to this base URL.

How do I authenticate with the AI Form API API?

With A bearer token in the Authorization header.

How many endpoints does the AI Form API API have?

22 operations on 17 paths (11 POST, 8 GET, 2 DELETE, 1 PATCH). The largest groups are Forms, Agent fill, Public, Account.

Is forking the AI Form API API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.