PDF Fill PDF Forms

Explore Samples

PDF filler for fillable PDF forms using PDF.co.

To find names of PDF form fields names, please use this interactive tool.

To get the list of all fillable fields inside PDF form, please use /pdf/info/fields endpoint.

If you need to create your own fillable form then please check PDF Create Fillable PDF Forms topic.

Available Methods

• [POST] /pdf/edit/add (fill pdf form)
• [POST] /pdf/edit/add (fill pdf form with simplified params)

[POST] /pdf/edit/add (fill pdf form)

Add text, images, signatures, other pdfs, text fields, unchecked checkbox, checked checkbox to existing PDF file. You can fill out out existing PDF forms and documents and create new fillable PDF forms using this method.

To find X and Y coordinates for placing text, images or objects please use special PDF viewer displaying X and Y coordinates.

To save an image or pdf for reuse as a template please use a link from Dropbox or Google Drive or from other storage. Or use built-in PDF.co Files storage. If you need to draw a signature and save it as an image then use this page.

JSON request

• url required. URL to the source file. Supports links from Google Drive, Dropbox and from built-in PDF.co files storage.
  
  For uploading files via API please check Files Upload section.
  
  If you are randomly getting Too Many Requests or Access Denied error for your input url, please try to add cache: to enable built-in url caching.
  
  You can also encrypt data for output files and decrypt data input files with user-controlled data encryption (uses strong AES encryption with your own keys). Click here to learn more.
• httpusername optional - http auth user name if required to access source url.
• httppassword optional - http auth password if required to access source url.
• annotations[] array of objects. optional. Array of text objects to be added on top of pdf. Text objects can be ready-only ("type": "text" by default) or interactive as input fields ("type": "textField") or checkboxes ("type": "checkbox").

Parameters for annotations objects:

• text - string to add. If you need to insert a line break then use \n or {{$$newLine}}.

You can also use built-in macros like {{$$PageNumber}} and custom data macros. Check this knowledgebase article for more details on macros.

