Blankety API

Blankety builds web forms and collects their submissions.

Base URL: https://blankety.tone.fyi

Authentication

Create an API key in the Blankety console under API keys. Keys carry scopes; a request that needs a scope the key doesn't have gets 403 with insufficient_scope.

Pass your API key as the apiKey query parameter, or in an APIKEY header:

GET /v1/user/forms?apiKey=YOUR_API_KEY

Scopes

`forms:read`	Read forms
`submissions:read`	Read submissions
`webhooks:manage`	Manage webhooks
`admin`	Full account administration

Rate limits

Each account can make 1,000 requests per 24 hours. Over the limit, requests get 429 with a Retry-After header. Responses carry X-Rate-Limit-Limit, X-Rate-Limit-Remaining and X-Rate-Limit-Window.

Pagination

List endpoints take offset and limit. resultSet.count is the number of items in this response.

Times

Timestamps are in the account's time zone.

Errors

Errors return a JSON body: {"error": {"code": "...", "message": "..."}}.

Endpoints

GET `/v1/user/forms`

Forms on the account.

Scope: forms:read

POST `/v1/form/:formId/webhooks`

Send each new submission to a URL.

Scope: webhooks:manage

Body: JSON

url HTTPS endpoint (required).

GET `/v1/form/:formId/submissions`

Submissions to one form, newest first.

Scope: submissions:read

`created_after, created_before`	Time range, in the account's time zone (YYYY-MM-DD HH:MM:SS).
`offset, limit`	Paging (max 1000).

Webhooks

Webhooks are signed following the Standard Webhooks specification (webhook-id, webhook-timestamp, webhook-signature). Deliveries are retried on failure, and may occasionally arrive more than once.