# Getform API

# API Authentication

The Getform API is organized around REST. Our API returns JSON-encoded responses, and uses standard HTTP response codes, authentication.

All Getform API endpoints accept authentication by passing your token as a GET parameter. You can find your form specific API token under your "Form Settings" page on your form dashboard.

# API Token Format

Here is the sample API token format of Getform API:

https://api.getform.io/v1/forms/{form_id}?token={getform_api_token}

TIPS

  • Each token you generate is form specific and you need to use a different token for each form.
  • Make sure to keep the API token secret. If you notice that it's been compromised, you can use "Refresh Token" button to regenerate it.
  • Make sure to change your form_id and getform_api_token in the call above with your unique form ID and API token, otherwise you won't get the correct response for your API call.

INFO

  • Rate limiting applies for Getform API Endpoints for free plan holders. A maximum of 60 requests per hour can be made. This limit does not apply for premium plan holders.
  • If you exceed the rate limit, a 429 error will be returned from the API.