• x - X coordinate (zero point at left top, use this viewer to measure coordinates.
• y - X coordinate (zero point at left top, use this viewer to measure coordinates.
• width optional - width of the text box (zero point at left top, use this viewer to measure coordinates.
• height optional - width of the text box (zero point at left top, use this viewer to measure coordinates.
• alignment (optional, default is left). Sets text alignment within width of the text box. Valid values: left, center, right.
• pages - comma-separated indices of pages (or page ranges) that you want to use. The first page indice is always 0. For example, if you have a 7 page document that you want split into 3 separate PDFs but different number of pages it would go like this: 0, 1, 2- or 1, 2, 3-7 which will result in 1 PDF with page one, 1 PDF with page two and one PDF with the rest of the pages. You can also use inverted page numbers adding ‘!’ before the number. E.g. “!0” means “the last page”, “1-!1” means “from the second to the penultimate page”, “!1-“ - last two pages”. Also, you can use a single asterisk (“*”) character as the range to split the document into separate pages. SPECIAL CASES: You can use a single asterisk * symbol to split the document into separate pages. Parameter must be a String.
• color (optional, default is black) - color for the text.
• link optional - sets link on click for text.
• size (optional, default is 12) - set font size.
• fontName (optional, default is Arial) - sets font name to use. Check the font list for all supported fonts.
• fontBold (optional, default is false) - set to true to enable bold font style.
• fontStrikeout (optional, default is false) - set to true to enable strikeout font style.
• fontUnderline (optional, default is false) - set to true to enable underline font style.
• type (optional, default is text). Set object type, available types: text = text object, textfield = text input field, checkbox = checkbox field.
• id optional - sets id of the form field if type is not text.

Images

• images[] array is optional. Array of image urls (also can be a link to Files storage or datauri link) to be added on top of PDF file. Images can be loaded from URL or from URLs for internal file storage.

Parameters for Images objects:

• url - url to image or pdf as http link, filetoken or datauri:.. url (with base64 encoded image or pdf).
• x - X coordinate (zero point at left top, use this viewer to measure coordinates.
• y - X coordinate (zero point at left top, use this viewer to measure coordinates.
• width optional - width of the text box (zero point at left top, use this viewer to measure coordinates.
• height optional - width of the text box (zero point at left top, use this viewer to measure coordinates.
• pages - comma-separated indices of pages (or page ranges) that you want to use. The first page indice is always 0. For example, if you have a 7 page document that you want split into 3 separate PDFs but different number of pages it would go like this: 0, 1, 2- or 1, 2, 3-7 which will result in 1 PDF with page one, 1 PDF with page two and one PDF with the rest of the pages. You can also use inverted page numbers adding ‘!’ before the number. E.g. “!0” means “the last page”, “1-!1” means “from the second to the penultimate page”, “!1-“ - last two pages”. Also, you can use a single asterisk (“*”) character as the range to split the document into separate pages. SPECIAL CASES: You can use a single asterisk * symbol to split the document into separate pages. Parameter must be a String.
• link optional - link to open on click.
• keepAspectRatio (optional, true by default). Set to false if don’t need to keep aspect ratio for image/pdf added. In this case it will use width and height parameters provided.

Fields

• fields[] array is optional. Array of values to update fillable pdf fields in input pdf. You can create your own automated PDF filler for your pdf forms using this array.

Parameters for Fields objects

• fieldName - name of the form field. Find form field names using this pdf info tool
• pages - page index where this form field appears.
• text - value to set for this field. If you have checkbox, set X, true, 1 or another text which is different from false to enable checkbox. For radiobuttons and comboboxes you need to set index of the item to select. Explore pdf form fields in your pdf using this pdf info tool
• fontName optional. name of the font to use to fill out input field. Check the font list for all supported fonts.
• size optional. Override font size of the text inside given input field.
• fontBold optional. Override font bold style of text input field.
• fontItalic optional. Override font italic style of text input field.
• fontStrikeout optional. Override font strikeout style of text input field.
• fontUnderline optional. Override font underline style of text input field.

Tip: to turn all fillable fields into read-only fields, just set the profiles parameter (of the endpoint) to this value:
{ 'FlattenDocument()': [] }

Additional Parameters

• password optional. Password of PDF file. Must be a String.
• async optional. Runs processing asynchronously. Returns JobId that you may use with /job/check to check the state of the processing (possible states: working, failed, aborted and success). Must be one of: true, false. IMPORTANT: Also set inline param to true to get direct link to final output pdf in both sync and async modes. Otherwise, you will be getting direct link to pdf in sync mode but also link to .json file in the async mode.
• inline optional. Set to true to get direct link to output pdf in async mode (otherwise you will get link to json with url inside when you use async mode).
• name optional. File name for generated output. Must be a String.
• expiration optional. Output link expiration in minutes. Default is 60 (i.e. 60 minutes or 1 hour). After this delay generated output file(s) (if any) will be auto-removed from PDF.co temporary files storage. Max allowed expiration period depends on your current subscription plan. To store permanent input files (e.g. re-usable images, pdf, documents), please use PDF.co built-in Files Storage instead.
• async optional. Runs processing asynchronously. Returns JobId that you may use with /job/check to check state of the background job (possible states: working, failed, aborted and success). Must be one of: true, false.
• profiles optional. Must be a String. You can set additional and extra options using this parameter that allows you to set custom configuration.

For example, to flatten pdf form, set profiles to this value:

{ 'FlattenDocument()': [] }

See profiles samples for examples.

• templateData optional. Set JSON as escaped string for use as custom macros. See[this knowledgebase article[(https://apidocs.pdf.co/kb/Fill%20PDF%20and%20Add%20Text%20or%20Images%20(pdf-edit-add)/macros#custom-macros) for more details.

• Method: POST
• URL: /v1/pdf/edit/add

Query parameters

No query parameters accepted.

Body payload

{
    "async": false,
    "encrypt": false,
    "inline": true,
    "name": "f1040-filled",
    "url": "https://bytescout-com.s3-us-west-2.amazonaws.com/files/demo-files/cloud-api/pdf-form/f1040.pdf",
    "fields": [
        {
            "fieldName": "topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1]",
            "pages": "1", 
            "text": "True" 
        },
        {
            
            "fieldName": "topmostSubform[0].Page1[0].f1_02[0]",
            "pages": "1", 
            "text": "John A."
        },        
        {
            
            "fieldName": "topmostSubform[0].Page1[0].f1_03[0]",
            "pages": "1", 
            "text": "Doe"
        },        
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_04[0]",
            "pages": "1",
            "text": "123456789"
        },
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]",
            "pages": "1",            
            "text": "Joan B.",
            "fontName": "Arial",
            "size": 6,
            "fontBold": true,
            "fontItalic": true,
            "fontStrikeout": true,
            "fontUnderline": true
        },
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]",
            "pages": "1",
            "text": "Joan B."
        },
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_06[0]",
            "pages": "1",
            "text": "Doe"
        },
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_07[0]",
            "pages": "1",
            "text": "987654321"
        }     



    ],
    "annotations":[
        {
            "text":"Sample Filled with PDF.co API using /pdf/edit/add. Get fields from forms using /pdf/info/fields. This text is be added on the first (0) and the last (!0) pages.",
            "x": 400,
            "y": 10,
            "width": 200,
            "height": 500,
            "size": 12,            
            "pages": "0-",
            "color": "FF0000",
            "link": "https://pdf.co"
        }
    ],    
    "images": [
        {                             
            "pages": "!0", 
            "x": 100, 
            "y": 374,
            "width": 100, 
            "url": "data:image/png;base64,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"
        }
    ]
}

Example responses

/pdf/edit/add

{
    "hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "url": "https://pdf-temp-files.s3.amazonaws.com/cd15a09771554bed88d6419c1e2f2b16/f1040-filled.pdf",
    "pageCount": 3,
    "error": false,
    "status": 200,
    "name": "f1040-filled.pdf",
    "remainingCredits": 99999369,
    "credits": 63
}

Code Snippet

CURL

curl --location --request POST 'https://api.pdf.co/v1/pdf/edit/add' \
--header 'Content-Type: application/json' \
--header 'x-api-key: ' \
--data-raw '{
    "async": false,
    "encrypt": false,
    "inline": true,
    "name": "f1040-filled",
    "url": "https://bytescout-com.s3-us-west-2.amazonaws.com/files/demo-files/cloud-api/pdf-form/f1040.pdf",
    "fields": [
        {
            "fieldName": "topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1]",
            "pages": "1", 
            "text": "True" 
        },
        {
            
            "fieldName": "topmostSubform[0].Page1[0].f1_02[0]",
            "pages": "1", 
            "text": "John A."
        },        
        {
            
            "fieldName": "topmostSubform[0].Page1[0].f1_03[0]",
            "pages": "1", 
            "text": "Doe"
        },        
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_04[0]",
            "pages": "1",
            "text": "123456789"
        },
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]",
            "pages": "1",            
            "text": "Joan B.",
            "fontName": "Arial",
            "size": 6,
            "fontBold": true,
            "fontItalic": true,
            "fontStrikeout": true,
            "fontUnderline": true
        },
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]",
            "pages": "1",
            "text": "Joan B."
        },
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_06[0]",
            "pages": "1",
            "text": "Doe"
        },
        {
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_07[0]",
            "pages": "1",
            "text": "987654321"
        }     



    ],
    "annotations":[
        {
            "text":"Sample Filled with PDF.co API using /pdf/edit/add. Get fields from forms using /pdf/info/fields. This text is be added on the first (0) and the last (!0) pages.",
            "x": 400,
            "y": 10,
            "width": 200,
            "height": 500,
            "size": 12,            
            "pages": "0-",
            "color": "FF0000",
            "link": "https://pdf.co"
        }
    ],    
    "images": [
        {                             
            "pages": "!0", 
            "x": 100, 
            "y": 374,
            "width": 100, 
            "url": "data:image/png;base64,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"
        }
    ]
}'

