Link Search Menu Expand Document

PDF Fill PDF Forms

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

Go To Samples

[POST] /pdf/edit/add

Add text, images, signatures, 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 image or pdf for re-use as a template please use 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 as 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.
  • httpusername (optinal) - http auth user name if required to access source url.
  • httppassword (optinal) - 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 - text string to add
  • 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.
  • 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 as http link, filetoken or datauri:.. url (with base64 encoded image).
  • 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.

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 radioboxes and dropdowns 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 Use JobId that you may use with /job/check to check 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).

  • encrypt optional. Enable encryption for output file. Must be one of: true, false.

  • 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.

  • profiles optional. Must be a String. You can set additional and extra options using this parameter that allows you to set custom configuration. See profiles samples for examples.

EXAMPLE to flatten pdf form (i.e. to turn all fillable fields into read-only), just the profiles parameter to this value: { 'FlattenDocument()': [] }

Description

  • 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": [
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1]",
            "pages": "1", // 2nd page
            "text": "True" // enable checkbox 
        },
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].f1_02[0]",
            "pages": "1", // 2nd page
            "text": "John A."
        },        
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].f1_03[0]",
            "pages": "1", // 2nd page
            "text": "Doe"
        },        
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_04[0]",
            "pages": "1",
            "text": "123456789"
        },
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]",
            "pages": "1",            
            "text": "Joan B.",
            // optional parameters to set font parameters
            "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": [
        {                             
            // the signature image was made using https://app.pdf.co/make-signature#
            "pages": "!0", // the very last page only
            "x": 100, // get this coordinates using https://pdflite.co/simplified-pdf-viewer/index.html
            "y": 374,
            "width": 100, // limit the width
            "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": [
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1]",
            "pages": "1", // 2nd page
            "text": "True" // enable checkbox 
        },
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].f1_02[0]",
            "pages": "1", // 2nd page
            "text": "John A."
        },        
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].f1_03[0]",
            "pages": "1", // 2nd page
            "text": "Doe"
        },        
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_04[0]",
            "pages": "1",
            "text": "123456789"
        },
        {
            // extract all field names at https://app.pdf.co/pdf-info
            "fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]",
            "pages": "1",            
            "text": "Joan B.",
            // optional parameters to set font parameters
            "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": [
        {                             
            // the signature image was made using https://app.pdf.co/make-signature#
            "pages": "!0", // the very last page only
            "x": 100, // get this coordinates using https://pdflite.co/simplified-pdf-viewer/index.html
            "y": 374,
            "width": 100, // limit the width
            "url": "data:image/png;base64,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"
        }
    ]
}'

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

You can add fill pdf fields in existing PDF PDF forms. This method uses 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.
  • httpusername (optinal) - http auth user name if required to access source url.
  • httppassword (optinal) - 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 get the list of all fillable fields in PDF form please use /pdf/info/fields endpoint or helper tools at https://app.pdf.co/

  • 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
  • imagesString optional. Adds one or more images on top of pdf. Each image object can be defined as x;y;pages;urltoimage;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 Use JobId that you may use with /job/check to check 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).

  • encrypt optional. Enable encryption for output file. Must be one of: true, false.

  • 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.

  • profiles optional. Must be a String. You can set additional and extra options using this parameter that allows you to set custom configuration. See profiles samples for examples.

Description

  • 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