API

Developer API

Base URL, authentication, rate limits, and error behavior.

The Formlism developer API is owned by the form service and exposes API-key-backed form management and response reads.

Base URLs

EnvironmentBase URL
Productionhttps://api.formlism.com
UAThttps://uat-api.formlism.com

Authentication

Send an API key as a Bearer token. Missing, malformed, invalid, or revoked keys return 401.

Authorization: Bearer frmlsk_your_api_key_here

Rate limits

Developer API requests are limited to 100 requests per 1 minute per API key. Responses include X-RateLimit-Limit, X-RateLimit-Remaining, andX-RateLimit-Reset. When the limit is exceeded, Formlism returns429 with Retry-After.

Error format

{
  "error": "Invalid form payload",
  "details": {}
}

API keys

API key management is available inside the authenticated app through/api/developer/keys. The full key is returned only once on creation.