[POST] /pdf/edit/add (fill pdf form with simplified params)

You can add fill pdf fields in existing PDF PDF forms. This method uses a simplified version of /pdf/edit/add.

• url required. URL to the source file. Supports links from Google Drive, Dropbox and from built-in PDF.co files storage.
  
  For uploading files via API please check Files Upload section.
  
  If you are randomly getting Too Many Requests or Access Denied error for your input url, please try to add cache: to enable built-in url caching.
  
  You can also encrypt data for output files and decrypt data input files with user-controlled data encryption (uses strong AES encryption with your own keys). Click here to learn more.
• httpusername optional - http auth user name if required to access source url.
• httppassword optional - http auth password if required to access source url.
• fieldsString optional. Set values for fillable fields inside pdf forms. Use the following format page;fieldName;value.

Example: 0;editbox1;text is here.

Also, advanced format can be used to override font name, size and style:
0;fieldName;Field Text;12+bold+italic+underline+strikeout;FontName

Check the font list for all supported fonts.

Filling checkbox: for unchecked state please use false, no, not, none, unchecked or 0 . To put a checkmark use X, true or anything else.

Example: 0;checkbox1;true or 0;checkbox1;X

For multiple objects, use | separator.

To find names of all fillable fields in PDF file please use /pdf/info/fields endpoint or interactive PDF.co Request Tester

• annotationsString optional. Add one or more text objects on top of pdf. Each text object to be added can be described as x;y;pages;text;fontsize;fontname;fontcolor;link;transparent. Sample: 20;20;0-;Testing Text;24;Arial;FF0000;www.pdf.co;false. To separate multiple objects, use | separator.
  where 24 is the font size. You can also add styles intoto the font size using the following modifiers:
  • +bold for bold style
  • +italic for italic style
  • +underline for underline style
  • +strikeout for strikeout style

Check the font list for all supported fonts.

For example, for font size 24 and bold, italic, underline and strikeout styles:

250;20;0-;PDF form filled with PDF.co API;24+bold+italic+underline+strikeout;Arial;FF0000;www.pdf.co;true

If you need to insert a line break then use \n or {{$$newLine}}.

