Link Search Menu Expand Document

PDF Fill PDF Forms

Explore Samples

PDF filler for fillable PDF forms using PDF.co.

To find form fields please use PDF.co PDF Edit Add Helper.

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)

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.

Use PDF.co PDF Edit Add Helper to get or measure pdf 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.

Attributes
url required
URL to the source file. Supports links from Google Drive, Dropbox, and PDF.co built-in files storage. To upload files via API, Check out the Files Upload section.

Note: If you experience intermittent Too Many Requests or Access Denied errors, please try to add cache: to enable built-in URL caching. (e.g cache:https://example.com/file1.pdf)

For data security, you have the option to encrypt output files and decrypt input files. Learn more about user-controlled data encryption.
httpusername optional
HTTP auth user name if required to access source url.
httppassword optional
HTTP auth password if required to access source url.
annotations[] optional
The array of objects, 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").
Attributes 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 Use PDF.co PDF Edit Add Helper to get or measure pdf coordinates.
y
Y coordinate Use PDF.co PDF Edit Add Helper to get or measure pdf coordinates.
width optional
Width of the text box Use PDF.co PDF Edit Add Helper to get or measure pdf coordinates.
height optional
Height of the text box Use PDF.co PDF Edit Add Helper to get or measure pdf coordinates.
alignment optional, default is left.
Sets text alignment within the width of the text box. Valid values: left, center, right.
pages optional
Comma-separated indices of pages (or page ranges) that you want to use.
The first-page index is always 0, For example, if you have a 7-page document that you want to be split into 3 separate PDFs but a 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”, and “!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, The input must be in string format.
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 underlined 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 URLs or from URLs for internal file storage.
Attributes for Images objects
url required
URL to image or pdf as HTTP link, file token or datauri:.. URL (with base64 encoded image or pdf).
x
X coordinate Use PDF.co PDF Edit Add Helper to get or measure pdf coordinates.
y
Y coordinate Use PDF.co PDF Edit Add Helper to get or measure pdf coordinates.
width optional
Width of the text box Use PDF.co PDF Edit Add Helper to get or measure pdf coordinates.
height optional
Height of the text box Use PDF.co PDF Edit Add Helper to get or measure pdf coordinates.
pages optional
Comma-separated indices of pages (or page ranges) that you want to use.
The first-page Index is always 0. For example, if you have a 7 page document that you want to be split into 3 separate PDFs but a 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”, and “!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, The input must be in string format.
link optional
Link to open on click.
keepAspectRatio optional, true by default.
Set to false if don’t need to keep the aspect ratio for the image/pdf added. In this case, it will use the 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.
Attributes for Fields objects
fieldName
Name of the form field. To find form fields please use PDF.co PDF Edit Add Helper
pages optional
Page index where this form field appears.
text
Value to set for this field.
If you have a checkbox, set X, true, 1, or another text which is different from false to enable the checkbox. For radio buttons and combo boxes, you need to set the index of the item to select. To find form fields please use PDF.co PDF Edit Add Helper
fontName optional
Name of the font to use to fill out the input field. Check the font list for all supported fonts.
size optional
Override the font size of the text inside the given input field.
fontBold optional
Override font bold style of the text input field.
fontItalic optional
Override font italic style of the text input field.
fontStrikeout optional
Override font strikeout style of the text input field.
fontUnderline optional
Override font underline style of the 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 Attributes
password optional
Password of PDF file, The input must be in string format.
async optional
Set async to true for long processes to run in the background, API will then return a jobId which you can use with /job/check endpoint to check the status of the process and retrieve the output while you can proceed with other tasks without waiting for this process to finish.
IMPORTANT: Also set the inline param to true to get a direct link to the final output pdf in both sync and async modes. Otherwise, you will be getting a direct link to pdf in sync mode but also a link to the .json file in the async mode.
inline optional
Set to true to get a direct link to output pdf in async mode (otherwise you will get a link to JSON with URL inside when you use async mode).
name optional
File name for the generated output. Must be a String.
expiration optional
Set the expiration time for the output link in minutes (default is 60 i.e 60 minutes or 1 hour), After this specified duration, any generated output file(s) will be automatically deleted from PDF.co temporary files storage. The maximum duration for link expiration varies based on your current subscription plan. Learn more

To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using PDF.co built-in Files Storage.
profiles optional
You can set additional and extra options using this parameter that allows you to set custom configurations, The input must be in string format.

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

{ 'FlattenDocument()': [] }

See profiles samples for examples.

**Attributes **
templateData optional
Set JSON as an escaped string for use as custom macros. Seethis knowledgebase article for more details.
  • Method: POST
  • URL: /v1/pdf/edit/add

Query parameters

No query parameters accepted.

Body payload

{
    "async": false,
    "inline": true,
    "name": "f1040-filled",
    "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/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,
    "inline": true,
    "name": "f1040-filled",
    "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/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.

Attributes
url required
URL to the source file. Supports links from Google Drive, Dropbox, and PDF.co built-in files storage. To upload files via API, Check out the Files Upload section.

Note: If you experience intermittent Too Many Requests or Access Denied errors, please try to add cache: to enable built-in URL caching. (e.g cache:https://example.com/file1.pdf)

For data security, you have the option to encrypt output files and decrypt input files. Learn more about user-controlled data encryption.
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. An 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 a PDF file please use the /pdf/info/fields endpoint or interactive PDF.co Request Tester
annotationsString optional
Add one or more text objects on top of the 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 to the font size using the following modifiers:
+bold optional
Bold style.
+italic optional
Italic style.
+underline optional
underline style
+strikeout optional
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 the PDF. Each image or pdf object can be defined as
x;y;pages;urltoimageOrPdf;linkToOpen;width;height

For example:
20;80;0-;pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png;www.pdf.co;200;200.
To separate multiple objects, use \| separator.
password optional
Password of PDF file, The input must be in string format.
async optional
Set async to true for long processes to run in the background, API will then return a jobId which you can use with /job/check endpoint to check the status of the process and retrieve the output while you can proceed with other tasks without waiting for this process to finish.
Important: Also set the inline param to true to get a direct link to the final output pdf in both sync and async modes. Otherwise, you will be getting a direct link to pdf in sync mode but also a link to the .json file in the async mode.
inline optional
Set to true to get a direct link to output pdf in async mode (otherwise you will get a link to JSON with URL inside when you use async mode).
name optional
File name for the generated output. Must be a String.
expiration optional
Set the expiration time for the output link in minutes (default is 60 i.e 60 minutes or 1 hour), After this specified duration, any generated output file(s) will be automatically deleted from PDF.co temporary files storage. The maximum duration for link expiration varies based on your current subscription plan. Learn more

To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using PDF.co built-in Files Storage.
templateData optional
Set JSON as an 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.
profiles optional
You can set additional and extra options using this parameter that allows you to set custom configurations, The input must be in string format.

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

{ 'FlattenDocument()': [] }

See profiles samples for examples.

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

Query parameters

No query parameters accepted.

Body payload

{
    "async": false,
    "inline": true,
    "name": "f1040-form-filled",
    "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/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,
    "inline": true,
    "name": "f1040-form-filled",
    "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/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