Form Filling Method

Smart Filling API for Form Filling

Our form filling API supports both 2. Mapping Filling Method and 1. Dynamic Filling Method methods. You can choose which method to use for your data, and we will handle the rest. This means you can mix both methods in a single form—for example, a partial form can be filled using the Mapping Filling method, and the remaining part can be filled using the Dynamic Filling method.

curl -L ​
  --request POST ​
  --url 'https://api.takeform.app/developer/v1/forms/{form_id}/fill' ​
  --header 'X-API-Key: YOUR_API_KEY' ​
  --header 'Content-Type: application/json; charset=utf-8' ​
  --data '{
  "mapping": {
  	"accommodation_in_japan": {
  		"accommodation_address": "1-2-3 Shibuya, Tokyo",
  		"accommodation_name": "Shibuya Hotel",
  		"accommodation_tel": "03-1234-5678"
  	},
  	"certificate_of_eligibility_no": "1234567890",
  	"criminal_history_declarations": {
  		"committed_trafficking": "No",
  		"convicted_crime": "No",
  		"convicted_drug_offence": "No",
  		"deported_removed": "No",
  		"engaged_prostitution": "No",
  		"sentenced_imprisonment": "No"
  	},
  },
  "dynamic": {
    "sources": [
        {
          "type": "Text",
          "text": "My name is TakeForm AI"
        },
        {
          "type": "SourceFile",
          "content_type": "application/pdf",
          "url": "https://mystorage.com/passport.pdf"
        }
      ]
  }
}'

At TakeForm, we offer two filling methods:

1. Dynamic Filling Method

As the name suggests, this method allows you to fill the form with various data types (text, images, DOCX, PDF, etc.) without explicitly declaring the mapping fields. It’s quick and easy, but costs more compared to the Mapping Filling Method.

2. Mapping Filling Method

This method requires you to declare values in the form using mapping fields. While it requires a bit more effort on your end, it’s highly accurate and costs less.

---