You can also use built-in macros like {{$$PageNumber}} and custom data macros. Check this knowledgebase article for more details on macros.

• imagesString optional. Adds one or more images or pdfs on top of pdf. Each image or pdf object can be defined as x;y;pages;urltoimageOrPdf;linkToOpen;width;height
  for example: 20;80;0-;bytescout-com.s3-us-west-2.amazonaws.com/files/demo-files/cloud-api/pdf-edit/logo.png;www.pdf.co;200;200. To separate multiple objects, use | separator.
• password optional. Password of PDF file. Must be a String.
• async optional. Runs processing asynchronously. Returns JobId that you may use with /job/check to check state of the background job (possible states: working, failed, aborted and success). Must be one of: true, false.
• *Important**: Also set inline param to true to get direct link to final output pdf in both sync and async modes. Otherwise, you will be getting direct link to pdf in sync mode but also link to .json file in the async mode.
• inline optional. Set to true to get direct link to output pdf in async mode (otherwise you will get link to json with url inside when you use async mode).
• name optional. File name for generated output. Must be a String.
• expiration optional. Output link expiration in minutes. Default is 60 (i.e. 60 minutes or 1 hour). After this delay generated output file(s) (if any) will be auto-removed from PDF.co temporary files storage. Max allowed expiration period depends on your current subscription plan. To store permanent input files (e.g. re-usable images, pdf, documents), please use PDF.co built-in Files Storage instead.
• async optional. Runs processing asynchronously. Returns JobId that you may use with /job/check to check state of the background job (possible states: working, failed, aborted and success). Must be one of: true, false.
• profiles optional. Must be a String. You can set additional and extra options using this parameter that allows you to set custom configuration.

For example, to flatten pdf form, set profiles to this value:

{ 'FlattenDocument()': [] }

See profiles samples for examples.

• templateData optional. Set JSON as escaped string for use as custom macros. See[this knowledgebase article[(https://apidocs.pdf.co/kb/Fill%20PDF%20and%20Add%20Text%20or%20Images%20(pdf-edit-add)/macros#custom-macros) for more details.

• Method: POST
• URL: /v1/pdf/edit/add

Query parameters

No query parameters accepted.

Body payload

{
    "async": false,
    "encrypt": false,
    "inline": true,
    "name": "f1040-form-filled",
    "url": "https://bytescout-com.s3-us-west-2.amazonaws.com/files/demo-files/cloud-api/pdf-form/f1040.pdf",
    "fieldsString": "1;topmostSubform[0].Page1[0].f1_02[0];John A. Doe|1;topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1];true|1;topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_04[0];123456789"
}

Example responses

JSON simplified /pdf/edit/add

{
    "url": "https://pdf-temp-files.s3.amazonaws.com/03c5c55183c74f8d94a4ec952e4e32ad/f1040-form-filled.pdf",
    "pageCount": 3,
    "error": false,
    "status": 200,
    "name": "f1040-form-filled",
    "remainingCredits": 60822
}

Code Snippet

CURL

curl --location --request POST 'https://api.pdf.co/v1/pdf/edit/add' \
--header 'Content-Type: application/json' \
--header 'x-api-key: ' \
--data-raw '{
    "async": false,
    "encrypt": false,
    "inline": true,
    "name": "f1040-form-filled",
    "url": "https://bytescout-com.s3-us-west-2.amazonaws.com/files/demo-files/cloud-api/pdf-form/f1040.pdf",
    "fieldsString": "1;topmostSubform[0].Page1[0].f1_02[0];John A. Doe|1;topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1];true|1;topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_04[0];123456789"
}'

Samples

• AWS Lambda - Fill PDF Forms NodeJs
• AWS Lambda - Fill PDF Forms Simplified NodeJs
• C# - Fill PDF Forms
• C# - Fill PDF Forms Asynchronously
• C# - Fill PDF Forms Simplified
• C# - Fill PDF Forms Simplified Asynchronously
• Java - Fill PDF Forms
• Java - Fill PDF Forms Simplified
• JavaScript - Fill PDF Forms
• JavaScript - Fill PDF Forms Simplified
• PHP - Fill PDF Forms
• PHP - Fill PDF Forms Simplified
• PHP - Fill PDF Forms from Local File
• PHP - Fill PDF Forms from Local File Asynchronously
• PHP - Fill PDF Forms from Uploaded File
• PHP - Fill PDF Forms from Uploaded File Asynchronously
• PowerShell - Fill PDF Forms
• PowerShell - Fill PDF Forms Simplified
• Python - Fill PDF Forms
• Python - Fill PDF Forms Simplified
• Salesforce - Fill PDF Form
• VB.NET - Fill PDF Forms
• VB.NET - Fill PDF Forms Simplified
• cURL - Fill PDF Forms
• cURL - Fill PDF Forms Simplified