{
"info": {
"_postman_id": "b7b325b9-55af-4578-bf39-98a5458bed86",
"name": "PDF.co API v.1.00",
"description": "*NOTE: This documentation applies to both PDF.co and the on-prem version called ByteScout API Server. Remarks in the documentation highlighting a difference if any.* \n\nPlease check [https://apidocs.pdf.co/index](https://apidocs.pdf.co/index) for the introduction and the table of contents.",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
"_exporter_id": "30844964"
},
"item": [
{
"name": "01. Document Parser",
"item": [
{
"name": "/pdf/documentparser (output as JSON)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf\",\n \"outputFormat\": \"JSON\",\n \"templateId\": \"1\",\n \"async\": false,\n \"inline\": \"true\",\n \"password\": \"\",\n \"profiles\": \"\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/documentparser",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"documentparser"
]
},
"description": "**Description:** This API method extracts data from documents based on a document parser extraction template. With this API method, you can extract data from custom areas by searching form fields, tables, multiple pages, and more!\n\n**Tools and Guides**:\n\n- [Document Parser Template Editor (online version)](https://app.pdf.co/document-parser/templates)\n- [Document Parser Template Coding Guide](https://apidocs.pdf.co/kb/Document%20Parser%20(document-parser)/document-parser-template-guide)\n \n**See Also**\n\n- [PDF Classifier](https://apidocs.pdf.co/01-1-document-classifier)\n- [PDF Classifier Guide](https://apidocs.pdf.co/kb/Document%20Parser%20(document-parser)/document-parser-template-guide)\n \n**Attributes**\n\nHint: attributes should be inside JSON for POST request:\n\n```\n{\n \"url\": \"url-input-link\"\n}\n\n```\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url` |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **templateId** required Set ID of document parser template to be used. View and manage your templates at [https://app.pdf.co/document-parser](https://app.pdf.co/document-parser) |\n| **template** optional You can pass the code of the document parser template to be used directly. |\n| **inline** optional Set to `true` to return results inside the response. Otherwise, the endpoint will return a link to the output file generated. |\n| **outputFormat** optional Default is `JSON`. You can override the default output format to `CSV` or `XML` to generate CSV or XML output accordingly. |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url` |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **templateId** required Sets Id of document parser template to be used. View and manage your templates at [https://app.pdf.co/document-parser](https://app.pdf.co/document-parser) |\n| **template** optional You can pass the code of the document parser template to be used directly. |\n| **inline** optional Set to `true` to return results inside the response. Otherwise, the endpoint will return a link to the output file generated. |\n| **outputFormat** optional Default is `JSON`. You can override the default output format to `CSV` or `XML` to generate CSV or XML output accordingly. |\n| **password** optional Password of PDF file. The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url` |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **templateId** required Sets Id of document parser template to be used. View and manage your templates at [https://app.pdf.co/document-parser](https://app.pdf.co/document-parser) |\n| **template** optional You can pass the code of the document parser template to be used directly. |\n| **inline** optional Set to `true` to return results inside the response. Otherwise, the endpoint will return a link to the output file generated. |\n| **outputFormat** optional Default is `JSON`. You can override the default output format to `CSV` or `XML` to generate CSV or XML output accordingly. |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/documentparser (output as CSV)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf\",\n \"templateId\": \"1\",\n \"outputFormat\": \"CSV\",\n \"generateCsvHeaders\": true,\n\n \"async\": false,\n \"inline\": \"true\",\n \"password\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/documentparser",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"documentparser"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"c935a430f3b65bc2bfeba21a1dda722a\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "ba96370e-a0b9-4b45-9c40-2e7bc16c1f8f"
},
{
"key": "X-Runtime",
"value": "0.409133"
},
{
"key": "Date",
"value": "Fri, 21 Aug 2020 19:22:58 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": \"companyName,companyName2,invoiceId,dateIssued,dateDue,bankAccount,total,subTotal,tax,tableNames,tables\\r\\n\\\"Amazon Web Services, Inc\\\",\\\"Amazon Web Services, Inc\\\",123456789,2018-04-03T00:00:00,2018-04-03T00:00:00,123456789012,6.58,,1.01,table,\\r\\n\\r\\n\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample-invoice.csv\",\n \"remainingCredits\": 60804\n}"
}
]
},
{
"name": "/pdf/documentparser (output as JSON, custom template code)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/MultiPageTable.pdf\",\n \"template\": \"{\\r\\n \\\"templateVersion\\\": 3,\\r\\n \\\"templatePriority\\\": 0,\\r\\n \\\"sourceId\\\": \\\"Multipage Table Test\\\",\\r\\n \\\"detectionRules\\\": {\\r\\n \\\"keywords\\\": [\\r\\n \\\"Sample document with multi-page table\\\"\\r\\n ]\\r\\n },\\r\\n \\\"fields\\\": {\\r\\n \\\"total\\\": {\\r\\n \\\"type\\\": \\\"regex\\\",\\r\\n \\\"expression\\\": \\\"TOTAL {{DECIMAL}}\\\",\\r\\n \\\"dataType\\\": \\\"decimal\\\"\\r\\n }\\r\\n },\\r\\n \\\"tables\\\": [\\r\\n {\\r\\n \\\"name\\\": \\\"table1\\\",\\r\\n \\\"start\\\": {\\r\\n \\\"expression\\\": \\\"Item\\\\\\\\s+Description\\\\\\\\s+Price\\\\\\\\s+Qty\\\\\\\\s+Extended Price\\\"\\r\\n },\\r\\n \\\"end\\\": {\\r\\n \\\"expression\\\": \\\"TOTAL\\\\\\\\s+\\\\\\\\d+\\\\\\\\.\\\\\\\\d\\\\\\\\d\\\"\\r\\n },\\r\\n \\\"row\\\": {\\r\\n \\\"expression\\\": \\\"^\\\\\\\\s*(?\\\\\\\\d+)\\\\\\\\s+(?.+?)\\\\\\\\s+(?\\\\\\\\d+\\\\\\\\.\\\\\\\\d\\\\\\\\d)\\\\\\\\s+(?\\\\\\\\d+)\\\\\\\\s+(?\\\\\\\\d+\\\\\\\\.\\\\\\\\d\\\\\\\\d)\\\"\\r\\n },\\r\\n \\\"columns\\\": [\\r\\n {\\r\\n \\\"name\\\": \\\"itemNo\\\",\\r\\n \\\"type\\\": \\\"integer\\\"\\r\\n },\\r\\n {\\r\\n \\\"name\\\": \\\"description\\\",\\r\\n \\\"type\\\": \\\"string\\\"\\r\\n },\\r\\n {\\r\\n \\\"name\\\": \\\"price\\\",\\r\\n \\\"type\\\": \\\"decimal\\\"\\r\\n },\\r\\n {\\r\\n \\\"name\\\": \\\"qty\\\",\\r\\n \\\"type\\\": \\\"integer\\\"\\r\\n },\\r\\n {\\r\\n \\\"name\\\": \\\"extPrice\\\",\\r\\n \\\"type\\\": \\\"decimal\\\"\\r\\n }\\r\\n ],\\r\\n \\\"multipage\\\": true\\r\\n }\\r\\n ]\\r\\n}\",\n \"outputFormat\": \"JSON\",\n \"async\": false,\n \"inline\": \"true\",\n \"profiles\": \"\",\n \"password\": \"\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/documentparser",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"documentparser"
]
},
"description": "**Description:** Parses and gets data from documents using previously prepared custom data extraction templates. With this API method, you may extract data from custom areas by searching, form fields, tables, multiple pages, and more!\n\n**Tools and Guides**:\n\n- [Document Parser Template Editor (online version)](https://app.pdf.co/document-parser/templates)\n- [Document Parser Template Coding Guide](https://apidocs.pdf.co/kb/Document%20Parser%20(document-parser)/document-parser-template-guide)\n \n**See Also**\n\n- [PDF Classifier](https://apidocs.pdf.co/01-1-document-classifier)\n- [PDF Classifier Guide](https://apidocs.pdf.co/kb/Document%20Parser%20(document-parser)/document-parser-template-guide)\n \n**Attributes**\n\nHint: attributes should be inside JSON for POST request:\n\n```\n{\n \"url\": \"url-input-link\"\n}\n\n```\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url` |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **templateId** required Sets Id of document parser template to be used. View and manage your templates at [https://app.pdf.co/document-parser](https://app.pdf.co/document-parser) |\n| **template** optional You can pass the code of the document parser template to be used directly. |\n| **inline** optional Set to `true` to return results inside the response. Otherwise, endpoint will return a link to the output file generated. |\n| **outputFormat** optional Default is `JSON`. You can override the default output format to `CSV` or `XML` to generate CSV or XML output accordingly. |\n| **password** optional Password of PDF file. Must be a String |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "POST /pdf/documentparser",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/MultiPageTable.pdf\",\r\n \"template\": \"{\\r\\n \\\"templateVersion\\\": 3,\\r\\n \\\"templatePriority\\\": 0,\\r\\n \\\"sourceId\\\": \\\"Multipage Table Test\\\",\\r\\n \\\"detectionRules\\\": {\\r\\n \\\"keywords\\\": [\\r\\n \\\"Sample document with multi-page table\\\"\\r\\n ]\\r\\n },\\r\\n \\\"fields\\\": {\\r\\n \\\"total\\\": {\\r\\n \\\"type\\\": \\\"regex\\\",\\r\\n \\\"expression\\\": \\\"TOTAL {{DECIMAL}}\\\",\\r\\n \\\"dataType\\\": \\\"decimal\\\"\\r\\n }\\r\\n },\\r\\n \\\"tables\\\": [\\r\\n {\\r\\n \\\"name\\\": \\\"table1\\\",\\r\\n \\\"start\\\": {\\r\\n \\\"expression\\\": \\\"Item\\\\\\\\s+Description\\\\\\\\s+Price\\\\\\\\s+Qty\\\\\\\\s+Extended Price\\\"\\r\\n },\\r\\n \\\"end\\\": {\\r\\n \\\"expression\\\": \\\"TOTAL\\\\\\\\s+\\\\\\\\d+\\\\\\\\.\\\\\\\\d\\\\\\\\d\\\"\\r\\n },\\r\\n \\\"row\\\": {\\r\\n \\\"expression\\\": \\\"^\\\\\\\\s*(?\\\\\\\\d+)\\\\\\\\s+(?.+?)\\\\\\\\s+(?\\\\\\\\d+\\\\\\\\.\\\\\\\\d\\\\\\\\d)\\\\\\\\s+(?\\\\\\\\d+)\\\\\\\\s+(?\\\\\\\\d+\\\\\\\\.\\\\\\\\d\\\\\\\\d)\\\"\\r\\n },\\r\\n \\\"columns\\\": [\\r\\n {\\r\\n \\\"name\\\": \\\"itemNo\\\",\\r\\n \\\"type\\\": \\\"integer\\\"\\r\\n },\\r\\n {\\r\\n \\\"name\\\": \\\"description\\\",\\r\\n \\\"type\\\": \\\"string\\\"\\r\\n },\\r\\n {\\r\\n \\\"name\\\": \\\"price\\\",\\r\\n \\\"type\\\": \\\"decimal\\\"\\r\\n },\\r\\n {\\r\\n \\\"name\\\": \\\"qty\\\",\\r\\n \\\"type\\\": \\\"integer\\\"\\r\\n },\\r\\n {\\r\\n \\\"name\\\": \\\"extPrice\\\",\\r\\n \\\"type\\\": \\\"decimal\\\"\\r\\n }\\r\\n ],\\r\\n \\\"multipage\\\": true\\r\\n }\\r\\n ]\\r\\n}\",\r\n \"outputFormat\": \"JSON\",\r\n \"async\": false,\r\n \r\n \"inline\": \"true\",\r\n \"profiles\": \"\",\r\n \"password\": \"\",\r\n \"storeResult\": false\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/documentparser",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"documentparser"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"37755c928943f624a154db6bd33efc5c\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "1fd8b465-893a-4aab-bbd8-ca704573675b"
},
{
"key": "X-Runtime",
"value": "1.365985"
},
{
"key": "Date",
"value": "Thu, 16 Jul 2020 22:04:26 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": {\n \"objects\": [\n {\n \"name\": \"companyName\",\n \"objectType\": \"field\",\n \"value\": \"Amazon Web Services, Inc\",\n \"rectangle\": [\n 0,\n 0,\n 0,\n 0\n ]\n },\n {\n \"name\": \"companyName2\",\n \"objectType\": \"field\",\n \"value\": \"Amazon Web Services, Inc\",\n \"rectangle\": [\n 0,\n 0,\n 0,\n 0\n ]\n },\n {\n \"name\": \"invoiceId\",\n \"objectType\": \"field\",\n \"value\": \"123456789\",\n \"pageIndex\": 0,\n \"rectangle\": [\n 0,\n 0,\n 0,\n 0\n ]\n },\n {\n \"name\": \"dateIssued\",\n \"objectType\": \"field\",\n \"value\": \"2018-04-03T00:00:00\",\n \"pageIndex\": 0,\n \"rectangle\": [\n 0,\n 0,\n 0,\n 0\n ]\n },\n {\n \"name\": \"dateDue\",\n \"objectType\": \"field\",\n \"value\": \"2018-04-03T00:00:00\",\n \"pageIndex\": 0,\n \"rectangle\": [\n 0,\n 0,\n 0,\n 0\n ]\n },\n {\n \"name\": \"total\",\n \"objectType\": \"field\",\n \"value\": 6.58,\n \"pageIndex\": 0,\n \"rectangle\": [\n 0,\n 0,\n 0,\n 0\n ]\n },\n {\n \"name\": \"subTotal\",\n \"objectType\": \"field\",\n \"value\": \"\"\n },\n {\n \"name\": \"tax\",\n \"objectType\": \"field\",\n \"value\": 1.01,\n \"pageIndex\": 0,\n \"rectangle\": [\n 0,\n 0,\n 0,\n 0\n ]\n },\n {\n \"objectType\": \"table\",\n \"name\": \"table\",\n \"rows\": []\n }\n ],\n \"templateName\": \"Generic Invoice [en]\",\n \"templateVersion\": \"4\",\n \"timestamp\": \"2020-07-16T22:04:25\"\n },\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample-invoice.json\",\n \"remainingCredits\": 77731\n}"
}
]
},
{
"name": "/pdf/documentparser/templates",
"request": {
"method": "GET",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"url": {
"raw": "https://api.pdf.co/v1/pdf/documentparser/templates",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"documentparser",
"templates"
]
},
"description": "Return all Document Parser data extraction templates for the current user. Please use the `GET` request.\n\n\nManage your Document Parser templates at [https://app.pdf.co/document-parser/templates](https://app.pdf.co/document-parser/templates)"
},
"response": [
{
"name": "pdf/documentparser/templates",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"url": {
"raw": "https://api.pdf.co/v1/pdf/documentparser/templates",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"documentparser",
"templates"
]
}
},
"_postman_previewlanguage": "json",
"header": [],
"cookie": [],
"body": "{\n \"templates\": [\n {\n \"id\": 40,\n \"type\": \"user\",\n \"title\": \"Untitled\",\n \"description\": \"Untitled\"\n },\n {\n \"id\": 1,\n \"type\": \"system\",\n \"title\": \"Invoice Parser\",\n \"description\": \"Parses invoices and extracts invoice number, company name, due date, amount, tax\"\n }\n ],\n \"remainingCredits\": 94229\n}"
}
]
},
{
"name": "/pdf/documentparser/templates/:id",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "GET",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": ""
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/documentparser/templates/:id",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"documentparser",
"templates",
":id"
],
"variable": [
{
"key": "id",
"value": "1"
}
]
},
"description": "Returns detailed information for document parser template by template’s id. Please use the `GET` request.\n\n\nManage your Document Parser templates at [https://app.pdf.co/document-parser/templates](https://app.pdf.co/document-parser/templates)"
},
"response": []
}
],
"description": "Document Parser can automatically parse PDF, JPG, and PNG documents to extract fields, tables, values, and barcodes from invoices, statements, orders, and other PDF and scanned documents.\n\n**Built-in document parser templates**:\n\n* `General Invoice Template` can parse invoices (English only) to invoice id, invoice date, extract total, tax, and line items. Set the `templateId` parameter to `1` to use this template.\n \n**How to classify incoming documents before parsing them?**\n\nUse the `/pdf/classifier` endpoint (see below) to automatically sort/detect the class of the document based on AI or on custom keywords-based rules.\n\nFor example, you can easily define rules to find which vendor provided the document to find which template to apply accordingly. See [Document Classifier](/01-1-document-classifier) for more details.\n\n**Additional Information and Tools**\n\n* [Document Parser Template Editor](https://app.pdf.co/document-parser/templates) (or check a standalone version [here](https://editor.pdf.co))\n* [Document Parser Template Objects Guide](https://apidocs.pdf.co/kb/Document%20Parser%20(document-parser)/document-parser-template-guide)",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "01.1. Document Classifier",
"item": [
{
"name": "/pdf/classifier",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf\",\n \"async\": false,\n \"inline\": \"true\",\n \"password\": \"\",\n \"profiles\": \"\"\n} "
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/classifier",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"classifier"
]
},
"description": "**Description:** Document Classifier can automatically find *class* of input PDF, JPG, PNG document by analyzing its content using the built-in AI or custom defined classification rules. \n\n**IMPORTANT**: the best way to **develop**, **test** and **maintain** classification rules is to use `Classifier Tester Tool` from [PDF.co Document Classifier UI](https://app.pdf.co/document-classifier), you can download it from [this page](https://bytescout.com/download/download_freeware.html). Use this tool to quickly edit and test rules on single PDFs and on folders.\n\n**Tools and Guides**\n\n* [Document Classifier Guide](https://apidocs.pdf.co/kb/Document%20Parser%20(document-parser)/document-parser-template-guide)\n* [Document Classifier App](https://app.pdf.co/document-classifier) \n\n**See Also**:\n\n* [Document Parser Template Editor (online version)](https://app.pdf.co/document-parser/templates)\n* [Document Parser Template Coding Guide](https://apidocs.pdf.co/kb/Document%20Parser%20(document-parser)/document-parser-template-guide)\n \n**Attributes**\n\nHint: attributes should be inside JSON for `POST` request:\n\n```\n{\n \"url\": \"url-input-link\"\n}\n\n```\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n|**httpusername** optional HTTP auth user name if required to access source `url`.|\n|**httppassword** optional HTTP auth password if required to access source `url`.|\n|**rulescsv** optional Define custom classification rules in CSV format. Rules are in CSV format where each row contains: `class name`, `logic` (`AND` or `OR` (default)), and keywords separated by a comma. Each row is separated by the `\\n` symbol. You can use regular expressions for keywords with this syntax: `/keyword or regexp/i` where `i` is the case-insensitive flag. Please note that all `\\` symbols should add the prefix `\\` because of JSON format, so `\\d` becomes `\\\\d` and so on.
**Custom Rules Example 1** for `rulescsv` (for more examples please check [the classifier guide](https://apidocs.pdf.co/kb/Document%20Parser%20(document-parser)/document-parser-template-guide))
Amazon AWS, OR, Amazon Web Services Invoice, Amazon CloudFront\\nDigital Ocean, OR,DigitalOcean, DOInvoice\\nACME,OR, ACME Inc.,1540 Long Street
**Custom Rules Example 2** (with regular expressions, for more examples please check [the classifier guide](https://apidocs.pdf.co/kb/Document%20Parser%20(document-parser)/document-parser-template-guide))
Medical Report,AND,/Instructing Party|Medical Report|Date Of Injury|Med Agency Ref/i\\r\\nInjured Claimant,OR, Injured Claimant, Injured Patient ID|\n| **rulescsvurl** optional Instead of inline CSV you can use this parameter and set the URL to a CSV file with classification rules. This is useful if you have a separate developer working on CSV rules. Sample link to a Dropbox: `https://www.dropbox.com/s/12345abcdef/document_sorting_rules.csv?dl=0`
Sample content of `document_sorting_rules.csv` with `Medical Report` and `Injured Claimant` classes:
Medical Report,AND,/Instructing Party|Medical Report|Date Of Injury|Med Agency Ref/i\\r\\nInjured Claimant,OR,Injured Claimant,Injured Patient ID |\n| **caseSensitive** optional (default to `true`). Defines if keywords in rules are case-sensitive or not. |\n|**inline** optional Set to `true` to return results inside the response. Otherwise, the endpoint will return a link to the output file generated. |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** options File name for generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n|**profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/classifier",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/document-parser/sample-invoice.pdf\",\n \"async\": false,\n \"inline\": \"true\",\n \"password\": \"\",\n \"profiles\": \"\"\n} "
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/classifier",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"classifier"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"bc1e8c5d82ac530924b664cefb7f6586\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "ac74e970-61f4-4128-b585-4514223295ef"
},
{
"key": "X-Runtime",
"value": "0.372349"
},
{
"key": "Date",
"value": "Tue, 26 Apr 2022 14:08:08 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": {\n \"classes\": [\n {\n \"class\": \"invoice\"\n },\n {\n \"class\": \"finance\"\n },\n {\n \"class\": \"documents\"\n }\n ]\n },\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"credits\": 42,\n \"duration\": 353,\n \"remainingCredits\": 98019328\n}"
}
]
}
],
"description": "**Auto classification Of Incoming Documents**\n\nUse `/pdf/classifier` endpoint (see below) to automatically sort / detect the class of the document based on keywords-based rules. For example, you can define rules to find which vendor provided the document to find which template to apply accordingly.\n\n**Tip**\n\nTo quickly create and test classification rules, download and install [ByteScout PDF Multitool](https://bytescout.com/download/download_freeware.html). Run it and check `PDF Classifier` at the left sidebar. Test rules and export them as a JSON request for PDF.co PDF Classifier.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "01.5 Email Send and Decode",
"item": [
{
"name": "/email/send",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-info/sample.pdf\",\n \"from\": \"John Doe \",\n \"to\": \"Partner \",\n \"subject\": \"Check attached sample pdf\",\n \"bodytext\": \"Please check the attached pdf\",\n \"bodyHtml\": \"Please check the attached pdf\",\n \"smtpserver\": \"smtp.gmail.com\",\n \"smtpport\": \"587\",\n \"smtpusername\": \"my@gmail.com\", \n \"smtppassword\": \"app specific password created as https://support.google.com/accounts/answer/185833\",\n \"async\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/email/send",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"email",
"send"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **from** required The \"From\" field with sender name and email, e.g. `John Doe`. |\n| **to** required The \"To\" field with receiver name and email, e.g. `Partner`.\n| **subject** required subject for the outgoing email. |\n| **bodytext** plain text version of the outgoing email message. |\n| **bodyhtml** HTML version of the outgoing email message. |\n| **smtpserver** required SMTP server address. To learn how to setup SMTP details, please check [here](https://apidocs.pdf.co/kb/Email%20Send%20and%20Decode%20(email-send)/index) |\n| **smtpport** required SMTP port, To learn how to setup SMTP details, Please check [here](https://apidocs.pdf.co/kb/Email%20Send%20and%20Decode%20(email-send)/index) |\n| **smtpusername** required SMTP server username, To learn how to setup SMTP details, Please check [here](https://apidocs.pdf.co/kb/Email%20Send%20and%20Decode%20(email-send)/index) |\n| **smtppassword** required SMTP server password, If you use Gmail then you need to generate an app-specific password as instructed [here](https://support.google.com/accounts/answer/185833). To learn how to setup SMTP details, Please check [here](https://apidocs.pdf.co/kb/Email%20Send%20and%20Decode%20(email-send)/index) |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configuration for fine-tuning and extra options, Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/email/send",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/email-extractor/sample.eml\",\n \"inline\": true\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/email/send",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"email",
"send"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"32e911e3ee8114de30e2535ac46e09ac\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "9fee3e5d-6254-4671-8626-e46401a45df5"
},
{
"key": "X-Runtime",
"value": "0.486200"
},
{
"key": "Date",
"value": "Mon, 07 Sep 2020 13:37:00 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"error\": false,\n \"status\": 200,\n \"remainingCredits\": 60095\n}"
}
]
},
{
"name": "/email/decode",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/email-extractor/sample.eml\",\n \"inline\": true,\n \"async\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/email/decode",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"email",
"decode"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **inline** optional, `false` by default. with `async` mode enabled it returns `body` with the content of the output JSON (with the links to the output). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configuration for fine-tuning and extra options, Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/email/decode",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/email-extractor/sample.eml\",\n \"inline\": true\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/email/decode",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"email",
"decode"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"32e911e3ee8114de30e2535ac46e09ac\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "9fee3e5d-6254-4671-8626-e46401a45df5"
},
{
"key": "X-Runtime",
"value": "0.486200"
},
{
"key": "Date",
"value": "Mon, 07 Sep 2020 13:37:00 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": {\n \"from\": \"test@example.com\",\n \"fromName\": \"\",\n \"to\": [\n {\n \"address\": \"test2@example.com\",\n \"name\": \"\"\n }\n ],\n \"cc\": [],\n \"bcc\": [],\n \"sentAt\": null,\n \"receivedAt\": null,\n \"subject\": \"Test email with attachments\",\n \"bodyHtml\": null,\n \"bodyText\": \"Test Email Message with 2 PDF files as attachments\\r\\n\\r\\n\",\n \"attachmentCount\": 2\n },\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.json\",\n \"remainingCredits\": 60095\n}"
}
]
},
{
"name": "/email/extract-attachments",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/email-extractor/sample.eml\",\n \"inline\": true,\n \"async\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/email/extract-attachments",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"email",
"extract-attachments"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **inline** optional, `false` by default. In `async` mode it returns `body` with the content of the output JSON (with the links to the output). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options, Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "POST /email/extract-attachments",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/email-extractor/sample.eml\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/email/extract-attachments",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"email",
"extract-attachments"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"a66bdd80d58aaad0e48b16b0b3e79e27\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "1b7b5fe1-4266-4817-a6c2-19dc632a13bc"
},
{
"key": "X-Runtime",
"value": "3.417338"
},
{
"key": "Date",
"value": "Mon, 07 Sep 2020 13:37:56 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": {\n \"from\": \"test@example.com\",\n \"subject\": \"Test email with attachments\",\n \"bodyHtml\": null,\n \"bodyText\": \"Test Email Message with 2 PDF files as attachments\\r\\n\\r\\n\",\n \"attachments\": [\n {\n \"filename\": \"DigitalOcean.pdf\",\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/2943e6bb80e646ec92e839292e95d542/DigitalOcean.pdf\"\n },\n {\n \"filename\": \"sample.pdf\",\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/e10e37fbb438432a83ece50ccdc719b3/sample.pdf\"\n }\n ]\n },\n \"pageCount\": 2,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.json\",\n \"remainingCredits\": 60085\n}"
}
]
}
],
"description": "Functions to send email (with attachments), decode email, extract attachments from email.\n\nFor converting email to pdf please see \n[/pdf/convert/from/email](https://apidocs.pdf.co/27-pdf-from-email)",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "02. PDF Info Reader",
"item": [
{
"name": "/pdf/info",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "your api key for PDF.co API access. Get yours at https://app.pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-info/sample.pdf\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/info",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"info"
]
},
"description": "Extracts basic information about an input PDF file, PDF file security permissions, and other information. If you want to extract information about fillable fields (checkboxes, radioboxes, listboxes) from PDF then please use `/pdf/info/fields` instead.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source URL. |\n| **httppassword** optional HTTP auth password if required to access source URL. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configuration for fine-tuning and extra options, Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "POST /pdf/info",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "url",
"value": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-info/sample.pdf",
"description": "required. URL of the source PDF file. Must be a String. To use your file please upload it first to the temporary storage, see `Upload and Manage Files` section below to learn how to do it.",
"type": "text"
},
{
"key": "password",
"value": "",
"description": "optional. Password of PDF file. Must be a String.",
"type": "text"
}
],
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/info",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"info"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"bbe1a95edc7220c3da57d87f8df4c91a\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "3666156b-bf65-47a6-a941-1aaf43a2a81e"
},
{
"key": "X-Runtime",
"value": "0.386838"
},
{
"key": "Date",
"value": "Thu, 16 Jul 2020 09:33:04 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"info\": {\n \"PageCount\": 1,\n \"Author\": \"Alice V. Knox\",\n \"Title\": \"Kid's News 1\",\n \"Producer\": \"Acrobat Distiller 4.0 for Windows\",\n \"Subject\": \"Kid's News 1\",\n \"CreationDate\": \"8/15/2001 2:50:36 PM\",\n \"Bookmarks\": \"\",\n \"Keywords\": \"\",\n \"Creator\": \"Adobe PageMaker 6.52\",\n \"Encrypted\": false,\n \"PageRectangle\": {\n \"Location\": {\n \"IsEmpty\": true,\n \"X\": 0,\n \"Y\": 0\n },\n \"Size\": \"612, 792\",\n \"X\": 0,\n \"Y\": 0,\n \"Width\": 612,\n \"Height\": 792,\n \"Left\": 0,\n \"Top\": 0,\n \"Right\": 612,\n \"Bottom\": 792,\n \"IsEmpty\": false\n },\n \"ModificationDate\": \"9/20/2001 6:23:02 PM\",\n \"EncryptionAlgorithm\": 0,\n \"PermissionPrinting\": true,\n \"PermissionModifyDocument\": true,\n \"PermissionContentExtraction\": true,\n \"PermissionModifyAnnotations\": true,\n \"PermissionFillForms\": true,\n \"PermissionAccessibility\": true,\n \"PermissionAssemble\": true,\n \"PermissionHighQualityPrint\": true\n },\n \"error\": false,\n \"status\": 200,\n \"remainingCredits\": 77732\n}"
}
]
}
],
"description": "Get detailed information about the PDF document, it's properties and security permissions.\n\nFor one-time check of PDF file information and find form fields please use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper).",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "03.1 PDF Forms Info Reader",
"item": [
{
"name": "/pdf/info/fields",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-form/f1040.pdf\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/info/fields",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"info",
"fields"
]
},
"description": "Extracts information about fillable PDF fields (fillable edit boxes, fillable checkboxes, radio buttons, comboboxes) from input PDF file along with general information about the input PDF document. The purpose of this endpoint is to get information about fillable PDFs for use with PDF.co pdf filler `/pdf/edit/add` method\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) errors, please try to add `cache:` to enable built-in URL caching. (e.g `cache:https://example.com/file1.pdf`)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source URL. |\n| **httppassword** optional HTTP auth password if required to access source URL. |\n| **inline** optional `false` by default. In `async` mode makes to return `body` with the content of the output JSON (with the links to the output). To check the status of *async* job you should use the `job/check` endpoint to check the status of a job by its `jobId`. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/attachments/extract",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-attachments/attachments.pdf\",\n \"inline\": true,\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/attachments/extract",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"attachments",
"extract"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"0c17f72ac15c3f0108040b142e653165\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "35b849d9-c9ff-44f3-946d-28315704df86"
},
{
"key": "X-Runtime",
"value": "1.232739"
},
{
"key": "Date",
"value": "Wed, 27 Apr 2022 08:59:59 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"urls\": [\n \"https://pdf-temp-files.s3.amazonaws.com/DO1TAIHEZR5P9QLI7ICYM9DI0AAH57HY/sample.png\",\n \"https://pdf-temp-files.s3.amazonaws.com/EOINIMD7X48JSOB1G8ETLVPOFZLM1NJ2/SampleMetafile.emf\",\n \"https://pdf-temp-files.s3.amazonaws.com/3LW4BXNSPAE0WQTG5DPMXX498OCPNU4Q/ab.tif\"\n ],\n \"pageCount\": 3,\n \"error\": false,\n \"status\": 200,\n \"name\": \"attachments.json\",\n \"credits\": 24,\n \"duration\": 1211,\n \"remainingCredits\": 98003902\n}"
}
]
}
],
"description": "PDF attachments functions and attachments extraction.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "04. PDF Add Text, Signatures and Images to PDF",
"item": [
{
"name": "/pdf/edit/add (adding text and images)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"inline\": true,\n \"name\": \"newDocument\",\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/sample.pdf\",\n \"annotations\": [\n {\n \"text\": \"Sample Text 1\",\n \"x\": 150,\n \"y\": 100,\n \"size\": 20,\n \"pages\": \"0-\"\n },\n {\n \"text\": \"sample text that is centered (can also set right or left alignment) \",\n \"x\": \"10\",\n \"y\": \"10\",\n \"width\": \"500\",\n \"height\": \"200\",\n \"size\": \"7\",\n \"pages\": \"0\",\n \"alignment\": \"center\"\n },\n {\n \"text\": \"Sample Text 2 - Click here to test link\\r\\n(CLICK ME!)\",\n \"x\": 250,\n \"y\": 240,\n \"size\": 24,\n \"pages\": \"0-\",\n \"color\": \"CCBBAA\",\n \"link\": \"https://bytescout.com/\",\n \"fontName\": \"Comic Sans MS\",\n \"fontItalic\": true,\n \"fontBold\": true,\n \"fontStrikeout\": false,\n \"fontUnderline\": true\n },\n {\n \"text\": \"Simple text 3\",\n \"x\": 100,\n \"y\": 230,\n \"size\": 12,\n \"pages\": \"0-\",\n \"type\": \"Text\"\n },\n {\n \"text\": \"sample text 3 - input text field\",\n \"x\": 100,\n \"y\": 170,\n \"size\": 16,\n \"pages\": \"0-\",\n \"type\": \"TextField\",\n \"id\": \"textfield1\"\n },\n {\n \"x\": 200,\n \"y\": 120,\n \"size\": 16,\n \"pages\": \"0-\",\n \"type\": \"Checkbox\",\n \"id\": \"checkbox2\"\n },\n {\n \"x\": 200,\n \"y\": 140,\n \"size\": 16,\n \"pages\": \"0-\",\n \"type\": \"CheckboxChecked\",\n \"id\": \"checkbox3\"\n }\n ],\n \"images\": [\n {\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png\",\n \"x\": 270,\n \"y\": 150,\n \"width\": 159,\n \"height\": 43,\n \"pages\": \"0\"\n },\n{\n \"url\": \"data:image/png;base64,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\",\n \"x\": 10,\n \"y\": 230,\n \"pages\": \"0-\"\n }\n ]\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
},
"description": "Add text, text-based watermarks, images, other pdfs, signatures, text fields, unchecked checkbox, and checked checkbox to existing PDF files. You can fill out our existing PDF forms and documents and create new fillable PDF forms using this method.\n\nTo quickly create config for filling out PDF, just use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper).\n\nTo 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](https://app.pdf.co/files). If you need to draw a signature and save it as an image then use [this page](https://app.pdf.co/make-signature).\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source URL.\n| **httppassword** optional HTTP auth password if required to access source URL.\n| **annotations[]** 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\"`).\n \n| **Annotations** (to add text) |\n| --- |\n| **text** optional 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](https://apidocs.pdf.co/kb/Fill%20PDF%20and%20Add%20Text%20or%20Images%20(pdf-edit-add)/index) for more details on macros.\n| **x** required X coordinate. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to measure coordinates. |\n| **y** required Y coordinate (zero point is in the top left corner. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to measure pdf coordinates. |\n| **width** optional Width of the text box . Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to measure pdf coordinates. |\n| **height** optional Height of the text box . Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to measure pdf coordinates. |\n| **alignment** optional, default is `left` Sets text alignment within the `width` of the text box. Valid values: `left`, `center`, `right`. |\n| **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. |\n| **color** optional, default is `000000` (non-transparent black). Color in `RRGGBB` or `AARRGGBB` format where `AA` is the transparency component. For example, 50% transparent green is `#8000FF00`. [Check this KB article for details and more sample colors](https://apidocs.pdf.co/kb/Fill%20PDF%20and%20Add%20Text%20or%20Images%20(pdf-edit-add)/text-colors) for details. |\n| **link** optional Sets link on click for text. |\n| **size** optional, default is `12`. set font size. |\n| **transparent** optional Set to `false` to force disable any transparency and draw a white background under the text. |\n| **fontName** optional, default is `Arial`. Set font name to use. |\n| **fontBold** optional, default is `false`. Set to `true` to enable bold font style. |\n| **fontStrikeout** optional, default is `false`. Set to `true` to enable strikeout font style. |\n| **fontUnderline** optional, default is `false`. Set to `true` to enable underline font style. |\n| **type** optional, default is `text` Set object type, available types: `text` = text object, `textfield` = text input field, `checkbox` = checkbox field. |\n| **id** optional Sets id of the form field if `type` is not `text`. |\n \nSee the [font list](https://apidocs.pdf.co/kb/General/pdfco-font-list) for all PDF.co-supported fonts.\n\n| **Adding Images and embedded PDF** |\n| --- |\n| **images[]** optional Array of objects with information about images and PDF embeds to add(also can be a link to Files storage or datauri link) to be added on top of source PDF file. Images can be loaded from URLs or from URLs for internal [file](https://app.pdf.co/files) storage. |\n \n| **Attributes for Images objects** |\n| --- |\n| **url** optional URL to image or PDF as HTTP link, file token, or `datauri:..` URL (with base64 encoded image). |\n| **x** optional X coordinate Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **y** optional Y coordinate Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **width** optional Width of the text box Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **height** optional Height of the text box Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **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 the different numbers 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. |\n| **link** optional Link to open on click. |\n| **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. |\n \n| **Parameters for Fields objects** |\n| --- |\n| **fieldName** Name of the form field. To find form fields please use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) |\n| **pages** optional page index where this form field appears. |\n| **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](https://app.pdf.co/pdf-edit-add-helper) |\n| **fontName** optional Name of the font to use to fill out the input field. |\n| **size** optional Override the font size of the text inside the given input field. |\n| **fontBold** optional Override font bold style of the text input field |\n| **fontItalic** optional Override font italic style of the text input field. |\n| **fontStrikeout** optional Override font strikeout style of the text input field. |\n| **fontUnderline** optional Override font underline style of the text input field. |\n \n**Tip**: to turn all fillable fields into read-only fields, just set the `profiles` parameter (of the endpoint) to this value: \n`{ 'FlattenDocument()': [] }`\n\n| **Other Attributes** |\n| --- |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **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). |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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. |\n\nFor example, to flatten pdf form set `profiles` to this value: \n\n```\n{ 'FlattenDocument()': [] }\n```\n\nSee [profiles samples](https://apidocs.pdf.co/profiles) for examples.\n\n| **Attributes** |\n| --- |\n| **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. |"
},
"response": [
{
"name": "/pdf/edit/add",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"name\": \"newDocument\",\n \"inline\": true,\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/sample.pdf\",\n \"annotations\": [\n {\n \"text\": \"Sample Text 1\",\n \"x\": 150,\n \"y\": 100,\n \"size\": 20,\n \"pages\": \"0-\"\n },\n {\n \"text\": \"Sample Text 2 - Click here to test link\\r\\n(CLICK ME!)\",\n \"x\": 250,\n \"y\": 240,\n \"size\": 24,\n \"pages\": \"0-\",\n \"color\": \"CCBBAA\",\n \"link\": \"https://bytescout.com/\",\n \"fontName\": \"Colibri\",\n \"fontItalic\": true,\n \"fontBold\": true,\n \"fontStrikeout\": false,\n \"fontUnderline\": true\n },\n {\n \"text\": \"Simple text 3\",\n \"x\": 100,\n \"y\": 230,\n \"size\": 12,\n \"pages\": \"0-\",\n \"type\": \"Text\"\n },\n {\n \"text\": \"sample text 3 - input text field\",\n \"x\": 100,\n \"y\": 170,\n \"size\": 16,\n \"pages\": \"0-\",\n \"type\": \"TextField\",\n \"id\": \"textfield1\"\n },\n {\n \"x\": 200,\n \"y\": 120,\n \"size\": 16,\n \"pages\": \"0-\",\n \"type\": \"Checkbox\",\n \"id\": \"checkbox2\"\n },\n {\n \"x\": 200,\n \"y\": 140,\n \"size\": 16,\n \"pages\": \"0-\",\n \"type\": \"CheckboxChecked\",\n \"id\": \"checkbox3\"\n }\n ],\n \"images\": [\n {\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png\",\n \"x\": 270,\n \"y\": 150,\n \"width\": 159,\n \"height\": 43,\n \"pages\": \"0\"\n },\n{\n \"url\": \"data:image/png;base64,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\",\n \"x\": 10,\n \"y\": 230,\n \"pages\": \"0-\"\n }\n ]\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"091c0655f434d4c57b35e5b70040eaf9\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "81ffd343-9cf5-467f-b0dc-a066113c0d23"
},
{
"key": "X-Runtime",
"value": "0.773962"
},
{
"key": "Date",
"value": "Tue, 16 Mar 2021 12:43:09 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\",\n \"url\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/0c336bfcef1a473d98492bda25d8da03/newDocument.pdf?X-Amz-Expires=3600&x-amz-security-token=FwoGZXIvYXdzEO7%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDHWK1dY4d4lOgsheliKBATwE%2FZewASPTEnPxTn%2BOdYhP4h3gljAJfqbRvQptDX7wdWLmrBS7Tg4qTU6pAbxIdXChGPjBWpSbtiADJKmqkmyhkUmE8GSM1%2FGtJO6bga2pgzvFLXmzxjTf3%2BFNqwYOvbyApIZdVLoPpEKY6PlCflQtLTd30dhelm6xpB8pitbdhSjdz8KCBjIobVy%2Fjwybwp6OQgB%2FT6QkIo2dU07gtFREdn5jhRyvnS5lkccweBV1%2Bw%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHMV5P3JOS/20210316/us-west-2/s3/aws4_request&X-Amz-Date=20210316T124309Z&X-Amz-SignedHeaders=host;x-amz-security-token&X-Amz-Signature=95287bf3c007fed4c2c5aeea1ce75c846cc6c68b22aaf35175ebe41a105f54e1\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"newDocument\",\n \"remainingCredits\": 9913694,\n \"credits\": 3\n}"
}
]
},
{
"name": "/pdf/edit/add (adding watermarks)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"inline\": true,\n \"name\": \"newDocument\",\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/sample.pdf\",\n \"annotations\": [\n {\n \"text\": \"GREEN color no transparency\",\n \"color\": \"#00FF00\",\n \"x\": 5,\n \"y\": 5,\n \"size\": 45,\n \"fontBold\": true\n },\n {\n \"text\": \"GREEN color 75% transparency\",\n \"color\": \"#BF00FF00\",\n \"x\": 5,\n \"y\": 50,\n \"size\": 45,\n \"fontBold\": true\n },\n {\n \"text\": \"GREEN color 33% transparency\",\n \"color\": \"#3300FF00\",\n \"x\": 5,\n \"y\": 100,\n \"size\": 45,\n \"fontBold\": true\n\n },\n {\n \"text\": \"GREEN color 10% transparency\",\n \"color\": \"#1A00FF00\",\n \"x\": 5,\n \"y\": 150,\n \"size\": 45,\n \"fontBold\": true\n\n },\n {\n \"text\": \"RED color 50% transparency\",\n \"color\": \"#80FF0000\",\n \"fontname\": \"Impact\",\n \"x\": 5,\n \"y\": 350,\n \"size\": 45,\n \"fontBold\": true\n },\n {\n \"text\": \"RED color 20% transparency\",\n \"color\": \"#40FF0000\",\n \"fontName\": \"Impact\",\n \"x\": 5,\n \"y\": 400,\n \"size\": 45,\n \"fontBold\": true\n } \n ]\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
},
"description": "Add text, text-based watermarks, images, other pdfs, signatures, text fields, unchecked checkbox, and checked checkbox to existing PDF files. You can fill out our existing PDF forms and documents and create new fillable PDF forms using this method.\n\nTo quickly creat configuration to fill PDF please use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper).\n\nTo 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](https://app.pdf.co/files). If you need to draw a signature and save it as an image then use [this page](https://app.pdf.co/make-signature).\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption).|\n| **httpusername** optional HTTP auth user name if required to access source URL.\n| **httppassword** optional HTTP auth password if required to access source URL.\n| **annotations[]** 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\"`).\n \n| **Annotations** (to add text) |\n| --- |\n| **text** optional 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](https://apidocs.pdf.co/kb/Fill%20PDF%20and%20Add%20Text%20or%20Images%20(pdf-edit-add)/index) for more details on macros.\n| **x** required X coordinate (zero point is in the top left corner, use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to measure or get coordinates). |\n| **y** required Y coordinate . Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to measure pdf coordinates. |\n| **width** optional Width of the text box . Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to measure pdf coordinates. |\n| **height** optional Height of the text box . Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to measure pdf coordinates. |\n| **alignment** optional, default is `left` Sets text alignment within the `width` of the text box. Valid values: `left`, `center`, `right`. |\n| **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. |\n| **color** optional, default is `000000` (non-transparent black). Color in `RRGGBB` or `AARRGGBB` format where `AA` is the transparency component. For example, 50% transparent green is `#8000FF00`. [Check this KB article for details and more sample colors](https://apidocs.pdf.co/kb/Fill%20PDF%20and%20Add%20Text%20or%20Images%20(pdf-edit-add)/text-colors) for details. |\n| **link** optional Sets link on click for text. |\n| **size** optional, default is `12`. set font size. |\n| **transparent** optional Set to `false` to force disable any transparency and draw a white background under the text. |\n| **fontName** optional, default is `Arial`. Set font name to use. |\n| **fontBold** optional, default is `false`. Set to `true` to enable bold font style. |\n| **fontStrikeout** optional, default is `false`. Set to `true` to enable strikeout font style. |\n| **fontUnderline** optional, default is `false`. Set to `true` to enable underline font style. |\n| **type** optional, default is `text` Set object type, available types: `text` = text object, `textfield` = text input field, `checkbox` = checkbox field. |\n| **id** optional Sets id of the form field if `type` is not `text`. |\n \nSee the [font list](https://apidocs.pdf.co/kb/General/pdfco-font-list) for all PDF.co-supported fonts.\n\n| **Adding Images and embedded PDF** |\n| --- |\n| **images[]** optional Array of objects with information about images and PDF embeds to add(also can be a link to Files storage or datauri link) to be added on top of source PDF file. Images can be loaded from URLs or from URLs for internal [file](https://app.pdf.co/files) storage. |\n \n| **Attributes for Images objects** |\n| --- |\n| **url** optional URL to image or PDF as HTTP link, file token, or `datauri:..` URL (with base64 encoded image). |\n| **x** optional X coordinate Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **y** optional Y coordinate Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **width** optional Width of the text box Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **height** optional Height of the text box Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **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 the different numbers 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. |\n| **link** optional Link to open on click. |\n| **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. |\n \n| **Parameters for Fields objects** |\n| --- |\n| **fieldName** Name of the form field. To find form fields please use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) |\n| **pages** optional page index where this form field appears. |\n| **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](https://app.pdf.co/pdf-edit-add-helper) |\n| **fontName** optional Name of the font to use to fill out the input field. |\n| **size** optional Override the font size of the text inside the given input field. |\n| **fontBold** optional Override font bold style of the text input field |\n| **fontItalic** optional Override font italic style of the text input field. |\n| **fontStrikeout** optional Override font strikeout style of the text input field. |\n| **fontUnderline** optional Override font underline style of the text input field. |\n \n**Tip**: to turn all fillable fields into read-only fields, just set the `profiles` parameter (of the endpoint) to this value: \n`{ 'FlattenDocument()': [] }`\n\n| **Other Attributes** |\n| --- |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **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). |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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. |\n\nFor example, to flatten pdf form set `profiles` to this value: \n\n```\n{ 'FlattenDocument()': [] }\n```\n\nSee [profiles samples](https://apidocs.pdf.co/profiles) for examples.\n\n| **Attributes** |\n| --- |\n| **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. |"
},
"response": [
{
"name": "/pdf/edit/add",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"name\": \"newDocument\",\n \"inline\": true,\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/sample.pdf\",\n \"annotations\": [\n {\n \"text\": \"Sample Text 1\",\n \"x\": 150,\n \"y\": 100,\n \"size\": 20,\n \"pages\": \"0-\"\n },\n {\n \"text\": \"Sample Text 2 - Click here to test link\\r\\n(CLICK ME!)\",\n \"x\": 250,\n \"y\": 240,\n \"size\": 24,\n \"pages\": \"0-\",\n \"color\": \"CCBBAA\",\n \"link\": \"https://bytescout.com/\",\n \"fontName\": \"Colibri\",\n \"fontItalic\": true,\n \"fontBold\": true,\n \"fontStrikeout\": false,\n \"fontUnderline\": true\n },\n {\n \"text\": \"Simple text 3\",\n \"x\": 100,\n \"y\": 230,\n \"size\": 12,\n \"pages\": \"0-\",\n \"type\": \"Text\"\n },\n {\n \"text\": \"sample text 3 - input text field\",\n \"x\": 100,\n \"y\": 170,\n \"size\": 16,\n \"pages\": \"0-\",\n \"type\": \"TextField\",\n \"id\": \"textfield1\"\n },\n {\n \"x\": 200,\n \"y\": 120,\n \"size\": 16,\n \"pages\": \"0-\",\n \"type\": \"Checkbox\",\n \"id\": \"checkbox2\"\n },\n {\n \"x\": 200,\n \"y\": 140,\n \"size\": 16,\n \"pages\": \"0-\",\n \"type\": \"CheckboxChecked\",\n \"id\": \"checkbox3\"\n }\n ],\n \"images\": [\n {\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png\",\n \"x\": 270,\n \"y\": 150,\n \"width\": 159,\n \"height\": 43,\n \"pages\": \"0\"\n },\n{\n \"url\": \"data:image/png;base64,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\",\n \"x\": 10,\n \"y\": 230,\n \"pages\": \"0-\"\n }\n ]\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"091c0655f434d4c57b35e5b70040eaf9\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "81ffd343-9cf5-467f-b0dc-a066113c0d23"
},
{
"key": "X-Runtime",
"value": "0.773962"
},
{
"key": "Date",
"value": "Tue, 16 Mar 2021 12:43:09 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\",\n \"url\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/0c336bfcef1a473d98492bda25d8da03/newDocument.pdf?X-Amz-Expires=3600&x-amz-security-token=FwoGZXIvYXdzEO7%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDHWK1dY4d4lOgsheliKBATwE%2FZewASPTEnPxTn%2BOdYhP4h3gljAJfqbRvQptDX7wdWLmrBS7Tg4qTU6pAbxIdXChGPjBWpSbtiADJKmqkmyhkUmE8GSM1%2FGtJO6bga2pgzvFLXmzxjTf3%2BFNqwYOvbyApIZdVLoPpEKY6PlCflQtLTd30dhelm6xpB8pitbdhSjdz8KCBjIobVy%2Fjwybwp6OQgB%2FT6QkIo2dU07gtFREdn5jhRyvnS5lkccweBV1%2Bw%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHMV5P3JOS/20210316/us-west-2/s3/aws4_request&X-Amz-Date=20210316T124309Z&X-Amz-SignedHeaders=host;x-amz-security-token&X-Amz-Signature=95287bf3c007fed4c2c5aeea1ce75c846cc6c68b22aaf35175ebe41a105f54e1\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"newDocument\",\n \"remainingCredits\": 9913694,\n \"credits\": 3\n}"
}
]
},
{
"name": "/pdf/edit/add (adding text and images with simplified parameters)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"inline\": true,\n \"name\": \"f1040-form-filled\",\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-form/f1040.pdf\",\n \"annotationsString\": \"250;20;0-;PDF form filled with PDF.co API;24+bold+italic+underline+strikeout;Arial;FF0000;www.pdf.co;true\",\n \"imagesString\": \"100;180;0-;pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png|400;180;0-;pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png;www.pdf.co;200;200\",\n \"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\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
},
"description": "You can add text, images, other pdfs, and signatures to pdf and also can fill interactive pdf forms. This method uses a simplified version of `/pdf/edit/add` that allows you to add multiple texts, and images, and fill pdf fields using simplified string representations\n\nUse [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates.\n\nTo save an image or pdf for re-use as a template please use the link from Dropbox or Google Drive or from another storage. Or use built-in [PDF.co Files storage](https://app.pdf.co/files). If you need to draw a signature and save it as an image then use [this page](https://app.pdf.co/make-signature).\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **annotationsString** optional This parameter represents one or more text objects to add to pdf. Each text object is made of parameter separated by `;` symbol:
where `24+bold` is the font size. You can also add styles font size using the following modifiers: \\- `+bold` for bold style \\- `+italic` for italic style \\- `+underline` for underline style \\- `+strikeout` for strikeout style
For example: `20;20;0-;Testing Text;24+bold+italic;Arial`.
Example 2 with `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`
To put multiple objects, Just use the `\\|` separator between objects.
Example:
`250;20;0-;Text1|250;30;0-;Text2|250;50;0-;Text3`
\nYou can also use different fonts, check the [full list of fonts supported](https://apidocs.pdf.co/kb/General/pdfco-font-list).
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](/kb/Fill PDF and Add Text or Images to PDF/macros) for more details on macros.
`fontColor` can use regular colors like `000000` in `RGB` format. But also can use `AARRGGBB` format where `AA` is the transparency component. For example, 50% transparent green is `#8000FF00`. [Check this KB article for details about supported colors](https://apidocs.pdf.co/kb/Fill%20PDF%20and%20Add%20Text%20or%20Images%20(pdf-edit-add)/text-colors) for details. |\n| **imagesString** optional Adds one or more images or other pdfs on top of the source pdf.
Each image or pdf object can be defined as `x;y;pages;urltoimageOrPdf;linkToOpen;width;height`
\nYou can also use base64 datauri embedded image or `filetoken://` link to a file from PDF.co storage. |\n| **fieldsString** optional Set values for fillable pdf fields (i.e. fill pdf fields in pdf forms). To fill fields in PDF form, use the following format `page;fieldName;value`.
Also, the advanced format can be used to override font name, size and style: `0;fieldName;Field Text;12+bold+italic+underline+strikeout;FontName`
**Example**: `0;editbox1;text is here`. To fill the checkbox, use `true`, for example: `0;checkbox1;true`. To separate multiple objects, use `|` separator. To get the list of all fillable fields in PDF form please use `/pdf/info/fields` endpoint. |\n| **password** optional Password of PDF file, The input must be in string format.|\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **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). |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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. |\n\nFor example, to flatten pdf form set `profiles` to this value: \n\n```\n{ 'FlattenDocument()': [] }\n```\n\nSee [profiles samples](https://apidocs.pdf.co/profiles) for examples.\n\n| **Attributes** |\n| --- |\n| **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. |"
},
"response": [
{
"name": "JSON simplified /pdf/edit/add",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"inline\": true,\n \"name\": \"f1040-form-filled\",\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-form/f1040.pdf\",\n \"annotationsString\": \"20;20;0-;PDF form filled with PDF.co API;24;Arial;FF0000;www.pdf.co;true\",\n \"imagesString\": \"100;180;0-;pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png|400;180;0-;pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png;www.pdf.co;200;200\",\n \"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\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"fc24da2b53ec84c75b323cc8e5cb45d0\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "4b76374e-e3ad-4c53-a61e-39068debe695"
},
{
"key": "X-Runtime",
"value": "0.950776"
},
{
"key": "Date",
"value": "Thu, 20 Aug 2020 13:26:57 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/03c5c55183c74f8d94a4ec952e4e32ad/f1040-form-filled.pdf\",\n \"pageCount\": 3,\n \"error\": false,\n \"status\": 200,\n \"name\": \"f1040-form-filled\",\n \"remainingCredits\": 60822\n}"
}
]
}
],
"description": "Add text, images, signatures, other pdfs, links to external sites and external PDF files. You can update or modify PDF and scanned PDF files.\n\nQuickly create configs for PDF.co API, Zapier, Make with [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper).",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "05. PDF Fill PDF Forms",
"item": [
{
"name": "/pdf/edit/add (fill pdf form)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"inline\": true,\n \"name\": \"f1040-filled\",\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-form/f1040.pdf\",\n \"fields\": [\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1]\",\n \"pages\": \"1\", \n \"text\": \"True\" \n },\n {\n \n \"fieldName\": \"topmostSubform[0].Page1[0].f1_02[0]\",\n \"pages\": \"1\", \n \"text\": \"John A.\"\n }, \n {\n \n \"fieldName\": \"topmostSubform[0].Page1[0].f1_03[0]\",\n \"pages\": \"1\", \n \"text\": \"Doe\"\n }, \n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_04[0]\",\n \"pages\": \"1\",\n \"text\": \"123456789\"\n },\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]\",\n \"pages\": \"1\", \n \"text\": \"Joan B.\",\n \"fontName\": \"Arial\",\n \"size\": 6,\n \"fontBold\": true,\n \"fontItalic\": true,\n \"fontStrikeout\": true,\n \"fontUnderline\": true\n },\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]\",\n \"pages\": \"1\",\n \"text\": \"Joan B.\"\n },\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_06[0]\",\n \"pages\": \"1\",\n \"text\": \"Doe\"\n },\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_07[0]\",\n \"pages\": \"1\",\n \"text\": \"987654321\"\n } \n\n\n\n ],\n \"annotations\":[\n {\n \"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.\",\n \"x\": 400,\n \"y\": 10,\n \"width\": 200,\n \"height\": 500,\n \"size\": 12, \n \"pages\": \"0-\",\n \"color\": \"FF0000\",\n \"link\": \"https://pdf.co\"\n }\n ], \n \"images\": [\n { \n \"pages\": \"!0\", \n \"x\": 100, \n \"y\": 374,\n \"width\": 100, \n \"url\": \"data:image/png;base64,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\"\n }\n ]\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
},
"description": "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.\n\nUse [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates.\n\nTo 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](https://app.pdf.co/files). If you need to draw a signature and save it as an image then use [this page](https://app.pdf.co/make-signature).\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **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\"`). |\n \n| **Attributes** for `annotations` objects |\n| --- |\n| **text** String to add, If you need to insert a line break then use `\\n` or `{{$$newLine}}`. |\n| You can also use built-in macros like `{{$$PageNumber}}` and custom data macros. Check [this knowledgebase article](/kb/Fill PDF and Add Text or Images to PDF/macros) for more details on macros. |\n| **x** X coordinate Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **y** Y coordinate Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **width** optional Width of the text box Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **height** optional Height of the text box Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **alignment** optional, default is `left`. Sets text alignment within the `width` of the text box. Valid values: `left`, `center`, `right`. |\n| **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. |\n| **color** optional, default is `black`. Color for the text. |\n| **link** optional Sets link on click for text. |\n| **size** optional, default is `12`. Set font size. |\n| **fontName** optional, default is `Arial`. Sets font name to use. Check the [font list](https://apidocs.pdf.co/kb/General/pdfco-font-list) for all supported fonts. |\n| **fontBold** optional, default is `false`. Set to `true` to enable bold font style. |\n| **fontStrikeout** optional, default is `false`. Set to `true` to enable strikeout font style. |\n| **fontUnderline** optional, default is `false`. Set to `true` to enable underlined font style. |\n| **type** optional, default is `text`. Set object type, available types: `text` = text object, `textfield` = text input field, `checkbox` = checkbox field. |\n| **id** optional Sets id of the form field if `type` is not `text`. |\n \n| **Images** |\n| --- |\n| **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](https://app.pdf.co/files) storage. |\n \n| **Attributes for Images objects** |\n| --- |\n| **url** required URL to image or pdf as HTTP link, file token or `datauri:..` URL (with base64 encoded image or pdf). |\n| **x** X coordinate Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **y** Y coordinate Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **width** optional Width of the text box Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **height** optional Height of the text box Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. |\n| **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. |\n| **link** optional Link to open on click. |\n| **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. |\n \n| **Fields** |\n| --- |\n| **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. |\n \n| **Attributes for Fields objects** |\n| --- |\n| **fieldName** Name of the form field. To find form fields please use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) |\n| **pages** optional Page index where this form field appears. |\n| **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](https://app.pdf.co/pdf-edit-add-helper) |\n| **fontName** optional Name of the font to use to fill out the input field. Check the [font list](https://apidocs.pdf.co/kb/General/pdfco-font-list) for all supported fonts. |\n| **size** optional Override the font size of the text inside the given input field. |\n| **fontBold** optional Override font bold style of the text input field. |\n| **fontItalic** optional Override font italic style of the text input field. |\n| **fontStrikeout** optional Override font strikeout style of the text input field. |\n| **fontUnderline** optional Override font underline style of the text input field. |\n \n**Tip**: to turn all fillable fields into read-only fields, just set the `profiles` parameter (of the endpoint) to this value: \n`{ 'FlattenDocument()': [] }`\n\n| **Additional Attributes** |\n| --- |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **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). |\n| **name** optional File name for the generated output. Must be a String. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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. | \n\nFor example, to flatten pdf form set `profiles` to this value: \n\n```\n{ 'FlattenDocument()': [] }\n```\n\nSee [profiles samples](https://apidocs.pdf.co/profiles) for examples.\n\n| **Attributes ** |\n| --- |\n| **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. |"
},
"response": [
{
"name": "/pdf/edit/add",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"inline\": true,\n \"name\": \"f1040-filled\",\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-form/f1040.pdf\",\n \"fields\": [\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1]\",\n \"pages\": \"1\", \n \"text\": \"True\" \n },\n {\n \n \"fieldName\": \"topmostSubform[0].Page1[0].f1_02[0]\",\n \"pages\": \"1\", \n \"text\": \"John A.\"\n }, \n {\n \n \"fieldName\": \"topmostSubform[0].Page1[0].f1_03[0]\",\n \"pages\": \"1\", \n \"text\": \"Doe\"\n }, \n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_04[0]\",\n \"pages\": \"1\",\n \"text\": \"123456789\"\n },\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]\",\n \"pages\": \"1\", \n \"text\": \"Joan B.\",\n \"fontName\": \"Arial\",\n \"size\": 6,\n \"fontBold\": true,\n \"fontItalic\": true,\n \"fontStrikeout\": true,\n \"fontUnderline\": true\n },\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]\",\n \"pages\": \"1\",\n \"text\": \"Joan B.\"\n },\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_06[0]\",\n \"pages\": \"1\",\n \"text\": \"Doe\"\n },\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_07[0]\",\n \"pages\": \"1\",\n \"text\": \"987654321\"\n } \n\n\n\n ],\n \"annotations\":[\n {\n \"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.\",\n \"x\": 400,\n \"y\": 10,\n \"width\": 200,\n \"height\": 500,\n \"size\": 12, \n \"pages\": \"0-\",\n \"color\": \"FF0000\",\n \"link\": \"https://pdf.co\"\n }\n ], \n \"images\": [\n { \n \"pages\": \"!0\", \n \"x\": 100, \n \"y\": 374,\n \"width\": 100, \n \"url\": \"data:image/png;base64,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\"\n }\n ]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "ETag",
"value": "W/\"44283bcbe953d79077249c73bc4c606a\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "0eaaa6b9-3574-44ba-af28-a54d6259d5d4"
},
{
"key": "X-Runtime",
"value": "1.438615"
},
{
"key": "Vary",
"value": "Origin"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
}
],
"cookie": [],
"body": "{\n \"hash\": \"e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855\",\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/cd15a09771554bed88d6419c1e2f2b16/f1040-filled.pdf\",\n \"pageCount\": 3,\n \"error\": false,\n \"status\": 200,\n \"name\": \"f1040-filled.pdf\",\n \"remainingCredits\": 99999369,\n \"credits\": 63\n}"
}
]
},
{
"name": "/pdf/edit/add (fill pdf form with simplified params)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"inline\": true,\n \"name\": \"f1040-form-filled\",\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-form/f1040.pdf\",\n \"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\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
},
"description": "You can add fill pdf fields in existing PDF PDF forms. This method uses a simplified version of `/pdf/edit/add`.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **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:
Check the [font list](https://apidocs.pdf.co/kb/General/pdfco-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. |\n| **To find names of all fillable fields** in a PDF file please use the `/pdf/info/fields` endpoint or interactive [PDF.co Request Tester](https://app.pdf.co/request-tester) |\n| **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`.
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: |\n| **+bold** optional **Bold** style. |\n| **+italic** optional _Italic_ style. |\n| **+underline** optional __underline__ style |\n| **+strikeout** optional ~~strikeout~~ style. |\n\nCheck the [font list](https://apidocs.pdf.co/kb/General/pdfco-font-list) for all supported fonts.\n\nFor example, for font size 24 and `bold`, `italic`, `underline` and `strikeout` styles:\n\n```\n250;20;0-;PDF form filled with PDF.co API;24+bold+italic+underline+strikeout;Arial;FF0000;www.pdf.co;true\n\n```\n\nIf you need to insert a line break then use `\\n` or `{{$$newLine}}`.\n\nYou can also use built-in macros like `{{$$PageNumber}}` and custom data macros. Check [this knowledgebase article](/kb/Fill PDF and Add Text or Images to PDF/macros) for more details on macros.\n\n| |\n| --- |\n| **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. |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **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). |\n| **name** optional File name for the generated output. Must be a String. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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. |\n| **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. | \n\nFor example, to flatten pdf form, set `profiles` to this value: \n\n```\n{ 'FlattenDocument()': [] }\n```\n\nSee [profiles samples](https://apidocs.pdf.co/profiles) for examples."
},
"response": [
{
"name": "JSON simplified /pdf/edit/add",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"inline\": true,\n \"name\": \"f1040-form-filled\",\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-form/f1040.pdf\",\n \"annotationsString\": \"20;20;0-;PDF form filled with PDF.co API;24;Arial;FF0000;www.pdf.co;true\",\n \"imagesString\": \"100;180;0-;pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png|400;180;0-;pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png;www.pdf.co;200;200\",\n \"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\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"fc24da2b53ec84c75b323cc8e5cb45d0\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "4b76374e-e3ad-4c53-a61e-39068debe695"
},
{
"key": "X-Runtime",
"value": "0.950776"
},
{
"key": "Date",
"value": "Thu, 20 Aug 2020 13:26:57 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/03c5c55183c74f8d94a4ec952e4e32ad/f1040-form-filled.pdf\",\n \"pageCount\": 3,\n \"error\": false,\n \"status\": 200,\n \"name\": \"f1040-form-filled\",\n \"remainingCredits\": 60822\n}"
}
]
}
],
"description": "PDF filler for **fillable** PDF forms using PDF.co. \n\nTo find form fields please use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper).\n\nTo get the list of all fillable fields inside PDF form, please use `/pdf/info/fields` endpoint. \n\nIf you need to create your own fillable form then please check `PDF Create Fillable PDF Forms` topic. \n\n",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "06. PDF Create Fillable PDF Forms",
"item": [
{
"name": "/pdf/edit/add (create pdf fields)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": false,\n \"inline\": true,\n \"name\": \"newDocument\",\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/sample.pdf\",\n \"annotations\":[ \n {\n \"text\":\"sample prefilled text\",\n \"x\": 10,\n \"y\": 30,\n \"size\": 12,\n \"pages\": \"0-\",\n \"type\": \"TextField\",\n \"id\": \"textfield1\"\n },\n {\n \"x\": 100,\n \"y\": 150,\n \"size\": 12,\n \"pages\": \"0-\",\n \"type\": \"Checkbox\",\n \"id\": \"checkbox2\"\n },\n {\n \"x\": 100,\n \"y\": 170,\n \"size\": 12,\n \"pages\": \"0-\",\n \"link\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png\",\n \"type\": \"CheckboxChecked\",\n \"id\":\"checkbox3\"\n } \n \n ],\n \"images\": [\n {\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png\",\n \"x\": 200,\n \"y\": 250,\n \"pages\": \"0\",\n \"link\": \"www.pdf.co\"\n }\n \n ]\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"add"
]
},
"description": "You can create a fillable PDF form from the existing PDF by adding editable text boxes and checkboxes.\n\nadds text, images, text fields, unchecked checkbox, and checked checkbox to existing PDF files. You can fill out existing PDF forms and documents and create new fillable PDF forms using this method.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **annotations[]** optional The array of text objects to be added on top of pdf. Text objects can be ready-only (`\"type\": \"text\"` by default), input pdf input fields (`\"type\": \"textField\"`), or checkboxes (`\"type\": \"checkbox\"`). | \n\n**Sample:**\n```\n\"annotations\":\n[\n {\n \"text\": \"Testing Clickable Links \\r\\n(CLICK ME!)\",\n \"x\": 200,\n \"y\": 200,\n \"size\": 24,\n \"pages\": \"0-\",\n \"color\": \"CCBBAA\",\n \"link\": \"https://bytescout.com/\"\n },\n {\n \"text\": \"Testing Clickable Links \\r\\n(CLICK ME!)\",\n \"x\": 200,\n \"y\": 200,\n \"size\": 24,\n \"pages\": \"0-\",\n \"color\": \"CCBBAA\",\n \"link\": \"https://bytescout.com/\",\n \"fontName\": \"Colibri\",\n \"fontItalic\": true,\n \"fontBold\": true,\n \"fontStrikeout\": false,\n \"fontUnderline\": true,\n \"type\": \"text\"\n },\n {\n \"text\": \"sample pdf input field with prefilled text\",\n \"x\": 10,\n \"y\": 30,\n \"size\": 12,\n \"pages\": \"0-\",\n \"type\": \"TextField\",\n \"id\": \"textfield1\"\n },\n {\n \"x\": 100,\n \"y\": 150,\n \"size\": 12,\n \"pages\": \"0-\",\n \"type\": \"Checkbox\",\n \"id\": \"checkbox2\"\n }\n]\n```\n\nCheck the [font list](https://apidocs.pdf.co/kb/General/pdfco-font-list) for all supported fonts.\n\n| **Attributes** |\n| --- |\n| **images[]** optional The Array of image objects to be added on top of the PDF file. Images can be loaded from URLs or from URLs for internal [file](https://app.pdf.co/files) storage. |\n\n**Sample:**\n```\n\"images\": [\n {\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png\",\n \"x\": 200,\n \"y\": 250,\n \"pages\": \"0\",\n \"link\": \"www.pdf.co\"\n } \n]\n```\n\n| **Attributes** |\n| --- |\n| **fields[]** optional The 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. |\n\n**Sample:**\n```\n\"fields: \n[\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1]\",\n \"pages\": \"1\",\n \"text\": \"True\"\n },\n {\n \"fieldName\": \"topmostSubform[0].Page1[0].FilingStatus[0].c1_01[1]\",\n \"pages\": \"1\",\n \"text\": \"True\"\n }\n] \n ```\n\n| **Attributes** |\n| --- |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **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). |\n| **name** optional The file name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchString** required Text to search can support regular expressions if you set the `regexSearch` param to `true`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. IMPORTANT: the very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document) for ALL pages just leave this param empty. Example: `0,2-5,7-` means the first page, then the 3rd page to the 6th page, and then the range from the 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **inline** optional Must be one of: `true`, or `false`. |\n| **wordMatchingMode** optional Values can be either 'SmartMatch', 'ExactMatch', or 'None'. |\n| **password** optional Password of the PDF file, The input must be in string format. |\n| **regexSearch** optional Must be one of: `true`, or `false`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/find",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"async\": \"false\",\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-to-text/sample.pdf\",\n \"searchString\": \"Invoice Date \\\\d+/\\\\d+/\\\\d+\",\n \"regexSearch\": \"true\",\n \"name\": \"output\",\n \"pages\": \"0-\",\n \"inline\": \"true\",\n \"wordMatchingMode\": \"\",\n \"password\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/find",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"find"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"b352e6f92c7f41cd4c2b28e179e438a7\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "2e293ef9-4c1b-41bd-aba9-c58b00a2fa66"
},
{
"key": "X-Runtime",
"value": "0.478841"
},
{
"key": "Date",
"value": "Fri, 11 Sep 2020 20:00:07 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": [\n {\n \"text\": \"Invoice Date 01/01/2016\",\n \"left\": 436.5400085449219,\n \"top\": 130.4599995137751,\n \"width\": 122.85311957550027,\n \"height\": 11.040000486224898,\n \"pageIndex\": 0,\n \"bounds\": {\n \"location\": {\n \"isEmpty\": false,\n \"x\": 436.54,\n \"y\": 130.46\n },\n \"size\": \"122.853119, 11.0400009\",\n \"x\": 436.54,\n \"y\": 130.46,\n \"width\": 122.853119,\n \"height\": 11.0400009,\n \"left\": 436.54,\n \"top\": 130.46,\n \"right\": 559.3931,\n \"bottom\": 141.5,\n \"isEmpty\": false\n },\n \"elementCount\": 1,\n \"elements\": [\n {\n \"index\": 0,\n \"left\": 436.5400085449219,\n \"top\": 130.4599995137751,\n \"width\": 122.85311957550027,\n \"height\": 11.040000486224898,\n \"angle\": 0,\n \"text\": \"Invoice Date 01/01/2016\",\n \"isNewLine\": true,\n \"fontIsBold\": true,\n \"fontIsItalic\": false,\n \"fontName\": \"Helvetica-Bold\",\n \"fontSize\": 11,\n \"fontColor\": \"0, 0, 0\",\n \"fontColorAsOleColor\": 0,\n \"fontColorAsHtmlColor\": \"#000000\",\n \"bounds\": {\n \"location\": {\n \"isEmpty\": false,\n \"x\": 436.54,\n \"y\": 130.46\n },\n \"size\": \"122.853119, 11.0400009\",\n \"x\": 436.54,\n \"y\": 130.46,\n \"width\": 122.853119,\n \"height\": 11.0400009,\n \"left\": 436.54,\n \"top\": 130.46,\n \"right\": 559.3931,\n \"bottom\": 141.5,\n \"isEmpty\": false\n }\n }\n ]\n }\n ],\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"output\",\n \"remainingCredits\": 59970\n}"
}
]
}
],
"description": "Search text in PDF and get coordinates. Supports regular expressions.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "07.1. PDF Find Table",
"item": [
{
"name": "/pdf/find/table (AI powered)",
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-to-text/sample.pdf\",\n \"async\": \"false\",\n \"inline\": \"true\",\n \"password\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/find/table",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"find",
"table"
]
},
"description": "This function finds tables in documents using an AI-powered table detection engine. \n\nThis endpoint locates tables in an input PDF document and returns JSON with:\n- The array of `tables` objects;\n- `X`, `Y`, `Width`, and `Height` coordinates for every table found;\n- `Rect` param for every table that you can re-use with `pdf/convert/to/json`, `pdf/convert/to/csv`, `pdf/convert/to/csv`, and other endpoints to extract a selected table only;\n- `PageIndex` page index for a page with a table. The very first page is `0` (zero);\n- `Columns` array with the set of `X` coordinates for every column inside the table that was found;\n\nTo extract the table into CSV, JSON, or XML please use `pdf/convert/to/csv`, `pdf/convert/to/json2`, and `pdf/convert/to/xml` endpoints with `rect` parameter value from `rect` output param for this table accordingly.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** the very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **inline** optional Must be one of: `true`, or `false`. When `false`, the endpoint returns a link to the `.json` file with the output. |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/find/table",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-to-text/sample.pdf\",\n \"async\": \"false\",\n \"inline\": \"true\",\n \"password\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/find/table",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"find",
"table"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"f9880df2a8a47245a713485f49b009e3\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "844bcbf9-67f0-4737-ba27-799ce492aa55"
},
{
"key": "X-Runtime",
"value": "0.520686"
},
{
"key": "Date",
"value": "Wed, 19 Jan 2022 12:52:05 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": {\n \"tables\": [\n {\n \"PageIndex\": 0,\n \"X\": 36,\n \"Y\": 34.4400024,\n \"Width\": 523.44,\n \"Height\": 160.82,\n \"Columns\": [\n 357.675\n ],\n \"rect\": \"36, 34.4400024, 523.44, 160.82\"\n },\n {\n \"PageIndex\": 0,\n \"X\": 36,\n \"Y\": 316.249969,\n \"Width\": 523.44,\n \"Height\": 120.620026,\n \"Columns\": [\n 157.117,\n 340.68,\n 475.84\n ],\n \"rect\": \"36, 316.249969, 523.44, 120.620026\"\n }\n ]\n },\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.json\",\n \"remainingCredits\": 98892697,\n \"credits\": 21\n}"
}
]
},
{
"name": "/pdf/find/table (legacy table finder)",
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-to-text/sample.pdf\",\n \"async\": \"false\",\n \"inline\": \"true\",\n \"password\": \"\",\n \"profiles\": \"{ 'Mode': 'Legacy', 'ColumnDetectionMode': 'BorderedTables', 'DetectionMinNumberOfRows': 1, 'DetectionMinNumberOfColumns': 1, 'DetectionMaxNumberOfInvalidSubsequentRowsAllowed': 0, 'DetectionMinNumberOfLineBreaksBetweenTables': 0, 'EnhanceTableBorders': false }\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/find/table",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"find",
"table"
]
},
"description": "This function finds tables in documents using an AI-powered table detection engine but you can enable *legacy* table finder mode as well via the `profiles` parameter (see below).\n\nThis endpoint locates tables in the input PDF document and returns JSON with:\n- an array of `tables` objects;\n- `X`, `Y`, `Width`, and `Height` coordinates for every table found;\n- `rect` param for every table that you can re-use with `pdf/convert/to/json`, `pdf/convert/to/csv`, `pdf/convert/to/csv`, and other endpoints to extract a selected table only;\n- `PageIndex` page index for a page with a table. The very first page is `0` (zero);\n- `Columns` array with the set of `X` coordinates for every column inside a table that was found;\n\nTo extract the table into CSV, JSON, or XML please use the `pdf/convert/to/csv`, `pdf/convert/to/json2`, and `pdf/convert/to/xml` endpoints with the `rect` parameter value from `rect` output param for this table accordingly.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **inline** optional Must be one of: `true`, or `false`. When `false`, the endpoint returns a link to the `.json` file with the output. |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |\n\nLegacy mode can be enabled like this:\n\n```\n\"profiles\": \"{ 'Mode': 'Legacy'}\"\n```\n\nor with a more detailed config telling min required rows, min columns, and column detection mode. \n\n```\n\"profiles\": \"{ 'Mode': 'Legacy', 'ColumnDetectionMode': 'BorderedTables', 'DetectionMinNumberOfRows': 1, 'DetectionMinNumberOfColumns': 1, 'DetectionMaxNumberOfInvalidSubsequentRowsAllowed': 0, 'DetectionMinNumberOfLineBreaksBetweenTables': 0, 'EnhanceTableBorders': false }\"\n```"
},
"response": [
{
"name": "/pdf/find/table (legacy table finder)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-to-text/sample.pdf\",\n \"async\": \"false\",\n \"inline\": \"true\",\n \"password\": \"\",\n \"profiles\": \"{ 'Mode': 'Legacy', 'ColumnDetectionMode': 'BorderedTables', 'DetectionMinNumberOfRows': 1, 'DetectionMinNumberOfColumns': 1, 'DetectionMaxNumberOfInvalidSubsequentRowsAllowed': 0, 'DetectionMinNumberOfLineBreaksBetweenTables': 0, 'EnhanceTableBorders': false }\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/find/table",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"find",
"table"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"0b61ee05a2e463bbe6707104eabfc589\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "b147b340-6463-4c84-a037-0e7e29d3a62a"
},
{
"key": "X-Runtime",
"value": "0.643841"
},
{
"key": "Date",
"value": "Wed, 19 Jan 2022 12:51:29 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": {\n \"tables\": [\n {\n \"PageIndex\": 0,\n \"X\": 30.72,\n \"Y\": 309.36,\n \"Width\": 533.76,\n \"Height\": 134.16,\n \"Columns\": [\n 163.92,\n 297.36,\n 431.039978\n ],\n \"rect\": \"30.72, 309.36, 533.76, 134.16\"\n }\n ]\n },\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.json\",\n \"remainingCredits\": 98892760,\n \"credits\": 21\n}"
}
]
}
],
"description": "AI powered document analysis can scan your document for `tables` and return the array of tables on pages with `coordinates` and information about `columns` detected in these tables.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "08. PDF Search and Replace Text",
"item": [
{
"name": "/pdf/edit/replace-text (multiple replacements)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-search-and-replace/sample-agreement-template-signature-page-1.pdf\",\r\n \"searchStrings\": [\r\n \"[CLIENT-NAME]\",\r\n \"[CLIENT-COMPANY]\"\r\n ],\r\n \"replaceStrings\": [\r\n \"John Doe\",\r\n \"Skynet 3000\"\r\n ],\r\n \"caseSensitive\": true,\r\n \"replacementLimit\": 1,\r\n \"pages\": \"\",\r\n \"password\":\"\",\r\n \"name\": \"finalFile\",\r\n \"async\": false\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/replace-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"replace-text"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchStrings[]** required The array of strings to search. |\n| **replaceStrings[]** required The array of replacements strings. |\n| **replacementLimit** optional Limit the number of searches & replacements for every item. The default value is `0` which means unlimited searches and replacements so every found occurrence will be replaced. |\n| **caseSensitive** optional Set to `false` to use case-insensitive search. |\n| **regex** optional Set to `true` to use regular expression for a search string(s). |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **password** optional The password of the PDF file, The input must be in string format. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format.n|\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |"
},
"response": [
{
"name": "/pdf/edit/replace-text (multiple replacements)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\r\n \"searchStrings\": [\r\n \"Your Company Name\",\r\n \"Client Name\",\r\n \"Item\"\r\n ],\r\n \"replaceStrings\": [\r\n \"XYZ LLC\",\r\n \"ACME\",\r\n \"SKU\"\r\n ],\r\n \"caseSensitive\": true,\r\n \"replacementLimit\": 1,\r\n \"pages\": \"\",\r\n \"password\":\"\",\r\n \"name\": \"finalFile\" \r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/replace-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"replace-text"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"b87d39aa1a5d766fc834262ee741739b\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "2e65ac94-ed4c-411e-856c-58d40a56f7fb"
},
{
"key": "X-Runtime",
"value": "0.767711"
},
{
"key": "Date",
"value": "Sat, 25 Dec 2021 17:40:27 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/e79f0b9c82984740973ca670d7c93cad/finalFile.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"finalFile.pdf\",\n \"remainingCredits\": 99089875,\n \"credits\": 21\n}"
}
]
},
{
"name": "/pdf/edit/replace-text (single replacement)",
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-search-and-replace/sample-agreement-template-signature-page-1.pdf\",\r\n \"searchString\": \"[CLIENT-NAME]\",\r\n \"replaceString\": \"John Doe\",\r\n \"caseSensitive\": true,\r\n \"replacementLimit\": 1,\r\n \"pages\": \"\",\r\n \"password\":\"\",\r\n \"name\": \"finalFile\",\r\n \"async\": false\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/replace-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"replace-text"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchStrings[]** required The array of strings to search. |\n| **replaceStrings[]** required The array of replacements strings. |\n| **caseSensitive** optional Set to `false` to use case-insensitive search. |\n| **regex** optional Set to `true` to use regular expression for a search string(s). |\n| **replacementLimit** optional Limit the number of searches & replacements for every item. default is `0` which means unlimited searches and replacements so every found occurrence will be replaced. |\n| **name** optional The file name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |"
},
"response": [
{
"name": "/pdf/edit/replace-text",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "async",
"value": "",
"description": "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`.",
"type": "text",
"disabled": true
},
{
"key": "encrypt",
"value": "",
"description": "optional. Enable encryption for the output file. Must be one of: `true`, `false`.",
"type": "text",
"disabled": true
},
{
"key": "file",
"value": "",
"description": "optional. Source PDF file.",
"type": "text",
"disabled": true
},
{
"key": "url",
"value": "pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf",
"description": "optional. URL of the source PDF file. Must be a String.",
"type": "text"
},
{
"key": "name",
"value": "finalFile",
"description": "optional. File name for generated output. Must be a String.",
"type": "text"
},
{
"key": "caseSensitive",
"value": "true",
"description": "optional. `true` or `false`. Set to false by default",
"type": "text"
},
{
"key": "searchString",
"value": "onspicuous feature",
"description": "required for single text replacement. Word to be replaced. Must be a String",
"type": "text"
},
{
"key": "replaceString",
"value": "Replaced1",
"description": "required for single text replacement. Word to be replaced with. Must be a String",
"type": "text"
},
{
"key": "searchStrings",
"value": "",
"description": "required for batch text replacements. Array of words to be replaced. Must contain at least 1 word. Example: `['Hello', 'World']`",
"type": "text",
"disabled": true
},
{
"key": "replaceStrings",
"value": "",
"description": "required for batch text replacements. Array of words to be replaced with. Must contain at least 1 word. Example: `['Hello', 'World']`",
"type": "text",
"disabled": true
},
{
"key": "password",
"value": "",
"description": "optional. Password of PDF file. Must be a String.",
"type": "text",
"disabled": true
},
{
"key": "pages",
"value": "",
"description": "optional. Comma-separated list of page indices (or ranges) to process. IMPORTANT: the very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the end of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document. Must be a String.",
"type": "text",
"disabled": true
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/replace-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"replace-text"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"36fc41db92007c1104ff0226227b5ea9\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "98b47b3d-048f-43d2-a69a-0995a17d35ce"
},
{
"key": "X-Runtime",
"value": "0.651838"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:23:24 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/1a0e9a51e2d04fe4bcce0a6a31c365a8/finalFile.pdf\",\n \"pageCount\": 4,\n \"error\": false,\n \"status\": 200,\n \"name\": \"finalFile\",\n \"remainingCredits\": 98310\n}"
}
]
}
],
"description": "**Description:** Modify a PDF file by searching for specific text and replacing it with new text.\n\n**Note:** PDF.co `/pdf/edit/replace-text` endpoint has certain limitations and restrictions. For adding fully-featured text, we recommend using the PDF.co `pdf/edit/add` endpoint, For more information visit [PDF Add Text, Signatures and Images to PDF](https://apidocs.pdf.co/04-pdf-add-text-signatures-and-images-to-pdf). Additionally, you can utilize the [PDF.co Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to generate a configuration for filling out PDFs. \n\n**Status Errors**\n\n| Code | Description |\n| --- | --- |\n| `200` | The request has succeeded |\n| `400` | bad input parameters |\n| `401` | unauthorized |\n| `403` | not enough credits |\n| `405` | Timeout error. To process large documents or files please use asynchronous mode ( set the `async` parameter to true) and then check the status using the `/job/check` endpoint. If a file contains many pages then specify a page range using the pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info` |\n\n**Example 1: single text replacement**\n\n**GET**\n\n```\nhttps://api.pdf.co/v1/pdf/edit/replace-text?url=pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf&searchString=conspicuous&replaceString=replaced&x-api-key=YOUR-API-KEY\n\n```\n\nor\n\n**POST**\n\n```\n{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-split/sample.pdf\",\n \"searchString\": \"conspicuous feature\",\n \"replaceString\": \"Replaced1\",\n \"caseSensitive\": true,\n \"name\": \"finalFile\"\n}\n\n```\n\nor\n\n**cURL** (uploading your file along with the request)\n\n```\ncurl -F \"x-api-key=PASTE_YOUR_API_KEY_HERE\" -F \"searchString=conspicuous feature\" -F \"replaceString=Replaced1\" -F \"file=@./sample.pdf\" https://api.pdf.co/v1/pdf/edit/replace-text\n\n```\n\n**Example 2: batch texts replacement**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n**POST**\n\n```\n{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-split/sample.pdf\",\n \"searchStrings\": [\n \"conspicuous feature\",\n \"Martian\"\n ],\n \"replaceStrings\": [\n \"Replaced1\",\n \"Replaced2\"\n ],\n \"caseSensitive\": true,\n \"name\": \"finalFile\"\n}\n\n```",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "09. PDF Search and Replace Text with Image",
"item": [
{
"name": "/pdf/edit/replace-text-with-image",
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\r\n \"searchString\": \"Your Company Name\",\r\n \"caseSensitive\": false,\r\n \"replaceImage\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png\",\r\n \"pages\": \"0\",\r\n \"async\": false\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/replace-text-with-image",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"replace-text-with-image"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchString** required Single text replacement. Word or phrase to be replaced, The input must be in string format. |\n| **replaceImage** required Image URL to be inserted in the doc: `http://www.xyz.com/image.png`. |\n| **caseSensitive** optional Set to `false` to use case-insensitive search. |\n| **replacementLimit** optional Limit the number of searches & replacements for every item. The default value is `0` which means unlimited searches and replacements so every found occurrence will be replaced. |\n| **regex** optional Set to `true` to use regular expression for a search string(s). |\n| **name** optional The file name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |"
},
"response": [
{
"name": "/pdf/edit/replace-text-with-image",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\r\n \"searchString\": \"Your Company Name\",\r\n \"caseSensitive\": false,\r\n \"replaceImage\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png\",\r\n \"pages\": \"0\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/replace-text-with-image",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"replace-text-with-image"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"31012649873e920716b27f3d686d4f2f\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "191d40f2-6835-4c9c-be5c-f221b24cd684"
},
{
"key": "X-Runtime",
"value": "0.548920"
},
{
"key": "Date",
"value": "Fri, 17 Dec 2021 20:38:58 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/7ea2b532988742508906cff59be0180e/sample.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.pdf\",\n \"remainingCredits\": 99150679,\n \"credits\": 77\n}"
}
]
},
{
"name": "/pdf/edit/replace-text-with-image (datauri)",
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-search-and-replace/sample-agreement-template-signature-page-2.pdf\",\r\n \"caseSensitive\": \"true\",\r\n \"searchString\": \"[CLIENT-SIGNATURE]\",\r\n \"replaceImage\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAloAAAEuCAYAAABWALygAAAAAXNSR0IArs4c6QAAIABJREFUeF7t3Qv0vdd85/FPa+o2KkQIoUyjFVGt0lpBqekwFXVrdWGUUKLMMHGJW/SyMrNWaQyjaDGiEsVgMUOjSrXMlLqWNKXFMC11GfeWjojbYNZnde/Jd7Zzzu+57vM8Z7/3Wln/5P8/z7P3fu2T/L7Zl+/+LlEQOByBfybptpL+uaSflXSVPXXtTyT91J7qploEEEAAgQUJfNeC2kJTEBgicHVJz5Z0qqQrdXzBRyX9raS/kPTF8Ksf9z9vCtAcxOW//Of574/ZUqcDLQdcFAQQQACBhgUItBoe/APo+l0lnSHp9kf05U0p6HHgk4OrKbt/H0nHSjozBWB+9wMkvWDKSngXAggggMD6BAi01jdmtPhSgWdJemgB8g8hqMqBVS2zz0ryDJvLv5f072pVTD0IIIAAAssUINBa5rjQqm4C3w4fu0DSI9OSYLenp//U+ZJ+Mb3Ws1me1aIggAACCDQsQKDV8OCvvOveI/WR0Ifv33OQ5aa8Km3C99+fK+khKzem+QgggAACIwUItEYC8vjeBG4p6W0LC7S8VHh2aNM1JH1ub0JUjAACCCCwdwECrb0PAQ0YKOAlOi/V5bKEoOZGki6SdNnUqHtKesXA/vEYAggggMABCBBoHcAgNtqF35B0Vuj7Ur7LcZ/WFyTdnTQPjX5D6TYCCCAgaSk/nBgMBPoKfCnkzVraCb+PS7pO6pBntDyzRUEAAQQQaFCAQKvBQT+ALj9c0jNCP5aWHPQcSY8P7WMJ8QC+dHQBAQQQGCIwRaD165JOkvReSc5h9DFJb5H0+SEN4hkEOgi8W9KPpc/9qaSf7PBMzY/4CqDflvRDqdJPSvqJBZyKrGlAXQgggAACEywdxjxGJei3JL1S0qslvQhtBCYSeJqkR61gtsjB1n8P7eT+w4m+ALwGAQQQWJPAmBmtl0u6R8fOeunEP2g46t4RjI9tFYjB/dsl3UGS92stsZTpHk6T9OIlNpQ2IYAAAgjMIzA00Cr/b71L635P0s91+SCfQWCLgK/b8bU7uTwsXSi9ZDDPavnfF5e/k3Qy/8Ox5OGibQgggMC0AkMCLc9ieTZrSPGelfcPeZBnEEh5s/IVN973dO0VqJT/U8LG+BUMGk1EAAEEphIYEmhtWzL0ks43JV0s6cqSvrtopI+8X3eqhvOeJgU8I3Rs6vnTi71aSwZ5rqQHpwZ+WNLt2Bi/5OGibQgggMB0AkMCrTIjt1vzWUnHF81ylmxvgr9Z+v2l5TqaTpE31RC4ejrRevlUmZehvRzdt3iG6d6SvL/L+wb/tu8LBnze9zK+VdIJ6dlnS/KyJwUBBBBA4MAFhgRa/qHh/0P/6WTzxZTTyBt/N5XbSnrTgTvSvfkFHGg5oM/lxyVd2LPactm75r7Bsu4lXILdk4+PI4AAAgj0FRgSaOU6PGPlwp6rvup8fqhAPHE4ZIZ007J3zX2DfxVyazlNxaOHQvAcAggggMA6BMYEWuvoIa08JIF4gm9IoFWmW7BNzZmlMyQ9MwwI//4d0reTviCAAAIbBPgPPV+LNQl8Ipw0HJLawdf2+PqeXL4h6bKVAeKs1gMkvaBy/VSHAAIIIFBRgECrIjZVjRaIS4c+ZHFRzzf6up5bh2d8bdRNer5j7MfjrJpP4noJ3id1KQgggAACByhAoHWAg3qgXSrzUfkE36d69NV3I/qOxFj2MaN0LUl/LumaqSG+A/FtPfrBRxFAAAEEViRAoLWiwWq8qc5D5dOuLk7J4L1VfcrZksqTsddLKSP6vGeKzz5F0mPSi0j1MIUo70AAAQQWKrC0QMtH+H0fomcvnOOIgkAWiCcGhwQn75B0SuB8jiRf6bOPEmfn/H2/xj4aQZ0IIIAAAvMLLCHQ8iyDNzZ/a8MPHM9c/FNJOQBzZvC3SPpfkpyfy8Wf+aqkv5R0ScpI/54BOZbm16aGMQJxf9ZP9QzEnYn9DUXlt0nfpTFtGvpsuQz6s5IuGPoynkMAAQQQWK7AEgKtr1U4+ZUzgDto8wzCuyQ5w/inJX0oBXgO2NyWPvt+ljuyl7bsPinI+MwaGruljWVg0jf3VUwL4SpeJ+ln9uzxlfQddDNOl3TenttD9QgggAACMwjsO9C6oaQPjOzXFyRddcA7fC/jZTY852zj3jjtgOx9KSGrZ9S8YdlZ8P84zbD9xYA6az5SBif72Pg9VX/j/iyPyY17vjjOhvnRJVzs/GpJd0n98HVAt+rZJz6OAAIIILACgX0HWt8ryUfsfa1PLP69R6RlwSumGSd/5oPpjrrjJH2+eManuS4n6f+kexdPTMuOfu6T6Z45b372rNZNJV0pLTnmpcmuw+XlSbcpF8+E+S8HYfFX//1HK92lt6ntPmHngDEXL69eoWsnF/a58yX5jk0X551y0Ni1lAFn3+e71tP3c7FP/n56ls7fIQoCCCCAwAEJ7DvQMqWvITkzXLibeT1z8UspsKpBnoM9B0j+4fylVKlnyxy03T79849IOqlngzz75ff6V//lPWRzX2ZczuK4yX2X3Hp2c7aPezk3p0PoOzPn+wzvFlp2mqQXz9bS7i9+pKTfDB8fcndj99r4JAIIIIDAXgSWEGi549eR5B+IcQYmgwy5aqUGpoMxB2c/Kukq6de+yS+9dywGX1MtR5azONljKePdd3w84+MZSxfvrfIeq67FOas8g+lib2+kX0Ip83ot9Xu+BCvagAACCKxWYGk/eDdd+mtc/5//C1NQsnRsB145APPf+y8vWXYtDga8Sf/1kr4c9ol1fd5B1svS8mn5jNMIeO/Z2kpMzdCnD/eQ5O9ULg64pgpmpzCMm/SXFARO0TfegQACCCAgaWmBlgdl08W//n0vJT5R0ktXOnJxBszBV05P0aU7eR/YmyS9SNLfbHmoDCzKj9W8QLlLv7p+JgYkfb6zMXD3jOnPda2w0ue878x7tXLp07dKTaQaBBBAAIExAkv5D7uDkDPS8tA/SDombVr3fqhYvO/I99X1CVLG+Mz9bJ7xir+670eVV6TTkGWm820zgvl9a90HNCTQ8ixi3Ae3hJOG5biWgdYS23jUd5E/RwABBBDYIbCEQGvXLIyTk/oUoQOxsjxI0vMPcHS97Hh8uuzY+3ic2mBbceJWny78A0lvlPSTxQxJ+VzfRJ9L4fUs3n1TY7pu6I8zo54NvWU44LCUfrkd8XSoA2gHWxQEEEAAgQMRWEKgddQsjDN6O2u8f8Beu3D3n50ryT+gDrk4GPVfnvn6wR0d/YSkb6R7ADflCVtroOU7DnPA2fU7G09dLnmjeZlMtWv/Dvn7Tt8QQACBgxFYwn/Uy+WTbbjeEO9N3r7nrjyd6I3Ent1awrH9ub8cnt17oCSnKdhVfHjgfsUHnJbCmfDXVuKsZ5fvbHmi7wd27Gvbt4XvW3xWaESfzf77bjv1I4AAAggcIdDlh9bciF4qcxDl+968TOj7DJ0Q1MlMy5KTTcZM4fEz3iTuJcUWLqT+HkmPTTNcd0rZ6o8aqyWM91Ft3PTnMRjvss8szpK+UtLPD6m00jO+deCzoS72aVWCpxoEEECghsCSfvDeKG3wdr+dV+vjWwC898ZLQQ7QHGh4RqAsXkr0Cb04U1DDc591eBbHHvfa0oj/IenkfTZwRN0x0Oqy/Ok8W6em+nzI4rdH1F3jUV/rlBPidulfjTZRBwIIIIDABAJLCrQ2dWfb/q24IdoB17+R9LgNL3B297um1BBrzB81ZIi9j+uX056u+PxjJP3HIS9cwDMx0DoqM/yxaVY0N9uZ/Zd+tY0D5P+QGvxkSWctwJwmIIAAAghMILD0QMtd3JRXy6fIfAotJp/0cqODrbM3uHiT+K+le/ImYFv8Kxx8fiS00hvD/8WKl1QdLF+Q+nPUjI9nhjxD5LKWU3xOY+JrmVx8uOMhi/+G0UAEEEAAgU4Cawi03JF86s6/5uJg685b7gz057xp3Ne1xAurfSm1N82/WdI7Owmt80NloOVerGWsN4nHK4WOOkEY9+/9fprRXMMoeqncS+bOI+crnSgIIIAAAgcgsKYfvt4s/wvFkpg3vfv3fOnwtuKM4LeWdLXiA/6B7ecPceP8DSV9IPT3kpQAdq1f2Rg4HhVoxXQJR312SR5xX9laM/gvyZO2IIAAAosQWFOgZTAf03faAiefzKXrUssTJD1pg7oDLW+cL7OsL2KABjYiLp/5FX8p6T9JcuqAz4QgzHvYfLrTlzbfJizFXjiw3rkec1oKb+Z3ySdPt9XlJdM8i/lbkh4+V6Mmfm/ch9Y1KevETeB1CCCAAAJTC6wt0HL/fTrRQVFcRuwzc+FTaDfeknHd7/kzSa8dAO3lrZtIunlKGupXOIBzIBevghnw6t6PxKW23g9LcqDlrPPeVO8l2iUUp+44MZ043RUUO1WCUya4OMhysLWGEnOF3UHSH62h0bQRAQQQQGC3wBoDrdyjMqO2Lwz2MmGfsu1Uo2fJfHl1l2VFz7B4o/n3bal4H5cZb8sz1sfGn/V+ofMkPU2SDxTss+SZKgetXlrbVuL34qiN8/vsT1n3cZLyyVifQHz8khpHWxBAAAEEhgmsOdByj+MPVQdF/sE6pHhT/ekpaWp83pvmny7pVRte2jWjvR+tvRQUZ3WGeJTPvD3NbnUJPKeob9M7PAbep7cr0PJMlr8T9nZZU6Dl9uZ7D9e0iX+u8ea9CCCAwEEIrD3QKmdufC3NmGt4rpz2cT2sGF3/4PMs12vS779LkjOUdylfSZnuu3x2is/8V0l3L170BUmevfPMmw8OOBi5lqTLSvLG+WMkeUbFJS+7lW3xPi7vc/MeuX2U8yU5uHXZtVk8XtLsNAket7WUeD/j2v/dXIs57UQAAQRmFTiE/5jHWS1f3+MAaIo9UV7yc7Z1H7nPxSkhHKBcd8Oo+DJnXyF0heLPPCP2qFlH8dKXO7fYizbU1Xdmx8HaCZJuUbzrYkmP3lPwck5YTvPF2n+9xXQtl0lvan6eifQM4q0qfWeoBgEEEEBgRoFDCLR8wsz5sTw743JU5vC+nL+SrrbxrM+24g3Xf5gSZDpxai5OqHrTvhWO+Hy5b82v+uqG4K9rFd6g/bw04xWfydcgdX3PFJ+Lm8V33XcYAy3foXnmFJVXeserJd0l1XUI/25WYqMaBBBAYLkCh/Ifc99ll5f75pgN8CyWr0kpZ6Y8A3GKpH8i6X9uGObrSfpYxeHftDfLM1z3G9EGn/J0wOhLrGOZOqA9qom+0zLfXblrSfDzIWeagywHW2spb5B0u9RYL+n6fyAoCCCAAAIrFjiUQMsn/hwM+J47l3um2aWphuaOabksLiPmdzu/k38olsWzS94TVbN8eMOJvCmuoXGw5YDlp0NnXinp5yt2LiYt3TVTtdZTh6Z8r6QfTqa7lkcrslMVAggggMAYgUMJtGwQ70R07qdTJ0xJEDdiuy6nOviopJ/Ygv91SZcbMzADn3ViUucIi8Uzfc8e+L74mLPr/2n4De/XcrLTWsXBXs7p9daU7X9T3WsOtOJ3uPZJ1VrjSD0IIIBAUwKHFGiVSTqnmtVyNvpyWTBvLvcPfgcAsbxD0uv3lGn+Ikk/WrSn70b4bf8C3Kc40ems8j6lWbPEE4XbltbiZ6aYzavZPy+NeonUZapxq9l+6kIAAQQQKAQOKdBy134n5cPy34/JqxWZ/J7bht+IAVyZS8sJPp2T6y17+qZ9WtLxRd1TBZxlIOsgs5w9m6rbN0in7uzumUMHkP9NkjeLux27ApG4GX6q78BU/TrqPTFdyZMlnXXUA/w5AggggMCyBQ4t0HL+KKcmyMV3++Vs20NGwnuy/MM9nxz0Hqjrhxd535D3C+VEmr+7p5ksN2lbAtWplg7LQGvqIMYzh05PcfaWgXIQeZmQ52vbZvw1B1rRuM+1UkO+2zyDAAIIIFBB4NACLZPFPTpjgwxfPRNPGjrg8qb7snj58P0VxmtbFVeR5Ctq/Ktn1WIqiql+YMf9Q7kdY78/nrn6BUk+RXjNnn7b+hUDrTlOoPZsZq+PR+OpA9leDeHDCCCAAALTCIz9QTlNK6Z9y1Q/rJwh3ctjOVP6Pu4s7Crjtt0tBVl/X5w8dI4vX648tpQzWt635kBpSPHyqhOf5mXAIe/4q3BCLz6/5vQOU313h3jyDAIIIIDADAKHGGiZ6X+HE3G7rmvZRVrO4Ey112nqYfSyZb6L0Rdr+0JipwbI5UmSnHR1bPEme++VymVoMtZNG/bLtvndntH5QEop4Rxe3q8VZ+qciPUmkj4UHna+M18VlMvaNpTH/YBrS7Y69vvF8wgggMBBChxqoOV7/ZxJ3GXofXcx+edST695qdCBi/eKvSedOIyn7tz/qRKLxjxWfu9LJPkkYp+y645I78FycPvcLS908Oi+xZOO5fKar0zyZ3LZlUG+T7trfdZXRznJrcsTJf1qrYqpBwEEEEBgHoFDDbScYPS1icy5pX6kJ99cqSJ6NuPIj/sexUekT+X9Yw5UfHotlzcXpyaPfOmWD5QmTtR6co+Xbdrj5cuufQm4k586aDqqxGt48mfjXq2yjrV9v2NwP3Qm9ihD/hwBBBBAoKLA2n4Q9aHx5nDPwrj0/aH1Mkn3Ss/61KJPLy6txMDnGZIemRpYzhoNXeIr++tg1bNmuXgm7WYdUXx603u6Lh8+/xhJF3YMsPJjTpD6Rkk3D+/xOzxz5RLHfFdS047NrvqxOBvHRviq9FSGAAIIzCdwyIHW/SW9INF55qe8p3CbasxA7s9MdWpvylGMS4bOM+Wgy8tOLj5pd4tQ2VSBll8ZT/T1yfNUnt4ck/W8nLFzu/LysIPi41Lfz02/P6X7nO+KObScyT/f3TlnnbwbAQQQQGBmgUMOtHxa0JfyXjX9uuk+wk28cfnJG6v/5Z5TN2xqY9w0XW74jukt/KyXo8okpkO/VjHQ6hqAlkuO3ovlTetDy6Z8YfbwXjTPaOUy1d60oe3s+9yUaUn61s3nEUAAAQRmEjjkQMtkztCe7yO8tyQvCR5VfIXOKelDfWbCjnrvVH8eA8G4ZJjf/9SUOiH/s9M9XG2CysuN5l1njDbNQPVdyo3N35aY1e+MgZbzmnnmbA3FG+DzjKTbu+16oTX0hTYigAACCASBQw+0+uYl+iVJDiByOUHSpxb0jXEqB19w7aXDfMqwbN45kh4ffvNrxd6ood0Zmhl+0yb4MbNNvgvQdwKW5QmSfiP85tt2XPo91GCu5+Kl5WvbWzaXCe9FAAEEDkLg0AOtMjjwMuIXd4zcMyWdkf58qkSfU31RYh6rcl9WrOPXN+TN8ozJx0Y2ZGigdSdJrynqHpMuo5xZy6/29UgnhnqeEy5oHtn1WR8vLy0fE4TO2lBejgACCCDQX+DQAy2LfEnSlRLNrh9ivqfwfoFwSTY+Pek9PPkU5bargNx8/9mfF1+FKYKOMtB6Z7Hpfte37xOSrh0+MCarfNmObfUuNcFs2d7nS3pg+k1OG/b/bxhPIIAAAosWWFIwMRdUvp7G73cw5T0+ZfHpRJ9SzOVBkvwDcAnFy4QOsjyj5XsMvXy4K+eUT91tukh7irH+sqQrJpQ+Geedc+ukgLlt2bOrd0zjcEloU37+4pSS4ytdX7inz8Wg0TnFnAD2dXtqC9UigAACCMwgMMUP3xmaNekrnV/K15m4eNnQy4exlNe2TJkOYWxHHGT5eh3/QHaQ5b7klBW73u17AONG8G9IuuzYxhQXdve53uaFkk4L9Xc9sbityTGx56bP+FqeGNhN0PXJXxHH1i/3oYF/PXktvBABBBBAYK8CLQRa5dUxZYBQbta+y4Y9RfsYJP8gdoCYZ+D6BCevT3cE5nY7LcOxR+xP69LHmIKgT6Dl63p86jMXt+/ULhVu+cxTJDnh6bZynqTTR7y/xqPl9+6o/YM12kQdCCCAAAITC7QQaJnMs1S+gNilDFhi8LCULPAOshws+JLoTW0+6mvwPEle/oxlinv/4j2Kfe6QLFNOjM3tVZ6s9Lg5b1ouS9+f5fH1UmEubIA/6hvNnyOAAAIrFWgl0Ip3Ar4pLcV5yMos8EvIyB1nsr4lyacf8/U6Xb9mcQ9TfqbPDNS2eoYkLPW7HPQ5+MvFe6h8nc7Q8mhJDt42lW+mww9fHfryCs/FhLPx+1ihaqpAAAEEEKgp0Eqg5Q3k3uuUS16mKU+wTRGMjB2/+EN42+b9o+qoEWh5+e5xRzUk/bmz6/9R+KxPgl6547ObPrYtxYM/6wDrCiPePfejZcLVXSdI524L70cAAQQQmFmglUDLjHE2xktyPo1Y7pNxTqO/mdl82+t9qtDBYE7hMGamwyfXyj1QY7Kx5zbHVBnO1/VrHa0eLslZ7GPxRd2bTkd2eaVnw7z8GC+pjs/9sCQfCFhaKdN0bMrsv7Q20x4EEEAAgRECLQVacaYo/4CLMz++jPlWIyzHPFoGfENnsnIbylkTp1c4eUwD07NDN8OXBxL8urGzh76HctudiTeTdNEE/Z36FXEJ20lnHVzvSqA7df28DwEEEECgskBLgVYMZvJsUUykuY9M8F669PUreRbLw/8oSf6BPKb4fT6x6CVT36HnwM39H1O82dyBVk4b0SdQ8rOegYrFwaDbNbR45jFmgo/vWeJm+HL5Os+qDu0/zyGAAAIIrECgpUArXmHjofE9hp4VyaVP4DB2aGMglN/lGQ4HH7uSkfat15v9fbnyFKXcz9bn1KHrL3N7+Voep9IYWuLsWvmOJ0s6a+iLZ3jOBxw8e+pfXcYsC8/QPF6JAAIIIDCXQEuBlg09u+N7/1w8axRP843ZM9RnfOLykZ9zIlL/3tgZpz5tGPLZMtDqk9crez8iVDw2iequQKtv24Z49Hkm3k7g8XagzZJhH0E+iwACCKxUoLVAK16146ArL9nVuGOu3Ozur4z3ijnIcluWXsYGWmVKhq/t2MzexaLchxafOVeSZ9yWUMp2smS4hFGhDQgggEAlgdYCrXKfTGZ+q6Rbz2Tu5SLP5MQZqwvSbNoaAqzMUgZaffe0ORWEl/RiuaGkDw503xVoLWVGy8G1Z97ykiGnDAcONo8hgAACaxVoLdDyOHnJ5piU7iH3f+wpv23j7+DEiTqdNsLFy0YOELyUtMbiHFWXSw3vc6m0Hykv7vbvjdkXdw9JL9+CuJRM6/FGAvZlrfEbT5sRQACBkQItBlpT/8DfNATlZvevS3ppuLdw5LDt7fG4L8o5v+7eoyXvkuRrgGIZE2iVM2zxvUsItOL3jFQOPb4ofBQBBBA4JIEWA61Ny4djfuCX3wdvsPdSYd7/5Vks/55/8K69xBQZvh7oDEm+tqhLKU8d+pmxSVRjEtrYhtMkvbhLo2b6jMfb6TVcHGT5O+fZLQoCCCCAQGMCLQZaHuJLimta+qYq2PQ1cWDlWR7vy8nl0H7I3q/IffUKSc5Z1aVsylY/9vu37eThnSX9QZdGzfAZz7T5e5D3ZXHFzgzIvBIBBBBYi8DYH3Rr6WfZzmdJemj4zbGnDsvM7n619+R4JuPQjvF/WtLxwa5rctByqe9Dkk4a+QXatBzpV47N0TW0WfGKnbXvxxtqwHMIIIAAAkGg1UDLR+xfGRyGnjp08OAlojiLtZa8WEP/RSiDyi9L8p4oz24dVZz1/kxJvu7Ibv51TNm2T+sLko4d8+KBz/o06V3ToYdDWS4eSMFjCCCAAAIWaDXQct+/Kem709fgVyT5FF3X4mWhs4uEp352juzuXdtU63OetfkzSb5WJxbv1fIpQM/k1SqeWfMM26biq4KmyorfpT/5FKRPZjqNxdIT0HbpE59BAAEEEBgp0Gqg5cuI4/U7XZe/zL3pfkL/vmcznLrh0JYKN33FnHz0iSHVQ/yMl2GfX3Ez+h3T7OTli4bWDLRiqoml5PAa+Z8GHkcAAQQQmEKg1UDLdvHEWpdM4p7F8nKXg6lYWt2L4+Ai/1V+Fz8n6QYVg854ys9tGZt1vs+/W3Epdexevz718lkEEEAAgRUItBpoeSO8N8Tn8mFJ198xXr8q6fSQsiF/1IlO/UO+hVmsbTxPleQZrrLUnFFy3U7n4Nmt96blyxpLd0+T5H1nLj5V+TMr+HeeJiKAAAIIVBRoNdDadErwYRtyQt1b0oPTcmEcFu9DcoBFbqR/VHHm+/tKuoWkO0h6oaT7V/we167qlinA8oyei2dEnZDWM1oUBBBAAAEE/p9Aq4HWpvxLcdnH+7Cc9PKBG74rPmHnK3RansXa9a+Q7Q454CiXKb2c7JOUFAQQQAABBL5DYMpAy/937yW5q0r6kqSPSHqspM8s0D3uz/LFzjmLu9M+OKu7g4WyePbKf76mi6AXSL/aJvk78qLi8vEpbxRYLQwNRwABBBDYLjBVoLXr3jnvW/H+lSUV51nKmbtfnXIfbWvf+yR5H9IhXKGzpDFYU1s25Uub6t+dNTnQVgQQQACBngJT/bB4btrLtKn6iyV9b892zf1xz7blWazPSzpG0vdsqNRH9b0MdshLYXNbr/39zu7v5cH8fXHgfeO1d4r2I4AAAgjUEZgq0PLmZ+9p2lamqmcKlV2zb36/Z7ucE+s5KTHnFHXyjnUKlIcmnrEhSe06e0arEUAAAQSqCEwVAMU9T2XDPWNUZhGv0rktlTxI0vN2NIB9N/scneXU7QMPdwvNcRqHpy+nebQEAQQQQGANAlMFWptO8eX+f0rSCQvCOC/dzbetSd/PhvcFjVb9pvjeylcVOdN8CMKBFwUBBBBAAIFeAlMFWr6O5Ze31PxGSbfv1ap5P+zM7ueHKi6R9PuS7pV+jxmtef2X/HYvKzvIygclfHel92iRL23Jo0bbEEAAgQULTBVo+WThS9Km8rK775HkWYKlFG9q9uZm/wC9UNJr0mzFRamBzpPFCcOljFa9dpT5sZyU1kE56TzqjQE1IYAAAgcnMFWgZZh4HUmE8mzATRcodyNJ7w/tyvvMuBQjt9UQAAASTUlEQVR4gYM1c5PK/Vhsep8ZnNcjgAACrQhMGWidKOmcdNFw9FvLRbvO9O40Dz5x6NkuyuELeInQ+wvzjKsvCPdJQza9H/7Y00MEEECgisCUgVZusH9IObt6Lu9Md+BV6dCIShwQ3jbtx1niDNyIrvHoBgEvITvIyvmxvB/LS4XkTOPrggACCCAwmcAcgdaPSXp3aKEv3H3IZC2e70U50PKeHJ88pByuQLnp3bOY3qPFfqzDHXN6hgACCOxFYI5Aq0wIupalwzgTN4fLXgaYSr9DwMvCPnWaTxayJ48vCQIIIIDAbAJzBBRrDbRiFnByac32ldvri2NqD+/H8j+TH2uvQ0LlCCCAwGELzBFoec+L7xLMxakSnDJh6SUe7yeX1tJHq1/7PHv1eElnpce8H8v/Q8BSYT9HPo0AAggg0FNgjkDLF0j7vsDLpLY8RdLjerZrHx/3kpKTVboQaO1jBOap00HW2WkP1tclvTTNZM1TG29FAAEEEEAgCMwRaPn1vt/waqke733yPXFLLzHQ4sqVpY9Wt/bF5LReKvR30UvEFAQQQAABBKoIzBVovU7SqakHvlvw9Cq9GVdJ3FtGoDXOcglPx/QNDrK8NEzG/yWMDG1AAAEEGhKYK9C6o6TXJkffI3jXFZjGQItreFYwYDua6ASkzpHlZUPyY617LGk9AgggsGqBuQIto3xc0nWSzpz1TDUAMdDyUifZwaeSrfuemL7BM1keVy6FrjsG1IYAAgggUCEAenm4jmcNuYoItNb/r0U8OeqZLM9s+WolCgIIIIAAAnsRmHOmydfw5Fmhz0m6xl562L3SuBmeGa3ubkv5ZMyD9qZ0XyVB1lJGh3YggAACjQrMGWiZ9NvB1T8IPbO11BIDLfZoLXWUNrfLm9zvn/6IIGtdY0drEUAAgYMWmDvQ8nKclxCvnhQfK+mpCxWNy06cOpxnkPx98F+5XC9tVvdl3jl5qJf8XL6STq7+Z0mflfTXkt6/oVnlTFZ8/zy94K0IIIAAAgh0FJg70HIzHizpuaE9S00GSqDV8Uuz5WM5wLmBpBMlOXHt8ZKuKenvJZ0gyReOjynld8fX59wtvfAZKYXDmPfzLAIIIIAAApMK1Ai03OCXSbpXavkrJN1z0l5M87I4M7LUYHCank73FqftuEM69JBnLad6+/skXTfNbOX9fT8u6cKUtsFZ/HNwx566qdR5DwIIIIDApAK1Ai03+h2STgmtr1l3FzRv3PcGfhcCrd1iTttxZo+M/3lZ0ElE/yS9+nfTr1+W5MMS+TP+9bh0u0BuxZ0k+XN+1rmxnCPLJwpJRNrlm81nEEAAAQT2JlA72IkpH9zph0v6rb31/v+vmEDr6IH4AUnPlOSA6eQtH/9k2kv1YUlvTzmspspj5eDqolQviUiPHi8+gQACCCCwZ4HagVbMGJ+77pOI/uHtfTz7LG+WdJvUAGa0vnMkvEznpcJN91Z6Oc83AHhZeNOG9SnG9V+lC6H9Lp8s/MUwCzbF+3kHAggggAACkwvUDrTcAc+KPCkkM/XveT+ON8zva3bLbXpe2PPzg+mU2+TgK37hsyQ9tGi/gysvIfpE4FzFS4Vnp43uF0t6Ppve56LmvQgggAACUwvsI9DKffDm81tLul3o1Acl/VtJb5i6o1ved+d0KvIu4c89O+NN15RLBW6UguH8Ow6MPbP1xzMjeYnyN1PyUfZjzYzN6xFAAAEEphfYZ6AVAy7PWMTiTc/eLO1ElFOWG0u6dloCu0fI7xXrcMoA59GiXCoQT2T6d72M6OW7OYv3Y/lkoYOt96RZrLyRfs56eTcCCCCAAAKTCSwh0HJnvN/mMZJ+qOjZOyX9YTptNuaH7H0lnV4ky9yE+DZJ92Hvz3fQ+JRfTqXgcfAetjlLzNLvIMv/nE8lzlkv70YAAQQQQGBSgaUEWnmWxLmYfDJxU3EKgNenma4uS4t+18PSvqKjcjx55uQ8Sa+ZVPdwXvZ3ko5N3XmIpHNn7Fq8TueCFGTNWB2vRgABBBBAYD6BJQVauZde0jtNUtw3VQp8KN2j+G5JvyPJ2cidedxXuXjmxScYryjp8jvovM/IgVWeMZtPed1vdpD6sWB5q5S2YepeeYnw/DBz5tOoXrKkIIAAAgggsFqBJQZaGdMB090lnTGhrjdWO43DW1OSzAlffbCvcuCbZxmdu8oB0dTF1x95n55PGLLpfWpd3ocAAgggsDeBJQdaESVfRnwtSc6ndOUeYp65+i+SXjxzGoIeTVrVR2Nah6lnmcpZLAdyHmv2Y63qK0JjEUAAAQS2Cawl0Irtv6qkJ0g6SdL108yULzDOFxZ7s/ZLJX1ckpcWvbeLMlwgnjh8dtr3Nvxt//hkzo3lQxD+exdfCu26vjj25TyPAAIIIIDAUgTWGGgtxa6VdsRAa4oLwb0U7JsAcvGpQgdcU13T08q40E8EEEAAgRUIEGitYJD23EQv5Tm9g4sPGXyfpEsGtMl7vZxZPqeJ8CseMEOutAFN4xEEEEAAAQTmESDQmsf10N76DkmnpE7dLFzs3KWfzir/iJSBP3/+yZLOYZmwCx+fQQABBBBYswCB1ppHr17bnxYuk35JSup6VO2+P9J5zHyiMBcvQzpocz40CgIIIIAAAgcvQKB18EM8WQe/Hd7kzPDbMvV7BsvLgz6tmIv3duW/JmsQL0IAAQQQQGDpAgRaSx+h5bQv7tX6REqV4fsOb5hOeB4n6eYbrlGaOiXEckRoCQIIIIAAAkcIEGjxFekj4BODXv7L1/FsezbnLvOs15g7Kvu0jc8igAACCCCwOAECrcUNyeIb5JktZ3H3rznnlfOV+Vqk30snEy9cfC9oIAIIIIAAAhUECLQqIFMFAggggAACCLQpQKDV5rjTawQQQAABBBCoIECgVQGZKhBAAAEEEECgTQECrTbHnV4jgAACCCCAQAUBAq0KyFSBAAIIIIAAAm0KEGi1Oe70GgEEEEAAAQQqCBBoVUCmCgQQQAABBBBoU4BAq81xp9cIIIAAAgggUEGAQKsCMlUggAACCCCAQJsCBFptjju9RgABBBBAAIEKAgRaFZCpAgEEEEAAAQTaFCDQanPc6TUCCCCAAAIIVBAg0KqATBUIIIAAAggg0KYAgVab406vEUAAAQQQQKCCAIFWBWSqQAABBBBAAIE2BQi02hx3eo0AAggggAACFQQItCogUwUCCCCAAAIItClAoNXmuNNrBBBAAAEEEKggQKBVAZkqEEAAAQQQQKBNAQKtNsedXiOAAAIIIIBABQECrQrIVIEAAggggAACbQoQaLU57vQaAQQQQAABBCoIEGhVQKYKBBBAAAEEEGhTgECrzXGn1wgggAACCCBQQYBAqwIyVSCAAAIIIIBAmwIEWm2OO71GAAEEEEAAgQoCBFoVkKkCAQQQQAABBNoUINBqc9zpNQIIIIAAAghUECDQqoBMFQgggAACCCDQpgCBVpvjTq8RQAABBBBAoIIAgVYFZKpAAAEEEEAAgTYFCLTaHHd6jQACCCCAAAIVBAi0KiBTBQIIIIAAAgi0KUCg1ea402sEEEAAAQQQqCBAoFUBmSoQQAABBBBAoE0BAq02x51eI4AAAggggEAFAQKtCshUgQACCCCAAAJtChBotTnu9BoBBBBAAAEEKggQaFVApgoEEEAAAQQQaFOAQKvNcafXCCCAAAIIIFBBgECrAjJVIIAAAggggECbAgRabY47vUYAAQQQQACBCgIEWhWQqQIBBBBAAAEE2hQg0Gpz3Ok1AggggAACCFQQINCqgEwVCCCAAAIIINCmAIFWm+NOrxFAAAEEEECgggCBVgVkqkAAAQQQQACBNgUItNocd3qNAAIIIIAAAhUECLQqIFMFAggggAACCLQpQKDV5rjTawQQQAABBBCoIECgVQGZKhBAAAEEEECgTQECrTbHnV4jgAACCCCAQAUBAq0KyFSBAAIIIIAAAm0KEGi1Oe70GgEEEEAAAQQqCBBoVUCmCgQQQAABBBBoU4BAq81xp9cIIIAAAgggUEGAQKsCMlUggAACCCCAQJsCBFptjju9RgABBBBAAIEKAgRaFZCpAgEEEEAAAQTaFCDQanPc6TUCCCCAAAIIVBAg0KqATBUIIIAAAggg0KYAgVab406vEUAAAQQQQKCCAIFWBWSqQAABBBBAAIE2BQi02hx3eo0AAggggAACFQQItCogUwUCCCCAAAIItClAoNXmuNNrBBBAAAEEEKggQKBVAZkqEEAAAQQQQKBNAQKtNsedXiOAAAIIIIBABQECrQrIVIEAAggggAACbQoQaLU57vQaAQQQQAABBCoIEGhVQKYKBBBAAAEEEGhTgECrzXGn1wgggAACCCBQQYBAqwIyVSCAAAIIIIBAmwIEWm2OO71GAAEEEEAAgQoCBFoVkKkCAQQQQAABBNoUINBqc9zpNQIIIIAAAghUECDQqoBMFQgggAACCCDQpgCBVpvjTq8RQAABBBBAoIIAgVYFZKpAAAEEEEAAgTYFCLTaHHd6jQACCCCAAAIVBAi0KiBTBQIIIIAAAgi0KUCg1ea402sEEEAAAQQQqCBAoFUBmSoQQAABBBBAoE0BAq02x51eI4AAAggggEAFAQKtCshUgQACCCCAAAJtChBotTnu9BoBBBBAAAEEKggQaFVApgoEEEAAAQQQaFOAQKvNcafXCCCAAAIIIFBBgECrAjJVIIAAAggggECbAgRabY47vUYAAQQQQACBCgIEWhWQqQIBBBBAAAEE2hQg0Gpz3Ok1AggggAACCFQQINCqgEwVCCCAAAIIINCmAIFWm+NOrxFAAAEEEECgggCBVgVkqkAAAQQQQACBNgUItNocd3qNAAIIIIAAAhUECLQqIFMFAggggAACCLQpQKDV5rjTawQQQAABBBCoIECgVQGZKhBAAAEEEECgTQECrTbHnV4jgAACCCCAQAUBAq0KyFSBAAIIIIAAAm0KEGi1Oe70GgEEEEAAAQQqCBBoVUCmCgQQQAABBBBoU4BAq81xp9cIIIAAAgggUEGAQKsCMlUggAACCCCAQJsCBFptjju9RgABBBBAAIEKAgRaFZCpAgEEEEAAAQTaFCDQanPc6TUCCCCAAAIIVBAg0KqATBUIIIAAAggg0KYAgVab406vEUAAAQQQQKCCAIFWBWSqQAABBBBAAIE2BQi02hx3eo0AAggggAACFQQItCogUwUCCCCAAAIItClAoNXmuNNrBBBAAAEEEKggQKBVAZkqEEAAAQQQQKBNAQKtNsedXiOAAAIIIIBABQECrQrIVIEAAggggAACbQoQaLU57vQaAQQQQAABBCoIEGhVQKYKBBBAAAEEEGhTgECrzXGn1wgggAACCCBQQYBAqwIyVSCAAAIIIIBAmwIEWm2OO71GAAEEEEAAgQoCBFoVkKkCAQQQQAABBNoUINBqc9zpNQIIIIAAAghUECDQqoBMFQgggAACCCDQpgCBVpvjTq8RQAABBBBAoIIAgVYFZKpAAAEEEEAAgTYFCLTaHHd6jQACCCCAAAIVBAi0KiBTBQIIIIAAAgi0KUCg1ea402sEEEAAAQQQqCBAoFUBmSoQQAABBBBAoE0BAq02x51eI4AAAggggEAFAQKtCshUgQACCCCAAAJtChBotTnu9BoBBBBAAAEEKggQaFVApgoEEEAAAQQQaFOAQKvNcafXCCCAAAIIIFBBgECrAjJVIIAAAggggECbAgRabY47vUYAAQQQQACBCgIEWhWQqQIBBBBAAAEE2hQg0Gpz3Ok1AggggAACCFQQINCqgEwVCCCAAAIIINCmAIFWm+NOrxFAAAEEEECgggCBVgVkqkAAAQQQQACBNgUItNocd3qNAAIIIIAAAhUECLQqIFMFAggggAACCLQpQKDV5rjTawQQQAABBBCoIECgVQGZKhBAAAEEEECgTQECrTbHnV4jgAACCCCAQAUBAq0KyFSBAAIIIIAAAm0KEGi1Oe70GgEEEEAAAQQqCBBoVUCmCgQQQAABBBBoU4BAq81xp9cIIIAAAgggUEGAQKsCMlUggAACCCCAQJsCBFptjju9RgABBBBAAIEKAgRaFZCpAgEEEEAAAQTaFCDQanPc6TUCCCCAAAIIVBAg0KqATBUIIIAAAggg0KYAgVab406vEUAAAQQQQKCCAIFWBWSqQAABBBBAAIE2BQi02hx3eo0AAggggAACFQQItCogUwUCCCCAAAIItClAoNXmuNNrBBBAAAEEEKgg8H8BB/pmif/QXBwAAAAASUVORK5CYII=\",\r\n \"pages\": \"0\",\r\n \"async\": false\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/replace-text-with-image",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"replace-text-with-image"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchString** required Single text replacement. Word or phrase to be replaced, The input must be in string format. |\n| **replaceImage** required Image URL to be inserted in the doc: `http://www.xyz.com/image.png`. |\n| **caseSensitive** optional Set to `false` to use case-insensitive search. |\n| **replacementLimit** optional Limit the number of searches & replacements for every item. The default value is `0` which means unlimited searches and replacements so every found occurrence will be replaced. |\n| **regex** optional Set to `true` to use regular expression for a search string(s). |\n| **name** optional The file name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |"
},
"response": [
{
"name": "/pdf/edit/replace-text-with-image",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\r\n \"searchString\": \"Your Company Name\",\r\n \"caseSensitive\": false,\r\n \"replaceImage\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png\",\r\n \"pages\": \"0\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/replace-text-with-image",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"replace-text-with-image"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"31012649873e920716b27f3d686d4f2f\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "191d40f2-6835-4c9c-be5c-f221b24cd684"
},
{
"key": "X-Runtime",
"value": "0.548920"
},
{
"key": "Date",
"value": "Fri, 17 Dec 2021 20:38:58 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/7ea2b532988742508906cff59be0180e/sample.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.pdf\",\n \"remainingCredits\": 99150679,\n \"credits\": 77\n}"
}
]
}
],
"description": "The `/pdf/edit/replace-text-with-image` endpoint allows you to replace specific text in a PDF document with an image.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "10. PDF Search and Delete Text from PDF",
"item": [
{
"name": "/pdf/edit/delete-text (single replacement)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\n \"name\": \"pdfWithTextDeleted\",\n \"caseSensitive\": \"false\",\n \"searchString\": \"Invoice\",\n \"replacementLimit\": 0,\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/delete-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"delete-text"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchStrings[]** required The array of strings to search. |\n| **caseSensitive** optional Set to `false` to use case-insensitive search. |\n| **regex** optional Set to `true` to use regular expression for a search string(s). |\n| **replacementLimit** optional Limit the number of searches & replacements for every item. The default value is `0` which means unlimited searches and replacements so every found occurrence will be replaced. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/edit/delete-text (single replacement)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\n \"name\": \"pdfWithTextDeleted\",\n \"caseSensitive\": \"false\",\n \"searchString\": \"Invoice\",\n \"replacementLimit\": 0,\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/delete-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"delete-text"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"1f56fd7813234684767d5d35285f7470\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "1592ceb4-45b0-421f-b981-f35e97c49e9a"
},
{
"key": "X-Runtime",
"value": "0.476526"
},
{
"key": "Date",
"value": "Mon, 20 Feb 2023 20:55:20 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/ZOSEQZFNVCYLD5N5CJFVIYQKBVLR8OKD/pdfWithTextDeleted.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzECYaDKOO4WmO5C5shyOYYSKCAVsAo6VkB5HQjTBd9dMlJujQdEkPfNdPeLfq2mF54s2ESZBmIAJ5UgDUo3J9R475CCS4M3nuuo%2FSJwRy5gNiJdb1ZY0uCtP87x83nH%2B%2BSDu5JK%2F%2BEOrd3MREt8KE3BsQOrv%2FKMdnK%2BT5nJ2x2hC87vHue%2FudY7%2FWX54vx4tfFobEyhEozLbPnwYyKOdEsYYWH7e8tm7XV4UeKxCoKMaXSEPvOod80hR62qXnEI42fOsON3M%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHLUVIAIPX/20230220/us-west-2/s3/aws4_request&X-Amz-Date=20230220T205521Z&X-Amz-SignedHeaders=host&X-Amz-Signature=9f79c1a30d4f373e495e735e908375dad2ae6dcafcee761a477748c2b8298605\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"pdfWithTextDeleted.pdf\",\n \"credits\": 21,\n \"duration\": 189,\n \"remainingCredits\": 96235635\n}"
}
]
},
{
"name": "/pdf/edit/delete-text (delete and draw color)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\n \"name\": \"pdfWithTextDeleted\",\n \"searchString\": \"Item \\\\d+\", \n \"regex\": true,\n \"replacementLimit\": 0,\n \"caseSensitive\": \"false\",\n \"async\": false,\n \"profiles\": \"{'UsePatch': true, 'PatchColor': '#000000'}\"\n\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/delete-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"delete-text"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchStrings[]** required The array of strings to search. |\n| **caseSensitive** optional Set to `false` to use case-insensitive search. |\n| **regex** optional Set to `true` to use regular expression for a search string(s). |\n| **replacementLimit** optional Limit the number of searches & replacements for every item. The default value is `0` which means unlimited searches and replacements so every found occurrence will be replaced. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/edit/delete-text (delete and draw color)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\n \"name\": \"pdfWithTextDeleted\",\n \"searchString\": \"Item \\\\d+\", \n \"regex\": true,\n \"replacementLimit\": 0,\n \"caseSensitive\": \"false\",\n \"async\": false,\n \"profiles\": \"{'UsePatch': true, 'PatchColor': '#000000'}\"\n\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/delete-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"delete-text"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"e9b255e0f11512ee1744741a2d99934e\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "4e95e3d1-eecc-4950-a49e-63d7630a6e08"
},
{
"key": "X-Runtime",
"value": "0.426585"
},
{
"key": "Date",
"value": "Mon, 20 Feb 2023 20:55:04 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/80D3II85OQALU98Z0OGU4TN4YH9ORQ15/pdfWithTextDeleted.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzECYaDKOO4WmO5C5shyOYYSKCAVsAo6VkB5HQjTBd9dMlJujQdEkPfNdPeLfq2mF54s2ESZBmIAJ5UgDUo3J9R475CCS4M3nuuo%2FSJwRy5gNiJdb1ZY0uCtP87x83nH%2B%2BSDu5JK%2F%2BEOrd3MREt8KE3BsQOrv%2FKMdnK%2BT5nJ2x2hC87vHue%2FudY7%2FWX54vx4tfFobEyhEozLbPnwYyKOdEsYYWH7e8tm7XV4UeKxCoKMaXSEPvOod80hR62qXnEI42fOsON3M%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHLUVIAIPX/20230220/us-west-2/s3/aws4_request&X-Amz-Date=20230220T205504Z&X-Amz-SignedHeaders=host&X-Amz-Signature=0c2208da9014a70728ccefd588ebb9d4d33e54d6763172b3757dff861b7d39b5\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"pdfWithTextDeleted.pdf\",\n \"credits\": 21,\n \"duration\": 143,\n \"remainingCredits\": 96235656\n}"
}
]
},
{
"name": "/pdf/edit/delete-text (multiple replacements)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-search-and-replace/sample-agreement-template-signature-page-1.pdf\",\n \"searchStrings\": [\n \"[CLIENT-NAME]\",\n \"[CLIENT-COMPANY]\",\n \"[CLIENT-SIGNATURE]\",\n \"1 FEB 2023\"\n ],\n \"replacementLimit\": 2,\n \"async\": false,\n \"profiles\": \"{'UsePatch': true, 'PatchColor': '#000000'}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/delete-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"delete-text"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchStrings[]** required The array of strings to search. |\n| **caseSensitive** optional Set to `false` to use case-insensitive search. |\n| **replacementLimit** optional Limit the number of searches & replacements for every item. The default value is `0` which means unlimited searches and replacements so every found occurrence will be replaced. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **password** optional Password of the PDF file, The input must be in string format. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/edit/delete-text (multiple replacements)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-search-and-replace/sample-agreement-template-signature-page-1.pdf\",\n \"searchStrings\": [\n \"[CLIENT-NAME]\",\n \"[CLIENT-COMPANY]\",\n \"[CLIENT-SIGNATURE]\",\n \"1 FEB 2023\"\n ],\n \"replacementLimit\": 2,\n \"async\": false,\n \"profiles\": \"{'UsePatch': true, 'PatchColor': '#000000'}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/delete-text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"delete-text"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"24f443b8171a9f68cbf40903866be81f\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "b808def4-2f87-431d-9383-4aabd4f5be96"
},
{
"key": "X-Runtime",
"value": "0.512271"
},
{
"key": "Date",
"value": "Mon, 20 Feb 2023 20:55:38 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/BLPL4O4MECWCBUCXETUHINLSBZ9BM08B/sample-agreement-template-signature-page-1.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzECYaDKOO4WmO5C5shyOYYSKCAVsAo6VkB5HQjTBd9dMlJujQdEkPfNdPeLfq2mF54s2ESZBmIAJ5UgDUo3J9R475CCS4M3nuuo%2FSJwRy5gNiJdb1ZY0uCtP87x83nH%2B%2BSDu5JK%2F%2BEOrd3MREt8KE3BsQOrv%2FKMdnK%2BT5nJ2x2hC87vHue%2FudY7%2FWX54vx4tfFobEyhEozLbPnwYyKOdEsYYWH7e8tm7XV4UeKxCoKMaXSEPvOod80hR62qXnEI42fOsON3M%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHLUVIAIPX/20230220/us-west-2/s3/aws4_request&X-Amz-Date=20230220T205538Z&X-Amz-SignedHeaders=host&X-Amz-Signature=89c5cc5d28774ddb315f2d421e552d286f7228212f12a49152c7c4d0b034e9f6\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample-agreement-template-signature-page-1.pdf\",\n \"credits\": 21,\n \"duration\": 211,\n \"remainingCredits\": 96235614\n}"
}
]
}
],
"description": "Search text in PDF and remove found text from PDF.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "11. PDF Make Text Searchable or Unsearchable",
"item": [
{
"name": "/pdf/makesearchable (Scanned PDF to Text Searchable PDF)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-make-searchable/sample.pdf\",\n \"lang\": \"eng\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makesearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makesearchable"
]
},
"description": "This method converts scanned PDF documents (where pages are fully or partially made from scanned images) into a text-searchable pdf. It runs OCR and adds an invisible text layer on top of your document that can be used for text search, text indexing etc.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/makesearchable (Scanned PDF to Text Searchable PDF)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-make-searchable/sample.pdf\",\n \"lang\": \"eng\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makesearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makesearchable"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"eb8a7495f2cd368ea60765fa1651c3fc\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "71e8cd1e-68a3-456d-afff-128987e03149"
},
{
"key": "X-Runtime",
"value": "7.237967"
},
{
"key": "Date",
"value": "Sat, 01 Jan 2022 12:24:00 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/a0d52f35504e47148d1771fce875db7b/result.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 99033681,\n \"credits\": 35\n}"
}
]
},
{
"name": "/pdf/makesearchable (PNG to Text Searchable PDF)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image1.png\",\n \"lang\": \"eng\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makesearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makesearchable"
]
},
"description": "This method converts scanned PDF documents (where pages are fully or partially made from scanned images) into a text-searchable pdf. It runs OCR and adds an invisible text layer on top of your document that can be used for text search, text indexing, etc.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format., The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/makesearchable (PNG to Text Searchable PDF)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image1.png\",\n \"lang\": \"eng\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makesearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makesearchable"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"84ee4be0f1e800113333811567e4bc87\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "238aac87-264c-4813-b3ba-a3c281cb6fbd"
},
{
"key": "X-Runtime",
"value": "3.144671"
},
{
"key": "Date",
"value": "Mon, 27 Dec 2021 15:44:33 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/cd2613bd41d44e81b3f989bf25c69bf3/result.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 99078416,\n \"credits\": 35\n}"
}
]
},
{
"name": "/pdf/makesearchable (JPG to Text Searchable PDF)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image2.jpg\",\n \"lang\": \"eng\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makesearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makesearchable"
]
},
"description": "This method converts scanned PDF documents (where pages are fully or partially made from scanned images) into a text-searchable pdf. It runs OCR and adds an invisible text layer on top of your document that can be used for text search, text indexing, etc.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format.|\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/makesearchable (JPG to Text Searchable PDF)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image2.jpg\",\n \"lang\": \"eng\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makesearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makesearchable"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"0f9cfa22e9990ed95e99725ac8138776\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "b1cc80bc-2223-4414-b4ef-adcbc548310a"
},
{
"key": "X-Runtime",
"value": "3.226544"
},
{
"key": "Date",
"value": "Mon, 27 Dec 2021 15:45:56 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/26ef98ed86ff4a27a3c840ab7785e25a/result.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 99078346,\n \"credits\": 35\n}"
}
]
},
{
"name": "/pdf/makesearchable (TIF to Text Searchable PDF)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image2.jpg\",\n \"lang\": \"eng\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makesearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makesearchable"
]
},
"description": "This method converts scanned PDF documents (where pages are fully or partially made from scanned images) into a text-searchable pdf. It runs OCR and adds an invisible text layer on top of your document that can be used for text search, text indexing, etc.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/makesearchable (TIF to Text Searchable PDF)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image2.jpg\",\n \"lang\": \"eng\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makesearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makesearchable"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"990edddf2db1e1bdbfb8c787523ca100\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "ed850e5c-72d9-4fa1-9b08-3c5253dcff3b"
},
{
"key": "X-Runtime",
"value": "2.802299"
},
{
"key": "Date",
"value": "Mon, 27 Dec 2021 15:47:02 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/d5a27d3d1e9a4ef7be31f513a95cef7b/result.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 99078311,\n \"credits\": 35\n}"
}
]
},
{
"name": "/pdf/makeunsearchable (PDF to Scanned PDF)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-to-text/sample.pdf\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makeunsearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makeunsearchable"
]
},
"description": "This method converts PDF files into \"text unsearchable\" pdf which are the same as if you printed and then scanned your PDF. In other words, this method converts your pdf into a \"scanned\" pdf file where everything is turned into an image.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **password** optional Password of PDF file, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format.|\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/makeunsearchable (PDF to Scanned PDF)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-to-text/sample.pdf\",\n \"pages\": \"\",\n \"name\": \"result.pdf\", \n \"password\": \"\",\n \"async\": \"false\",\n \"profiles\": \"\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/makeunsearchable",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"makeunsearchable"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"6ae68b8472ef259e36ac52442370b84f\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "6899ff7a-9f76-4008-ab05-372c89f209e1"
},
{
"key": "X-Runtime",
"value": "1.704618"
},
{
"key": "Date",
"value": "Thu, 27 May 2021 12:53:47 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/6b755238963a472abf67fd5e7ffafd79/result.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 327244,\n \"credits\": 35\n}"
}
]
}
],
"description": "These methods helps to turn PDF and scanned JPG, PNG images into text-searchable PDF.\nMakeUnSearchable method is doing the opposite: converts PDF document into a \"scanned\" pdf document is it was printed and then scanned back.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "12. PDF To CSV",
"item": [
{
"name": "/pdf/convert/to/csv",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-csv/sample.pdf\",\n \"lang\": \"eng\",\n \"inline\": \"true\",\n \"unwrap\": \"\",\n \"pages\": \"0-\",\n \"rect\": \"\",\n \"async\": \"false\",\n \n \"name\": \"result.csv\",\n \"password\": \"\",\n \"lineGrouping\": \"\",\n \"profiles\": \"\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/csv",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"csv"
]
},
"description": "**Auto classification Of Incoming Documents**\n\nUse the `/pdf/classifier` (Document Classifier) endpoint to automatically sort/detect the class of the document based on keywords-based rules. For example, you can define rules to find which vendor provided the document to find which template to apply accordingly.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **unwrap** optional Unwrap lines into a single line within table cells when `lineGrouping` is enabled. Must be one of: `true`, or `false`. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **lineGrouping** optional Line grouping within table cells. Set to `1` to enable the grouping, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n | **profiles** optional This parameter can be used to set additional configurations for fine-tuning and to enable more options. Visit [PDF.co knowledgebase](https://apidocs.pdf.co/kb/) for profile examples and more. Make sure to provide the input in string format. For instance, to alter the CSV separator, you can use: `{ 'CSVSeparatorSymbol': ';' }`. **Tip:** Utilize the OCR Analyzer of [PDF Multitool](https://bytescout.com/products/pdfmultitool/index.html) to generate and examine OCR configuration profiles. [Learn More](https://apidocs.pdf.co/kb/General/pdf-multitool-ocr-analyzer). |"
},
"response": [
{
"name": "/pdf/convert/to/csv",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-csv/sample.pdf\",\n \"lang\": \"eng\",\n \"inline\": \"true\",\n \"unwrap\": \"\",\n \"pages\": \"0-\",\n \"rect\": \"\",\n \"async\": \"false\",\n \n \"name\": \"result.csv\",\n \"password\": \"\",\n \"lineGrouping\": \"\",\n \"profiles\": \"\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/csv",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"csv"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"3f70bf91917aadcf92fefbd8603c4847\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "34d9bf05-8dec-4978-b359-75b41943296a"
},
{
"key": "X-Runtime",
"value": "0.491030"
},
{
"key": "Date",
"value": "Sat, 17 Apr 2021 14:37:17 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": \"\\\"Your Company Name\\\",\\\"\\\",\\\"\\\",\\\"\\\",\\r\\n\\\"Your Address\\\",\\\"\\\",\\\"\\\",\\\"\\\",\\r\\n\\\"City, State Zip\\\",\\\"\\\",\\\"\\\",\\\"\\\",\\r\\n\\\"\\\",\\\"\\\",\\\"\\\",\\\"Invoice No. 123456\\\",\\r\\n\\\"\\\",\\\"\\\",\\\"\\\",\\\"Invoice Date 01/01/2016\\\",\\r\\n\\\"Client Name\\\",\\\"\\\",\\\"\\\",\\\"\\\",\\r\\n\\\"Address\\\",\\\"\\\",\\\"\\\",\\\"\\\",\\r\\n\\\"City, State Zip\\\",\\\"\\\",\\\"\\\",\\\"\\\",\\r\\n\\\"Notes\\\",\\\"\\\",\\\"\\\",\\\"\\\",\\r\\n\\\"Item\\\",\\\"Quantity\\\",\\\"Price\\\",\\\"Total\\\",\\r\\n\\\"Item 1\\\",\\\"1\\\",\\\"40.00\\\",\\\"40.00\\\",\\r\\n\\\"Item 2\\\",\\\"2\\\",\\\"30.00\\\",\\\"60.00\\\",\\r\\n\\\"Item 3\\\",\\\"3\\\",\\\"20.00\\\",\\\"60.00\\\",\\r\\n\\\"Item 4\\\",\\\"4\\\",\\\"10.00\\\",\\\"40.00\\\",\\r\\n\\\"\\\",\\\"\\\",\\\"TOTAL\\\",\\\"200.00\\\",\\r\\n\",\n \"pageCount\": 2,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.csv\",\n \"remainingCredits\": 616411,\n \"credits\": 56\n}"
}
]
}
],
"description": "Convert PDF and scanned images into CSV representation with layout, columns, rows, and tables.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "13. PDF To JSON",
"item": [
{
"name": "/pdf/convert/to/json2",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-json/sample.pdf\",\n \"inline\": true,\n \"async\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/json2",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"json2"
]
},
"description": "**Auto classification Of Incoming Documents**\n\nUse the `/pdf/classifier` (Document Classifier) endpoint to automatically sort/detect the class of the document based on keywords-based rules. For example, you can define rules to find which vendor provided the document to find which template to apply accordingly.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **unwrap** optional Unwrap lines into a single line within table cells when `lineGrouping` is enabled. Must be one of: `true`, or `false`. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **lineGrouping** optional Line grouping within table cells. Set to `1` to enable the grouping, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **unwrap** optional Unwrap lines into a single line within table cells when `line grouping` is enabled. Must be one of: `true`, or `false`. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **lineGrouping** optional Line grouping within table cells. Set to `1` to enable the grouping, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, , The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-Separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document. |\n| **unwrap** optional Unwrap lines into a single line within table cells when `lineGrouping` is enabled. Must be one of: `true`, or `false`. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. | \n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **lineGrouping** optional Line grouping within table cells. Set to `1` to enable the grouping, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional This parameter can be used to set additional configurations for fine-tuning and to enable more options. Visit [PDF.co knowledgebase](https://apidocs.pdf.co/kb/) for profile examples and more. Make sure to provide the input in string format. For instance, to alter the CSV separator, you can use: `{ 'CSVSeparatorSymbol': ';' }`. **Tip:** Utilize the OCR Analyzer of [PDF Multitool](https://bytescout.com/products/pdfmultitool/index.html) to generate and examine OCR configuration profiles. [Learn More](https://apidocs.pdf.co/kb/General/pdf-multitool-ocr-analyzer). |"
},
"response": [
{
"name": "/pdf/convert/to/text (with layout and ocr)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\n \"inline\": true\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/text",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"text"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"830f2156cb4776fb3cce596cbcc8fece\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "e98e0d8c-79c3-4b6d-b763-c73729e41231"
},
{
"key": "X-Runtime",
"value": "0.378792"
},
{
"key": "Date",
"value": "Sat, 01 Jan 2022 12:25:31 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": \" Your Company Name \\r\\n Your Address \\r\\n City, State Zip \\r\\n Invoice No. 123456 \\r\\n Invoice Date 01/01/2016 \\r\\n Client Name \\r\\n Address \\r\\n City, State Zip \\r\\n\\r\\n Notes \\r\\n\\r\\n\\r\\n Item Quantity Price Total \\r\\n Item 1 1 40.00 40.00 \\r\\n Item 2 2 30.00 60.00 \\r\\n Item 3 3 20.00 60.00 \\r\\n Item 4 4 10.00 40.00 \\r\\n TOTAL 200.00\\r\\n\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.txt\",\n \"remainingCredits\": 99032333,\n \"credits\": 21\n}"
}
]
},
{
"name": "/pdf/convert/to/text-simple (no layout and ocr, cheaper and faster)",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\n \"inline\": true,\n \"async\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/text-simple",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"text-simple"
]
},
"description": "**Note:** This pdf to plain text endpoint works **faster and requires much fewer credits** because not using AI-powered layout analysis, OCR support, and also no support for profiles for fine-tuning. For advanced pdf-to-text with layout analysis, OCR (for scanned pages), pdf repair, and other features please use the `pdf/convert/to/text` endpoint instead.\n\n**Auto classification Of Incoming Documents**\n\nUse the `/pdf/classifier` (Document Classifier) endpoint to automatically sort/detect the class of the document based on keywords-based rules. For example, you can define rules to find which vendor provided the document to find which template to apply accordingly.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |"
},
"response": [
{
"name": "/pdf/convert/to/text-simple",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-text/sample.pdf\",\n \"inline\": true\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/text-simple",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"text-simple"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"d475ef881bc88052cf79b7cba1c713cd\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "dac9fe38-abe4-4d37-a009-5e56b0d45bb5"
},
{
"key": "X-Runtime",
"value": "0.397620"
},
{
"key": "Date",
"value": "Tue, 17 Aug 2021 14:04:20 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": \"Your Company Name \\r\\nYour Address \\r\\nCity, State Zip \\r\\nInvoice No. 123456 \\r\\nInvoice Date 01/01/2016 \\r\\nClient Name \\r\\nAddress \\r\\nCity, State Zip \\r\\nNotes \\r\\nItem Quantity Price Total \\r\\nItem 1 1 40.00 40.00 \\r\\nItem 2 2 30.00 60.00 \\r\\nItem 3 3 20.00 60.00 \\r\\nItem 4 4 10.00 40.00 \\r\\nTOTAL 200.00 \\r\\n\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.txt\",\n \"remainingCredits\": 99885491,\n \"credits\": 2\n}"
}
]
}
],
"description": "Convert PDF and scanned images to Text with layout preserved.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "15. PDF To XLS",
"item": [
{
"name": "/pdf/convert/to/xls (xls output)",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-excel/sample.pdf\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/xls",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"xls"
]
},
"description": "**Auto classification Of Incoming Documents**\n\nUse the `/pdf/classifier` (Document Classifier) endpoint to automatically sort/detect the class of the document based on keywords-based rules. For example, you can define rules to find which vendor provided the document to find which template to apply accordingly.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **unwrap** optional Unwrap lines into a single line within table cells when `lineGrouping` is enabled. Must be one of: `true`, or `false`. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **lineGrouping** optional Line grouping within table cells. Set to `1` to enable the grouping, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional This parameter can be used to set additional configurations for fine-tuning and to enable more options. Visit [PDF.co knowledgebase](https://apidocs.pdf.co/kb/) for profile examples and more. Make sure to provide the input in string format. For instance, to alter the CSV separator, you can use: `{ 'CSVSeparatorSymbol': ';' }`. **Tip:** Utilize the OCR Analyzer of [PDF Multitool](https://bytescout.com/products/pdfmultitool/index.html) to generate and examine OCR configuration profiles. [Learn More](https://apidocs.pdf.co/kb/General/pdf-multitool-ocr-analyzer). |"
},
"response": [
{
"name": "/pdf/convert/to/xls",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-excel/sample.pdf\" \n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/xls",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"xls"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"5da78a46681927218641923722aa97e3\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "1854994c-11e0-49bb-bbd5-8e085d5361cf"
},
{
"key": "X-Runtime",
"value": "1.006418"
},
{
"key": "Date",
"value": "Wed, 26 Aug 2020 14:05:32 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/544e26441de7451ab287152b7159d350/sample.xls\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.xls\",\n \"remainingCredits\": 60572\n}"
}
]
}
],
"description": "Convert PDF and scanned images to spreadsheet with layout and fonts preserved.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "16. PDF To XLSX",
"item": [
{
"name": "/pdf/convert/to/xls (xlsx output)",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-excel/sample.pdf\",\r\n \"async\": false\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/xlsx?=",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"xlsx"
],
"query": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "",
"value": ""
}
]
},
"description": "**Auto classification Of Incoming Documents**\n\nUse `/pdf/classifier` (Document Classifier) endpoint to automatically sort/detect the class of the document based on keywords-based rules. For example, you can define rules to find which vendor provided the document to find which template to apply accordingly.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **unwrap** optional Unwrap lines into a single line within table cells when `lineGrouping` is enabled. Must be one of: `true`, or `false`. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **lineGrouping** optional Line grouping within table cells. Set to `1` to enable the grouping, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional This parameter can be used to set additional configurations for fine-tuning and to enable more options. Visit [PDF.co knowledgebase](https://apidocs.pdf.co/kb/) for profile examples and more. Make sure to provide the input in string format. For instance, to alter the CSV separator, you can use: `{ 'CSVSeparatorSymbol': ';' }`. **Tip:** Utilize the OCR Analyzer of [PDF Multitool](https://bytescout.com/products/pdfmultitool/index.html) to generate and examine OCR configuration profiles. [Learn More](https://apidocs.pdf.co/kb/General/pdf-multitool-ocr-analyzer). |"
},
"response": [
{
"name": "/pdf/convert/to/xls",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-to-excel/sample.pdf\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/xlsx?x-api-key={{x-api-key}}",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"xlsx"
],
"query": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n"
},
{
"key": "",
"value": "",
"disabled": true
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"6a55880390151d1dffa47b5026eb15a4\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "01f9964d-239c-4080-8154-b4e156a9d90d"
},
{
"key": "X-Runtime",
"value": "0.729814"
},
{
"key": "Date",
"value": "Wed, 26 Aug 2020 14:06:51 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/60c6b9f50280495a9567f73a0a394252/sample.xlsx\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.xlsx\",\n \"remainingCredits\": 60568\n}"
}
]
}
],
"description": "Convert PDF to spreadsheet with layout and fonts preserved.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "17. PDF To XML",
"item": [
{
"name": "/pdf/convert/to/xml",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-xml/sample.pdf\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/xml",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"xml"
]
},
"description": "**Auto classification Of Incoming Documents**\n\nUse the `/pdf/classifier` (Document Classifier) endpoint to automatically sort/detect the class of the document based on keywords-based rules. For example, you can define rules to find which vendor provided the document to find which template to apply accordingly.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **unwrap** optional Unwrap lines into a single line within table cells when `lineGrouping` is enabled. Must be one of: `true`, or `false`. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **lineGrouping** optional Line grouping within table cells. Set to `1` to enable the grouping, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional This parameter can be used to set additional configurations for fine-tuning and to enable more options. Visit [PDF.co knowledgebase](https://apidocs.pdf.co/kb/) for profile examples and more. Make sure to provide the input in string format. For instance, to alter the CSV separator, you can use: `{ 'CSVSeparatorSymbol': ';' }`. **Tip:** Utilize the OCR Analyzer of [PDF Multitool](https://bytescout.com/products/pdfmultitool/index.html) to generate and examine OCR configuration profiles. [Learn More](https://apidocs.pdf.co/kb/General/pdf-multitool-ocr-analyzer). |"
},
"response": [
{
"name": "/pdf/convert/to/xml",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-xml/sample.pdf\",\n \"inline\": true\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/xml",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"xml"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"7c092ba1d14c026526224fd4e1d6a407\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "c081e4f1-50b9-4fef-900c-1846a719fe43"
},
{
"key": "X-Runtime",
"value": "0.482020"
},
{
"key": "Date",
"value": "Wed, 26 Aug 2020 14:07:48 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"body\": \"\\r\\n\\r\\n \\r\\n \\r\\n \\r\\n Your Company Name\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Your Address\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n City, State Zip\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Invoice No. 123456\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Invoice Date 01/01/2016\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Client Name\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Address\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n City, State Zip\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Notes\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Item\\r\\n \\r\\n \\r\\n Quantity\\r\\n \\r\\n \\r\\n Price\\r\\n \\r\\n \\r\\n Total\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Item 1\\r\\n \\r\\n \\r\\n 1\\r\\n \\r\\n \\r\\n 40.00\\r\\n \\r\\n \\r\\n 40.00\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Item 2\\r\\n \\r\\n \\r\\n 2\\r\\n \\r\\n \\r\\n 30.00\\r\\n \\r\\n \\r\\n 60.00\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Item 3\\r\\n \\r\\n \\r\\n 3\\r\\n \\r\\n \\r\\n 20.00\\r\\n \\r\\n \\r\\n 60.00\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n Item 4\\r\\n \\r\\n \\r\\n 4\\r\\n \\r\\n \\r\\n 10.00\\r\\n \\r\\n \\r\\n 40.00\\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n \\r\\n TOTAL\\r\\n \\r\\n \\r\\n 200.00\\r\\n \\r\\n \\r\\n \\r\\n\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.xml\",\n \"remainingCredits\": 60563\n}"
}
]
}
],
"description": "Convert PDF to XML with information about text value, tables, fonts, images, objects positions.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "18. PDF to HTML",
"item": [
{
"name": "/pdf/convert/to/html",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"inline\": false,\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"html"
]
},
"description": "**Auto classification Of Incoming Documents**\n\nUse the `/pdf/classifier` (Document Classifier) endpoint to automatically sort/detect the class of the document based on keywords-based rules. For example, you can define rules to find which vendor provided the document to find which template to apply accordingly.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format.|\n| **unwrap** optional Unwrap lines into a single line within table cells when `lineGrouping` is enabled. Must be one of: `true`, or `false`. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **lineGrouping** optional Line grouping within table cells. Set to `1` to enable the grouping, The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional You can set additional and extra options using this parameter that allows you to set custom configuration, The input must be in string format. For example, to turn On/Off layers for rendering: |\n \n ```\n {\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"pages\": \"0\",\n \"profiles\": \"{'RenderTextObjects': false, 'RenderVectorObjects': true,'RenderImageObjects': true}\"\n }\n \n ```\n \n See [profiles samples](https://apidocs.pdf.co/profiles) for examples."
},
"response": [
{
"name": "/pdf/convert/to/jpg",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"inline\": true,\n \"pages\": \"0\"\n}\n",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/jpg",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"jpg"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"7f975fe0c72e4567de5cb8d6eeaf517c\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "01c10b3e-e130-4c4f-b050-269e89d706a8"
},
{
"key": "X-Runtime",
"value": "0.637387"
},
{
"key": "Date",
"value": "Mon, 24 Aug 2020 19:35:59 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"urls\": [\n \"https://pdf-temp-files.s3.amazonaws.com/163425dc6d0244c4a281d3e1a244c68a/sample.jpg\"\n ],\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.jpg\",\n \"remainingCredits\": 60728\n}"
}
]
}
],
"description": "**Description:** PDF to JPG conversion. High-quality rendering. Also works great for thumbnail generation and previews. `GET` or `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set the `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using the pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or HTTP header param (preferred) to the API key, get yours [here](https://app.pdf.co/signup)\n\n\n**POST**\n\n```\n{\n\t\"pages\" : \"\",\n\t\"password\" : \"\",\n\t\"url\" : \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\"\n}\n```",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "20. PDF to PNG",
"item": [
{
"name": "/pdf/convert/to/png",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"inline\": true,\n \"pages\": \"0-\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/png",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"png"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options, The input must be in string format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. For example, to turn on / off layers for rendering: |\n \n```\n {\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"pages\": \"0\",\n \"profiles\": \"{'RenderTextObjects': false, 'RenderVectorObjects': true,'RenderImageObjects': true}\"\n }\n \n```\nSee [profiles samples](https://apidocs.pdf.co/profiles) for examples."
},
"response": [
{
"name": "/pdf/convert/to/png",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"inline\": true,\n \"pages\": \"0-\"\n\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/png",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"png"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"e4f834a766e4e266164381040b19fda7\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "fcd15276-c1a0-4b91-af92-a82bde3953df"
},
{
"key": "X-Runtime",
"value": "1.139699"
},
{
"key": "Date",
"value": "Thu, 03 Feb 2022 09:36:14 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"urls\": [\n \"https://pdf-temp-files.s3.amazonaws.com/c15b8d82e0034d01a73eac719d69349b/sample.png\",\n \"https://pdf-temp-files.s3.amazonaws.com/152d2fe414b645e38f81a49e5dafa85b/sample.png\"\n ],\n \"pageCount\": 2,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.png\",\n \"duration\": 1121,\n \"remainingCredits\": 98722216,\n \"credits\": 30\n}"
}
]
}
],
"description": "**Description:** PDF to PNG conversion. High quality rendering. Also works great for thumbnail generation and previews. `GET` or `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example**\n\nSample Request:\n\n!! ! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n\n**POST**\n\n```\n{\n\t\"pages\" : \"\",\n\t\"password\" : \"\",\n\t\"url\" : \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\"\n}\n```",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "20.1. PDF to WEBP",
"item": [
{
"name": "/pdf/convert/to/webp",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"inline\": true,\n \"pages\": \"0-\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/webp",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"webp"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **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. |\n\nExample: you can control WebP image quality from `0..100` where 0 - is the lowest quality, smallest file size; 100 - is the best quality, largest file size). Default is `75` (better and smaller than JPEG with the same quality settings):\n\n```\n{ 'WEBPQuality': 75 }\n\n```\n\nAnother example: turn on / off layers for rendering:\n\n```\n{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"pages\": \"0\",\n \"profiles\": \"{'RenderTextObjects': false, 'RenderVectorObjects': true,'RenderImageObjects': true}\"\n}\n\n```\n\nSee [profiles samples](https://apidocs.pdf.co/profiles) for examples."
},
"response": [
{
"name": "/pdf/convert/to/webp",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"pages\": \"0\"\n}\n",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/webp",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"webp"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"8e30bc7eef01cf5422f5e5bad6df319e\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "e2b0965e-8459-49af-a202-2d1902d2a8af"
},
{
"key": "X-Runtime",
"value": "0.652455"
},
{
"key": "Date",
"value": "Mon, 24 Aug 2020 19:46:33 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"urls\": [\n \"https://pdf-temp-files.s3.amazonaws.com/c9f65eaac1e740cf9aadc2f102e571ec/sample.webp\"\n ],\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.png\",\n \"remainingCredits\": 60716\n}"
}
]
}
],
"description": "**Description:** PDF to WeBP conversion. High quality rendering. Also works great for thumbnail generation and previews. `GET` or `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example**\n\nSample Request:\n\n!! ! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n\n**POST**\n\n```\n{\n\t\"pages\" : \"\",\n\t\"password\" : \"\",\n\t\"url\" : \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\"\n}\n```",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "21. PDF to TIFF",
"item": [
{
"name": "/pdf/convert/to/tiff",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"inline\": true,\n \"pages\": \"0-\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/tiff",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"tiff"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **rect** optional Defines coordinates for extraction, e.g. `51.8, 114.8, 235.5, 204.0`. Use [PDF.co PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure pdf coordinates. The input must be in string format. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options, The input must be in string format. For example, to turn on / off layers for rendering: |\n \n```\n {\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\n \"pages\": \"0\",\n \"profiles\": \"{'RenderTextObjects': false, 'RenderVectorObjects': true,'RenderImageObjects': true}\"\n }\n \n```\n \nSee [profiles samples](https://apidocs.pdf.co/profiles) for examples."
},
"response": [
{
"name": "/pdf/convert/to/tiff",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\",\r\n \"pages\": \"0-\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/tiff",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"tiff"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"db0b80ee77f59b05f67947fc1110ac11\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "477dac23-3608-4916-9003-44fde90ebd4a"
},
{
"key": "X-Runtime",
"value": "2.788509"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:30:25 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/e6fb9be16cd14a8c94e94cdcef2afb45/result.tiff\",\n \"pageCount\": 2,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.tiff\",\n \"remainingCredits\": 98162\n}"
}
]
}
],
"description": "**Description:** PDF to high quality TIFF images conversion. High quality rendering. Also works great for thumbnail generation and previews. `GET` or `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n\n**POST**\n\n```\n{\n\t\"name\" : \"result.tiff\",\n\t\"pages\" : \"\",\n\t\"password\" : \"\",\n\t\"url\" : \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-image/sample.pdf\"\n}\n```",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "22. PDF from CSV (CSV to PDF)",
"item": [
{
"name": "/pdf/convert/from/csv",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/csv-to-pdf/sample.csv\",\n \"pages\": \"0-\",\n \"name\": \"result.pdf\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/csv",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"csv"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configuration for fine-tuning and extra options, The input must be in string format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples."
},
"response": [
{
"name": "/pdf/convert/from/csv",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/csv-to-pdf/sample.csv\",\r\n \"pages\": \"0-\",\r\n \"name\": \"result.pdf\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/csv",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"csv"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"3389e3350ecf526a61b6f5c6fec27ace\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "bf72b429-2d19-4e9c-93e9-b2621e28794a"
},
{
"key": "X-Runtime",
"value": "0.502831"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:02:52 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/01ede81738a44b4fa5a6b909115ae0a3/result.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 98506\n}"
}
]
}
],
"description": "**Description:** Convert CSV, XLS, XLSX to PDF conversion. `GET` or `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n```\nPOST\n{\n\t\"name\" : \"result.pdf\",\n\t\"pages\" : \"\",\n\t\"url\" : \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/csv-to-pdf/sample.csv\"\n}\n```\n",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "23. PDF from Doc, DocX, RTF, TXT, XPS (Document to PDF)",
"item": [
{
"name": "/pdf/convert/from/doc",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/doc-to-pdf/sample.docx\",\n \"pages\": \"0-\",\n \"name\": \"result.pdf\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/doc",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"doc"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document, The input must be in string format. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options, The input must be in string format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "POST /pdf/convert/from/doc",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
},
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/doc-to-pdf/sample.docx\",\r\n \"pages\": \"0-\",\r\n \"name\": \"result.pdf\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/doc",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"doc"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"1bb76fe96e2df543d501e151e4ce85ba\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "67debf97-aefc-492f-830f-c1b41610c68f"
},
{
"key": "X-Runtime",
"value": "3.926574"
},
{
"key": "Date",
"value": "Wed, 12 Aug 2020 10:33:02 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/efc283805b4a47da87910826d4ddf063/result.pdf?X-Amz-Expires=3600&x-amz-security-token=FwoGZXIvYXdzEKz%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDFzXkfTapcUbLLKahiKBAbIL4F2wV3gvozuGDxmOpWUu9ETuVzkYKjMuNLAFzVZeSgRm9Yuaj7ubad9uOLQkL65GNgBQoy1Xm%2FxtLWD9tegUYd3hFvYfIWMfkWjuROwMGTZeD3CMacDPdFkP%2BUSG4aXOZb8MoG2PXnsd9UUeOvrevZkCVTg77OBXIteBCPOojSjeis%2F5BTIoVCi%2FrwV5kEGkbfBwtgsfQL3MxSbg7j%2Fud%2F3oGbUWW7zsemcfiHTiFg%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHAK44PZ6O/20200812/us-west-2/s3/aws4_request&X-Amz-Date=20200812T103301Z&X-Amz-SignedHeaders=host;x-amz-security-token&X-Amz-Signature=6a176281828de74c917a4ff5bacd46eeca50221178bf34d01cac331f172e51c3\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 61165\n}"
}
]
}
],
"description": "**Description:** Convert DOC, DOCX, RTF, TXT, XPS files into PDF. `GET` or `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n```\nPOST\n{\n\t\"name\" : \"result.pdf\",\n\t\"url\" : \"pdfco-test-files.s3.us-west-2.amazonaws.comdoc-to-pdf/sample.docx\"\n}\n```\n",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "24. PDF from URL (URL to PDF)",
"item": [
{
"name": "/pdf/convert/from/url",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://wikipedia.org/wiki/Wikipedia:Contact_us\",\n \"margins\": \"5mm\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"mediaType\": \"print\",\n \"async\": false,\n \"profiles\": \"{ \\\"CustomScript\\\": \\\";; // put some custom js script here \\\"}\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"url"
]
},
"description": "Generate PDF from URL or link to HTML page. You can set the following parameters:\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **margins** optional Set to CSS style margins like `10px`, `5mm`, `5in` for all sides or `5px 5px 5px 5px` (the order of margins is `top`, `right`, `bottom`, `left`). |\n| **paperSize** optional `Letter` is set by default. Can be `Letter`, `Legal`, `Tabloid`, `Ledger`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6` or a custom size. Custom size can be set in `px` (pixels), `mm` or `in` (inches) with width and height separated by space like this: `200 300`, `200px 300px`, `200mm 300mm`, `20cm 30cm` or `6in 8in`. |\n| **orientation** optional Set to `Portrait` or `Landscape`. `Portrait` by default. |\n| **printBackground** optional `true` by default. Set to `false` to disable printing of background. |\n| **mediaType** optional Uses `print` by default. Set to `screen` to convert HTML as it appears in a browser or `print` to convert as it appears for printing or `none` to set `none` as mediaType for CSS styles. |\n| **DoNotWaitFullLoad** optional `false` by default. Set to `true` to skip waiting for full load (like full video load etc that may affect the total conversion time). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options, The input must be in string format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |\n| **header** optional Set to HTML for the header to be applied on every page at the header. |\n| **footer** optional Set to HTML for the footer to be applied on every page at the bottom. |\n\nThe `header` and `footer` params should contain valid HTML markup with the following classes used to inject printing values into them:\n\n`date`: formatted print date\n`title`: document title\n`url`: document location\n`pageNumber`: current page number\n`totalPages`: total pages in the document\n\nFor example, the following markup will generate `Page N of NN` page numbering:\n\n```\nPage of .\n```\n\nSample URL To PDF with advanced header and footer. Note that the top and bottom page margins are important because page content may overlap the footer or header.\n\n```\n{\n \"url\": \"https://wikipedia.org\",\n \"async\": false,\n \n \"name\": \"result.pdf\",\n \"margins\": \"40px 5px 40px 5px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"
\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"url"
]
}
},
"_postman_previewlanguage": "Text",
"header": [],
"cookie": [],
"body": ""
}
]
}
],
"description": "**Description:** Create PDF from URL. `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "25. PDF from HTML (HTML to PDF)",
"item": [
{
"name": "/pdf/convert/from/html (raw html input)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"html\": \"
Hello World!
Go to PDF.co\",\n \"name\": \"result.pdf\",\n \"margins\": \"5px 5px 5px 5px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"mediaType\": \"print\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
},
"description": "Generate PDF from HTML input. You can also set the following params:\n\n| **Attributes** |\n| --- |\n| **html** required Input HTML code to be converted. To convert the link to a PDF use `/pdf/convert/from/url` endpoint instead. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **margins** optional set to CSS style margins like `10px`, `5mm`, `5in` for all sides or `5px 5px 5px 5px` (the order of margins is `top`, `right`, `bottom`, `left`). |\n| **paperSize** optional `Letter` is set by default. Can be `Letter`, `Legal`, `Tabloid`, `Ledger`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6` or a custom size. Custom size can be set in `px` (pixels), `mm` or `in` (inches) with width and height separated by space like this: `200 300`, `200px 300px`, `200mm 300mm`, `20cm 30cm` or `6in 8in`. |\n| **orientation** optional Set to `Portrait` or `Landscape`. `Portrait` by default. |\n| **printBackground** optional `true` by default. Set to `false` to disable printing of background. |\n| **mediaType** optional Uses `print` by default. Set to `screen` to convert HTML as it appears in a browser; `print` to convert as it appears for printing; `none` sets media type to `none`. |\n| **DoNotWaitFullLoad** optional `false` by default. Set to `true` to skip waiting for full load (like full video load etc that may affect the total conversion time). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options, The input must be in string format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |\n| **header** optional Set to HTML for the header to be applied on every page at the header. |\n| **footer** optional Set to HTML for the footer to be applied on every page at the bottom. |\n\nThe `header` and `footer` params should contain valid HTML markup with the following classes used to inject printing values into them:\n\n`date`: formatted print date\n`title`: document title\n`url`: document location\n`pageNumber`: current page number\n`totalPages`: total pages in the document\n\nFor example, the following markup will generate `Page N of NN` page numbering:\n```\nPage of .\n```\n\nSample JSON for PDF generation with a more advanced header and footer. \nNote that the top and bottom page margins are important because the page content may overlap the footer or header.\n\n```\n{\n \"html\": \"\"
\",\n \"name\": \"result.pdf\",\n \"margins\": \"5px 5px 5px 5px\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"mediaType\": \"print\",\n \"async\": false,\n \"profiles\": \"{\\\"orientation\\\": \\\"landscape\\\", \\\"paperSize\\\": \\\"letter\\\" }\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
},
"description": "Generate PDF from HTML input. You can also set the following params:\n\n| **Attributes** |\n| --- |\n| **html** required Input HTML code to be converted. To convert the link to a PDF use `/pdf/convert/from/url` endpoint instead. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **margins** optional set to CSS style margins like `10px`, `5mm`, `5in` for all sides or `5px 5px 5px 5px` (the order of margins is `top`, `right`, `bottom`, `left`). |\n| **paperSize** optional `Letter` is set by default. Can be `Letter`, `Legal`, `Tabloid`, `Ledger`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6` or a custom size. Custom size can be set in `px` (pixels), `mm` or `in` (inches) with width and height separated by space like this: `200 300`, `200px 300px`, `200mm 300mm`, `20cm 30cm` or `6in 8in`. |\n| **orientation** optional Set to `Portrait` or `Landscape`. `Portrait` by default. |\n| **printBackground** optional `true` by default. Set to `false` to disable printing of background. |\n| **mediaType** optional Uses `print` by default. Set to `screen` to convert HTML as it appears in a browser; `print` to convert as it appears for printing; `none` sets media type to `none`. |\n| **profiles** optional Use this parameter to set additional configuration for fine-tuning and extra options, The input must be in string format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |\n| **header** optional Set to HTML for the header to be applied on every page at the header. |\n| **footer** optional Set to HTML for the footer to be applied on every page at the bottom. |\n\nThe `header` and `footer` params should contain valid HTML markup with the following classes used to inject printing values into them:\n\n`date`: formatted print date\n`title`: document title\n`url`: document location\n`pageNumber`: current page number\n`totalPages`: total pages in the document\n\nFor example, the following markup will generate `Page N of NN` page numbering:\n```\nPage of .\n```\n\nSample for HTML PDF generation with more advanced header and footer. \nNote that the top and bottom page margins are important because the page content may overlap the footer or header.\n\n```\n{\n \"html\": \"\"
\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
}
},
"_postman_previewlanguage": "Text",
"header": [],
"cookie": [],
"body": ""
}
]
}
],
"description": "**Description:** Convert HTML code snippet into full featured PDF. `GET` or `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n```\nPOST\n{\n\t\"name\" : \"result.pdf\",\n\t\"html\" : \"true\",\n\t\"url\" : \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-to-html/sample.html\"\n}\n```",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "26. PDF from HTML Template",
"item": [
{
"name": "/pdf/convert/from/html (json input)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"templateId\": 1,\n \"name\": \"newDocument.pdf\",\n \"mediaType\": \"print\",\n \"margins\": \"40px 20px 20px 20px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"async\": false,\n \"templateData\": \"{\\\"paid\\\": true,\\\"invoice_id\\\": \\\"0021\\\",\\\"invoice_date\\\": \\\"August 29, 2041\\\",\\\"invoice_dateDue\\\": \\\"September 29, 2041\\\",\\\"issuer_name\\\": \\\"Sarah Connor\\\",\\\"issuer_company\\\": \\\"T-800 Research Lab\\\",\\\"issuer_address\\\": \\\"435 South La Fayette Park Place, Los Angeles, CA 90057\\\",\\\"issuer_website\\\": \\\"www.example.com\\\",\\\"issuer_email\\\": \\\"info@example.com\\\",\\\"client_name\\\": \\\"Cyberdyne Systems\\\",\\\"client_company\\\": \\\"Cyberdyne Systems\\\",\\\"client_address\\\": \\\"18144 El Camino Real, Sunnyvale, California\\\",\\\"client_email\\\": \\\"sales@example.com\\\",\\\"items\\\": [ { \\\"name\\\": \\\"T-800 Prototype Research\\\", \\\"price\\\": 1000.00 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup\\\", \\\"price\\\": 300.00 } ],\\\"discount\\\": 100,\\\"tax\\\": 87,\\\"total\\\": 1287,\\\"note\\\": \\\"Thank you for your support of advanced robotics.\\\"}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
},
"description": "Automate and scale PDF generation using built-in PDF.co HTML templates. API loads data from `templateData` parameter and uses this data to inject data into your html template.\n\n**Create, test and manage your HTML templates [here](https://app.pdf.co/templates/html)**\n\nTemplates use `{{Mustache}}` and `Handlebars` templating syntax. You just need to insert macros surrounded by double brackets like `{{` and `}}`.\n\n- More about `{{Mustache}}` templates [here](https://mustache.github.io/mustache.5.html)\n- More about `{{Handlebars}}` advanced templates [here](https://handlebarsjs.com/guide/)\n \nSome Examples of macro inside html template:\n\n- `{{variable1}}` will be replaced with `test` if you set `templateData` to `{ \"variable1\": \"test\"}`\n- `{{object1.variable1}}` will be replaced with `test` if you set `templateData` to `{ \"object1\": { \"variable1\": \"test\"} }`\n- simple conditions are also supported. For example: `{{#if paid}} invoice was paid {{/if}}` will show `invoice was paid` when `templateData` is set to `{ \"paid\": true }`\n\n| **Attributes** |\n| --- |\n| **templateId** required Set to the ID of your HTML template. You can find and copy ID at [HTML templates](https://app.pdf.co/templates/html) section in the app. |\n| **templateData** required Set it to a string with input `JSON` data (recommended) or from `CSV` data. |\n\nSample JSON input: \n\n```\n\"templateData\": \"{ 'paid': true, 'invoice_id': '0002', 'total': '$999.99' }\"\n```\n\n*NOTE: If you use JSON as input then make sure to escape it first (with `JSON.stringify(dataObject)` in JS). Escaping is when every `\"` is replaced with `\\\"` (most programming languages are doing it automatically though.*\n\nExample with `\"` be escaped as `\\\"` then:\n\n```\n\"templateData\": \"{ \\\"paid\\\": true, \\\"invoice_id\\\": \\\"0002\\\", \\\"total\\\": \\\"$999.99\\\" }\"\n\n```\n\nYou can also use simple CSV as input:\n```\n\"templateData\": \"paid,invoice_id,total\ntrue,0002,$999.99\"\n```\n\n| **Attributes** |\n| --- |\n| **margins** optional Set to CSS style margins like `10px`, `5mm`, `5in` for all sides or `5px 5px 5px 5px` (the order of margins is `top`, `right`, `bottom`, `left`). |\n| **orientation** optional Set to `Portrait` or `Landscape`. `Portrait` by default. |\n| **paperSize** optional `Letter` is set by default. Can be `Letter`, `Legal`, `Tabloid`, `Ledger`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6` or a custom size. Custom size can be set in `px` (pixels), `mm` or `in` (inches) with width and height separated by space like this: `200 300`, `200px 300px`, `200mm 300mm`, `20cm 30cm` or `6in 8in`. |\n| **printBackground** optional `true` by default. Set to `false` to disable printing of background. |\n| **mediaType** optional Uses `print` by default. Set to `screen` to convert HTML as it appears in a browser; `print` to convert as it appears for printing; `none` sets media type to `none`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configuration for fine-tuning and extra options, The input must be in string format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |\n| **header** optional Set to HTML for the header to be applied on every page at the header. |\n| **footer** optional Set to HTML for the footer to be applied on every page at the bottom. |\n\nThe `header` and `footer` params should contain valid HTML markup with the following classes used to inject printing values into them:\n\n`date`: formatted print date\n`title`: document title\n`url`: document location\n`pageNumber`: current page number\n`totalPages`: total pages in the document\n\nFor example, the following markup will generate `Page N of NN` page numbering:\n\n```\nPage of .\n```\n\nSample advanced header and footer:\n\n```\n\"header\": \"
LEFT SUBHEADERRIGHT SUBHEADER
\",\n\"footer\": \"
Page of .
\"\n```"
},
"response": [
{
"name": "/pdf/convert/from/html (json input)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"templateId\": 1,\n \"name\": \"newDocument.pdf\",\n \"margins\": \"40px 20px 20px 20px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"async\": false,\n \"templateData\": \"{\\\"paid\\\": true,\\\"invoice_id\\\": \\\"0021\\\", \\\"invoice_date\\\": \\\"August 29, 2041\\\", \\\"invoice_dateDue\\\": \\\"September 29, 2041\\\",\\\"issuer_name\\\": \\\"Sarah Connor\\\", \\\"issuer_company\\\": \\\"T-800 Research Lab\\\", \\\"issuer_address\\\": \\\"435 South La Fayette Park Place, Los Angeles, CA 90057\\\", \\\"issuer_website\\\": \\\"www.example.com\\\", \\\"issuer_email\\\": \\\"info@example.com\\\", \\\"client_name\\\": \\\"Cyberdyne Systems\\\", \\\"client_company\\\": \\\"Cyberdyne Systems\\\", \\\"client_address\\\": \\\"18144 El Camino Real, Sunnyvale, California\\\", \\\"client_email\\\": \\\"sales@example.com\\\", \\\"items\\\": [ { \\\"name\\\": \\\"T-800 Prototype Research\\\", \\\"price\\\": \\\"$1,000.00\\\" }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup\\\", \\\"price\\\": \\\"$300.00\\\" } ], \\\"discount\\\": \\\"$100\\\", \\\"tax\\\": \\\"$90 (7.5%)\\\", \\\"total\\\": \\\"$1,290.00\\\", \\\"note\\\": \\\"Thank you for your support of advanced robotics.\\\"}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"9813b0f853496255a59b489a422a1302\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "fac08ccc-bcc2-4a0d-82e4-bef8392eb08d"
},
{
"key": "X-Runtime",
"value": "6.167541"
},
{
"key": "Date",
"value": "Tue, 28 Dec 2021 16:15:09 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/a2cd107f504740a5bddec4cb8dd3f76a/newDocument.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"newDocument.pdf\",\n \"remainingCredits\": 99072306,\n \"credits\": 9\n}"
}
]
},
{
"name": "/pdf/convert/from/html (csv input)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"templateId\": 1,\n \"name\": \"newDocument.pdf\",\n \"mediaType\": \"print\",\n \"margins\": \"40px 20px 20px 20px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"async\": false,\n \"templateData\": \"{\\\"paid\\\": true,\\\"invoice_id\\\": \\\"0021\\\",\\\"invoice_date\\\": \\\"August 29, 2041\\\",\\\"invoice_dateDue\\\": \\\"September 29, 2041\\\",\\\"issuer_name\\\": \\\"Sarah Connor\\\",\\\"issuer_company\\\": \\\"T-800 Research Lab\\\",\\\"issuer_address\\\": \\\"435 South La Fayette Park Place, Los Angeles, CA 90057\\\",\\\"issuer_website\\\": \\\"www.example.com\\\",\\\"issuer_email\\\": \\\"info@example.com\\\",\\\"client_name\\\": \\\"Cyberdyne Systems\\\",\\\"client_company\\\": \\\"Cyberdyne Systems\\\",\\\"client_address\\\": \\\"18144 El Camino Real, Sunnyvale, California\\\",\\\"client_email\\\": \\\"sales@example.com\\\",\\\"items\\\": [ { \\\"name\\\": \\\"T-800 Prototype Research\\\", \\\"price\\\": 1000.00 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup\\\", \\\"price\\\": 300.00 } ],\\\"discount\\\": 100,\\\"tax\\\": 87,\\\"total\\\": 1287,\\\"note\\\": \\\"Thank you for your support of advanced robotics.\\\"}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
},
"description": "Automate and scale PDF generation using built-in PDF.co HTML templates. API loads data from `templateData` parameter and uses this data to inject data into your html template.\n\n**Create, test and manage your HTML templates [here](https://app.pdf.co/templates/html)**\n\nTemplates use `{{Mustache}}` and `Handlebars` templating syntax. You just need to insert macros surrounded by double brackets like `{{` and `}}`.\n\n- More about `{{Mustache}}` templates [here](https://mustache.github.io/mustache.5.html)\n- More about `{{Handlebars}}` advanced templates [here](https://handlebarsjs.com/guide/)\n \nSome Examples of macro inside html template:\n\n- `{{variable1}}` will be replaced with `test` if you set `templateData` to `{ \"variable1\": \"test\"}`\n- `{{object1.variable1}}` will be replaced with `test` if you set `templateData` to `{ \"object1\": { \"variable1\": \"test\"} }`\n- simple conditions are also supported. For example: `{{#if paid}} invoice was paid {{/if}}` will show `invoice was paid` when `templateData` is set to `{ \"paid\": true }`\n\n| **Attributes** |\n| --- |\n| **templateId** required Set to the ID of your HTML template. You can find and copy ID at [HTML templates](https://app.pdf.co/templates/html) section in the app. |\n| **templateData** required Set it to a string with input `JSON` data (recommended) or from `CSV` data. |\n\nSample JSON input: \n\n```\n\"templateData\": \"{ 'paid': true, 'invoice_id': '0002', 'total': '$999.99' }\"\n```\n\n*NOTE: If you use JSON as input then make sure to escape it first (with `JSON.stringify(dataObject)` in JS). Escaping is when every `\"` is replaced with `\\\"` (most programming languages are doing it automatically though.*\n\nExample with `\"` be escaped as `\\\"` then:\n\n```\n\"templateData\": \"{ \\\"paid\\\": true, \\\"invoice_id\\\": \\\"0002\\\", \\\"total\\\": \\\"$999.99\\\" }\"\n\n```\n\nYou can also use simple CSV as input:\n```\n\"templateData\": \"paid,invoice_id,total\ntrue,0002,$999.99\"\n```\n\n| **Attributes** |\n| --- |\n| **margins** optional set to CSS style margins like `10px`, `5mm`, `5in` for all sides or `5px 5px 5px 5px` (the order of margins is `top`, `right`, `bottom`, `left`). |\n| **paperSize** optional `Letter` is set by default. Can be `Letter`, `Legal`, `Tabloid`, `Ledger`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6` or a custom size. Custom size can be set in `px` (pixels), `mm` or `in` (inches) with width and height separated by space like this: `200 300`, `200px 300px`, `200mm 300mm`, `20cm 30cm` or `6in 8in`. |\n| **orientation** optional Set to `Portrait` or `Landscape`. `Portrait` by default. |\n| **printBackground** optional `true` by default. Set to `false` to disable printing of background. |\n| **mediaType** optional Uses `print` by default. Set to `screen` to convert HTML as it appears in a browser; `print` to convert as it appears for printing; `none` sets media type to `none`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configuration for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |\n| **header** optional Set to HTML for the header to be applied on every page at the header. |\n| **footer** optional Set to HTML for the footer to be applied on every page at the bottom. |\n\nThe `header` and `footer` params should contain valid HTML markup with the following classes used to inject printing values into them:\n\n`date`: formatted print date\n`title`: document title\n`url`: document location\n`pageNumber`: current page number\n`totalPages`: total pages in the document\n\nFor example, the following markup will generate `Page N of NN` page numbering:\n```\nPage of .\n```\n\nSample advanced header and footer:\n\n```\n\"header\": \"
LEFT SUBHEADERRIGHT SUBHEADER
\",\n\"footer\": \"
Page of .
\"\n```"
},
"response": [
{
"name": "/pdf/convert/from/html (csv data input)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"templateId\": 1,\n \"name\": \"newDocument.pdf\",\n \"margins\": \"40px 20px 20px 20px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"async\": false,\n \"templateData\": \"paid,invoice_id,invoice_date,invoice_dateDue,issuer_name,issuer_company,issuer_address,issuer_website,issuer_email,client_name,client_company,client_address,client_email,discount,tax,total,note\\r\\ntrue,0021,\\\"August 29, 2041\\\",\\\"September 29, 2041\\\",Sarah Connor,T-800 Research Lab,\\\"435 South La Fayette Park Place, Los Angeles, CA 90057\\\",www.example.com,info@example.com,Cyberdyne Systems,Cyberdyne Systems,\\\"18144 El Camino Real, Sunnyvale, California\\\",sales@example.com,100,87,1287,Thank you for your support of advanced robotics.\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"966987cc5511e2c23ccc49abb4d362de\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "b5cf4b71-79b9-4291-b8b6-0d338cf5e98f"
},
{
"key": "X-Runtime",
"value": "8.341625"
},
{
"key": "Date",
"value": "Tue, 11 Jan 2022 15:22:05 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/6fc1712ba6274b06a88329cffd5ab217/newDocument.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"newDocument.pdf\",\n \"remainingCredits\": 98962241,\n \"credits\": 9\n}"
}
]
},
{
"name": "/pdf/convert/from/html (advanced template with auto calc)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"templateId\": 2,\n \"name\": \"newDocument.pdf\",\n \"mediaType\": \"print\",\n \"margins\": \"40px 20px 20px 20px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"async\": false,\n \"templateData\": \"{\\\"paid\\\": true,\\\"invoice_id\\\": \\\"0021\\\",\\\"invoice_date\\\": \\\"August 29, 2041\\\",\\\"invoice_dateDue\\\": \\\"September 29, 2041\\\",\\\"issuer_name\\\": \\\"Sarah Connor\\\",\\\"issuer_company\\\": \\\"T-800 Research Lab\\\",\\\"issuer_address\\\": \\\"435 South La Fayette Park Place, Los Angeles, CA 90057\\\",\\\"issuer_website\\\": \\\"www.example.com\\\",\\\"issuer_email\\\": \\\"info@example.com\\\",\\\"client_name\\\": \\\"Cyberdyne Systems\\\",\\\"client_company\\\": \\\"Cyberdyne Systems\\\",\\\"client_address\\\": \\\"18144 El Camino Real, Sunnyvale, California\\\",\\\"client_email\\\": \\\"sales@example.com\\\",\\\"items\\\": [ {\\\"name\\\": \\\"T-800 Prototype Research\\\",\\\"price\\\": 1000.0 }, {\\\"name\\\": \\\"T-800 Cloud Sync Setup\\\",\\\"price\\\": 300.0 }],\\\"discount\\\": 0.1,\\\"tax\\\": 0.0725,\\\"note\\\": \\\"Thank you for your support of advanced robotics.\\\"}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
},
"description": "Automate and scale PDF generation using built-in PDF.co HTML templates. API loads data from `templateData` parameter and uses this data to inject data into your html template.\n\n**Create, test and manage your HTML templates [here](https://app.pdf.co/templates/html)**\n\nTemplates use `{{Mustache}}` and `Handlebars` templating syntax. You just need to insert macros surrounded by double brackets like `{{` and `}}`.\n\n- More about `{{Mustache}}` templates [here](https://mustache.github.io/mustache.5.html)\n- More about `{{Handlebars}}` advanced templates [here](https://handlebarsjs.com/guide/)\n \nSome Examples of macro inside html template:\n\n- `{{variable1}}` will be replaced with `test` if you set `templateData` to `{ \"variable1\": \"test\"}`\n- `{{object1.variable1}}` will be replaced with `test` if you set `templateData` to `{ \"object1\": { \"variable1\": \"test\"} }`\n- simple conditions are also supported. For example: `{{#if paid}} invoice was paid {{/if}}` will show `invoice was paid` when `templateData` is set to `{ \"paid\": true }`\n\n| **Attributes** |\n| --- |\n| **templateId** required Set to the ID of your HTML template. You can find and copy the ID at [HTML templates](https://app.pdf.co/templates/html) section in the app. |\n| **templateData** required Set it to a string with input `JSON` data (recommended) or from `CSV` data. |\n\nSample JSON input: \n\n```\n\"templateData\": \"{ 'paid': true, 'invoice_id': '0002', 'total': '$999.99' }\"\n```\n\n*NOTE: If you use JSON as input then make sure to escape it first (with `JSON.stringify(dataObject)` in JS). Escaping is when every `\"` is replaced with `\\\"` (most programming languages are doing it automatically though.*\n\nExample with `\"` be escaped as `\\\"` then:\n\n```\n\"templateData\": \"{ \\\"paid\\\": true, \\\"invoice_id\\\": \\\"0002\\\", \\\"total\\\": \\\"$999.99\\\" }\"\n\n```\n\nYou can also use simple CSV as input:\n```\n\"templateData\": \"paid,invoice_id,total\ntrue,0002,$999.99\"\n```\n\n| **Attributes** |\n| --- |\n| **margins** optional set to CSS style margins like `10px`, `5mm`, `5in` for all sides or `5px 5px 5px 5px` (the order of margins is `top`, `right`, `bottom`, `left`). |\n| **paperSize** optional `Letter` is set by default. Can be `Letter`, `Legal`, `Tabloid`, `Ledger`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6` or a custom size. Custom size can be set in `px` (pixels), `mm` or `in` (inches) with width and height separated by space like this: `200 300`, `200px 300px`, `200mm 300mm`, `20cm 30cm` or `6in 8in`. |\n| **orientation** optional Set to `Portrait` or `Landscape`. `Portrait` by default. |\n| **printBackground** optional `true` by default. Set to `false` to disable printing of background. |\n| **mediaType** optional Uses `print` by default. Set to `screen` to convert HTML as it appears in a browser; `print` to convert as it appears for printing; `none` sets media type to `none`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples, The input must be in string format. |\n| **header** optional Set to HTML for the header to be applied on every page at the header. |\n| **footer** optional Set to HTML for the footer to be applied on every page at the bottom. |\n\nThe `header` and `footer` params should contain valid HTML markup with the following classes used to inject printing values into them:\n\n`date`: formatted print date\n`title`: document title\n`url`: document location\n`pageNumber`: current page number\n`totalPages`: total pages in the document\n\nFor example, the following markup will generate `Page N of NN` page numbering:\n```\nPage of .\n```\n\nSample advanced header and footer:\n\n\n```\n\"header\": \"
LEFT SUBHEADERRIGHT SUBHEADER
\",\n\"footer\": \"
Page of .
\"\n```"
},
"response": [
{
"name": "/pdf/convert/from/html (using template with auto calc)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"templateId\": 2,\n \"name\": \"newDocument.pdf\",\n \"margins\": \"40px 20px 20px 20px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"async\": false,\n \"templateData\": \"{\\\"paid\\\": true,\\\"invoice_id\\\": \\\"0021\\\",\\\"invoice_date\\\": \\\"August 29, 2041\\\",\\\"invoice_dateDue\\\": \\\"September 29, 2041\\\",\\\"issuer_name\\\": \\\"Sarah Connor\\\",\\\"issuer_company\\\": \\\"T-800 Research Lab\\\",\\\"issuer_address\\\": \\\"435 South La Fayette Park Place, Los Angeles, CA 90057\\\",\\\"issuer_website\\\": \\\"www.example.com\\\",\\\"issuer_email\\\": \\\"info@example.com\\\",\\\"client_name\\\": \\\"Cyberdyne Systems\\\",\\\"client_company\\\": \\\"Cyberdyne Systems\\\",\\\"client_address\\\": \\\"18144 El Camino Real, Sunnyvale, California\\\",\\\"client_email\\\": \\\"sales@example.com\\\",\\\"items\\\": [ {\\\"name\\\": \\\"T-800 Prototype Research\\\",\\\"price\\\": 1000.0 }, {\\\"name\\\": \\\"T-800 Cloud Sync Setup\\\",\\\"price\\\": 300.0 }],\\\"discount\\\": 0.1,\\\"tax\\\": 0.0725,\\\"note\\\": \\\"Thank you for your support of advanced robotics.\\\"}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"ee8b889030b12bb12300efd8004696b8\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "34985f5f-78c3-433b-a122-7295a8e7f05b"
},
{
"key": "X-Runtime",
"value": "2.985456"
},
{
"key": "Date",
"value": "Tue, 04 Jan 2022 18:11:29 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/31a398c79ab14d27b029f268cf9660c8/newDocument.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"newDocument.pdf\",\n \"remainingCredits\": 99003839,\n \"credits\": 9\n}"
}
]
},
{
"name": "/pdf/convert/from/html (multi page invoice with qr code and auto calc)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"templateId\": 3,\n \"name\": \"multipagedInvoiceWithQRCode.pdf\",\n \"mediaType\": \"print\",\n \"margins\": \"40px 20px 20px 20px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"\",\n \"footer\": \"\",\n \"async\": false,\n \"templateData\": \"{\\\"paid\\\": true,\\\"company_name\\\": \\\"Lovely Company Inc.\\\",\\\"company_address\\\": \\\"1234 Market St\\\\nSan Francisco, California 94102\\\\nUSA\\\",\\\"company_logo\\\": \\\"https:\\/\\/pdfco-test-files.s3.us-west-2.amazonaws.com\\/pdf-edit\\/logo.png\\\",\\\"barcode_value\\\": \\\"sample encoded barcode value for page 1\\\\nwuth line breaks if needed\\\\n\\\\nOrder id:\\\",\\\"ocr_scanline\\\": \\\"OCR-A 123567890\\\",\\\"order_id\\\": \\\"1122455\\\",\\\"order_date\\\": \\\"15 Jan 2022\\\",\\\"customer_id\\\": \\\"T8001\\\",\\\"shipped_date\\\": \\\"20 Jan 2022\\\",\\\"shipped_via\\\": \\\"UPS\\\",\\\"bill_to_name\\\": \\\"T-800 Research Lab\\\",\\\"bill_to_address\\\": \\\"435 South La Fayette Park Place, \\\\nLos Angeles, CA 90057\\\\nUSA\\\",\\\"ship_to_name\\\": \\\"Cyberdyne Systems\\\",\\\"ship_to_address\\\": \\\"18144 El Camino Real\\\\nSunnyvale, California\\\\nUSA\\\",\\\"freight\\\": 19.95,\\\"notes\\\": \\\"Thank you for your purchase.\\\\nThanks for your support of advanced robotics.\\\",\\\"items\\\": [ { \\\"name\\\": \\\"T-800 Prototype Research\\\", \\\"price\\\": 50.0, \\\"quantity\\\": 2 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup\\\", \\\"price\\\": 150.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 20.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 24.99, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 199.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 19.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 20.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 49.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 1000.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 12.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 25.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 24.99, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 14.95, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 149.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 99.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 100.0, \\\"quantity\\\": 4 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 9 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 2 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 3.49, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 15.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research\\\", \\\"price\\\": 50.0, \\\"quantity\\\": 2 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup\\\", \\\"price\\\": 150.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 20.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 24.99, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 199.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 19.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 20.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 49.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 1000.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 12.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 25.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 24.99, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 14.95, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 149.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 99.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 100.0, \\\"quantity\\\": 4 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 9 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 2 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 3.49, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Prototype Research\\\", \\\"price\\\": 50.0, \\\"quantity\\\": 2 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup\\\", \\\"price\\\": 150.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 20.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 24.99, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 199.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 19.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 20.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 49.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 1000.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 12.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 25.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 24.99, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 14.95, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 149.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 99.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 100.0, \\\"quantity\\\": 4 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 9 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 2 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 3.49, \\\"quantity\\\": 3 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }, { \\\"name\\\": \\\"T-800 Cloud Sync Setup 3\\\", \\\"price\\\": 30.0, \\\"quantity\\\": 5 }, { \\\"name\\\": \\\"T-800 Prototype Research 2\\\", \\\"price\\\": 10.0, \\\"quantity\\\": 1 }]\\r\\n}\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"html"
]
},
"description": "Automate and scale PDF generation using built-in PDF.co HTML templates. API loads data from `templateData` parameter and uses this data to inject data into your html template.\n\n**Create, test and manage your HTML templates [here](https://app.pdf.co/templates/html)**\n\nTemplates use `{{Mustache}}` and `Handlebars` templating syntax. You just need to insert macros surrounded by double brackets like `{{` and `}}`.\n\n- More about `{{Mustache}}` templates [here](https://mustache.github.io/mustache.5.html)\n- More about `{{Handlebars}}` advanced templates [here](https://handlebarsjs.com/guide/)\n \nSome Examples of macro inside html template:\n\n- `{{variable1}}` will be replaced with `test` if you set `templateData` to `{ \"variable1\": \"test\"}`\n- `{{object1.variable1}}` will be replaced with `test` if you set `templateData` to `{ \"object1\": { \"variable1\": \"test\"} }`\n- simple conditions are also supported. For example: `{{#if paid}} invoice was paid {{/if}}` will show `invoice was paid` when `templateData` is set to `{ \"paid\": true }`\n\n| **Attributes** |\n| --- |\n| **templateId** required Set to the ID of your HTML template. You can find and copy the ID at [HTML templates](https://app.pdf.co/templates/html) section in the app. |\n| **templateData** required Set it to a string with input `JSON` data (recommended) or from `CSV` data. |\n\nSample JSON input: \n\n```\n\"templateData\": \"{ 'paid': true, 'invoice_id': '0002', 'total': '$999.99' }\"\n```\n\n*NOTE: If you use JSON as input then make sure to escape it first (with `JSON.stringify(dataObject)` in JS). Escaping is when every `\"` is replaced with `\\\"` (most programming languages are doing it automatically though.*\n\nExample with `\"` be escaped as `\\\"` then:\n\n```\n\"templateData\": \"{ \\\"paid\\\": true, \\\"invoice_id\\\": \\\"0002\\\", \\\"total\\\": \\\"$999.99\\\" }\"\n\n```\n\nYou can also use simple CSV as input:\n```\n\"templateData\": \"paid,invoice_id,total\ntrue,0002,$999.99\"\n```\n\n| **Attributes** |\n| --- |\n| **margins** optional set to CSS style margins like `10px`, `5mm`, `5in` for all sides or `5px 5px 5px 5px` (the order of margins is `top`, `right`, `bottom`, `left`). |\n| **paperSize** optional `Letter` is set by default. Can be `Letter`, `Legal`, `Tabloid`, `Ledger`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6` or a custom size. Custom size can be set in `px` (pixels), `mm` or `in` (inches) with width and height separated by space like this: `200 300`, `200px 300px`, `200mm 300mm`, `20cm 30cm` or `6in 8in`. |\n| **orientation** optional Set to `Portrait` or `Landscape`. `Portrait` by default. |\n| **printBackground** optional `true` by default. Set to `false` to disable printing of background. |\n| **mediaType** optional Uses `print` by default. Set to `screen` to convert HTML as it appears in a browser; `print` to convert as it appears for printing; `none` sets media type to `none`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configuration for fine-tuning and extra options, The input must be in string format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |\n| **header** optional Set to HTML for the header to be applied on every page at the header. |\n| **footer** optional Set to HTML for the footer to be applied on every page at the bottom. |\n\nThe `header` and `footer` params should contain valid HTML markup with the following classes used to inject printing values into them:\n\n`date`: formatted print date\n`title`: document title\n`url`: document location\n`pageNumber`: current page number\n`totalPages`: total pages in the document\n\nFor example, the following markup will generate `Page N of NN` page numbering:\n```\nPage of .\n```\n\nSample advanced header and footer:\n\n\n```\n\"header\": \"
\\r\\n Invoice Due Date: {{invoice.dateDue}}\\r\\n
\\r\\n
\\r\\n
\\r\\n
\\r\\n \\r\\n
\\r\\n \\r\\n\\r\\n
\\r\\n
BILL TO
\\r\\n
\\r\\n
Name: {{client.name}}
\\r\\n
Company: {{client.company}}
\\r\\n
Address: {{client.address}}
\\r\\n
Email: {{client.email}}
\\r\\n
\\r\\n
\\r\\n
\\r\\n \\r\\n
\\r\\n
\\r\\n
\\r\\n \\r\\n
\\r\\n
Item
\\r\\n
Price
\\r\\n
\\r\\n \\r\\n \\r\\n {{#each items}}\\r\\n
\\r\\n
{{name}}
\\r\\n
{{price}}
\\r\\n
\\r\\n {{/each}}\\r\\n \\r\\n
\\r\\n
\\r\\n\\r\\n
\\r\\n
\\r\\n
\\r\\n
\\r\\n
\\r\\n
Discount: {{discount}}
\\r\\n
Tax: {{tax}}
\\r\\n
TOTAL: {{total}}
\\r\\n
\\r\\n \\r\\n
\\r\\n
\\r\\n
\\r\\n
\\r\\n
{{note}}
\\r\\n \\r\\n\\r\\n\\r\\n\",\n \"remainingCredits\": 99204002,\n \"credits\": 2\n}"
}
]
}
],
"description": "**Description:** Creates PDF from HTML template. `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\nPDF.co supports `{{Mustache}}` style HTML templates. For example, you can set `templateData` property to JSON like this `{ invoice: { company: \\\"ACME Company\\\"}}` and `{{invoice.company}}` inside template will be replaced with `ACME Company`.\n\nFor more information about Handlebars & Mustache templates please visit [https://handlebarsjs.com/](https://handlebarsjs.com/).",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "27. PDF from Email",
"item": [
{
"name": "/pdf/convert/from/email",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/email-to-pdf/sample.eml\",\n \"embedAttachments\": true,\n \"convertAttachments\": true,\n \"paperSize\": \"Letter\", \n \"name\": \"email-with-attachments\",\n \"async\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/email",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"email"
]
},
"description": "Generate PDF from `MSG` or `EML` file and creates a PDF file with email and attachments (if any). You can set the following params:\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **embedAttachments** optional, `True` by default Set to `true` to automatically embeds all attachments from original input email MSG or EML files into the final output PDF. Set it to `false` if you don't want to embed attachments so it will convert only the body of the input email. |\n| **convertAttachments** optional, `true` by default Set to `false` if you don't want to convert attachments from the original email and want to embed them as original files (as embedded pdf attachments). Converts attachments that are supported by API (DOC, DOCx, HTML, PNG, JPG .etc) into PDF and merges into output final PDF. Non-supported file types are added as PDF attachments (Adobe Reader or another viewer may be required to view PDF attachments). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **margins** optional set to CSS style margins like `10px`, `5mm`, `5in` for all sides or `5px 5px 5px 5px` (the order of margins is `top`, `right`, `bottom`, `left`). |\n| **paperSize** optional `Letter` is set by default. Can be `Letter`, `Legal`, `Tabloid`, `Ledger`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6` or a custom size. Custom size can be set in `px` (pixels), `mm` or `in` (inches) with width and height separated by space like this: `200 300`, `200px 300px`, `200mm 300mm`, `20cm 30cm` or `6in 8in`. |\n| **orientation** optional Set to `Portrait` or `Landscape`. `Portrait` by default. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options, The input must be in string format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |\n| **name** optional File name for the generated output, The input must be in string format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |"
},
"response": [
{
"name": "/pdf/convert/from/url (with header and footer)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://wikipedia.org\",\n \"async\": false,\n \n \"name\": \"result.pdf\",\n \"margins\": \"40px 5px 40px 5px\",\n \"paperSize\": \"Letter\",\n \"orientation\": \"Portrait\",\n \"printBackground\": true,\n \"header\": \"
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **name** optional File name for the generated output. Must be a string. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. Must be a string. `profiles` string may contain a JSON string containing options like orientation, paper size, and margins. Example: `{'orientation': 'landscape', 'paperSize': 'letter', 'margins': '5mm'}` |\n\n| **Available attributes inside `profiles` parameter** |\n| --- |\n| **margins** optional set to CSS style margins like `10px`, `5mm`, `5in` for all sides or `5px 5px 5px 5px` (the order of margins is `top`, `right`, `bottom`, `left`). |\n| **paperSize** optional `Letter` is set by default. Can be `Letter`, `Legal`, `Tabloid`, `Ledger`, `A0`, `A1`, `A2`, `A3`, `A4`, `A5`, `A6` or a custom size. Custom size can be set in `px` (pixels), `mm` or `in` (inches) with width and height separated by space like this: `200 300`, `200px 300px`, `200mm 300mm`, `20cm 30cm` or `6in 8in`. |\n| **orientation** optional Set to `Portrait` or `Landscape`. `Portrait` by default. |"
},
"response": [
{
"name": "/pdf/convert/from/email with Orientation and paper Size",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/email-to-pdf/sample.eml\",\n \"embedAttachments\": true,\n \"name\": \"email-with-attachments\",\n \"async\": false,\n \"profiles\": \"{\\\"orientation\\\": \\\"landscape\\\", \\\"paperSize\\\": \\\"letter\\\" }\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/email",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"email"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"573a9ab36b0ab7b4346a42ce97cb1788\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "a3f7a807-16be-43c6-9f9a-46fca0bfffe7"
},
{
"key": "X-Runtime",
"value": "2.871601"
},
{
"key": "Date",
"value": "Sat, 17 Apr 2021 14:39:49 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/1baff39add874c509b2c2675ba7734fc/email-with-attachments.pdf\",\n \"pageCount\": 3,\n \"error\": false,\n \"status\": 200,\n \"name\": \"email-with-attachments\",\n \"remainingCredits\": 616243,\n \"credits\": 168\n}"
}
]
}
],
"description": "**Description:** Convert email files (MSG or EML) code into PDF. Extracts attachments (if any) from input email and embeds into PDF as pdf attachments.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "28. PDF from Images (JPG to PDF and PNG to PDF)",
"item": [
{
"name": "/pdf/convert/from/image",
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image1.png,https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image2.jpg\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/image",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"image"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output. Must be a string. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be a string. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/pdf/convert/from/image",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image1.png,https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image2.jpg\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/image",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"image"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"5570cd9eb1284e235f5666e106f772c5\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "f9c14a4a-d678-4d69-a8e9-8c91d6bd97de"
},
{
"key": "X-Runtime",
"value": "1.577903"
},
{
"key": "Date",
"value": "Sat, 12 Sep 2020 14:53:56 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/5ef3d4033e344ec091bbeb3cfd848633/image2.pdf\",\n \"pageCount\": 2,\n \"error\": false,\n \"status\": 200,\n \"name\": \"image2.pdf\",\n \"remainingCredits\": 59871\n}"
}
]
}
],
"description": "**Description:** Create a PDF file from one or more JPG, PNG, TIFF images. `GET` or `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n```\nPOST\n{\n\t\"name\" : \"result.pdf\",\n\t\"url\" : \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image1.png,https://pdfco-test-files.s3.us-west-2.amazonaws.com/image-to-pdf/image2.jpg\"\n}\n```",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "29. PDF from XLS or CSV",
"item": [
{
"name": "/xls/convert/to/pdf",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/pdf",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"pdf"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption).|\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **worksheetIndex** optional Set the WorkSheet index (Default is `0`). |\n| **name** optional File name for the generated output. Must be a string. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages use an asterisk e.g `\"pages\": \"*\"` . Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document. Must be a string. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **name** optional File name for the generated output. Must be a string. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchString** required Text to search for on pages. Must be a string. |\n| **excludeKeyPages** optional, `false` by default Set to `true` if you want to exclude pages where text was found. |\n| **regexSearch** optional, `false` by default Set to `true` to enable regular expressions for the search string. | \n| **caseSensitive** optional, `false` by default Set to `true` to enable case-sensitive search. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **name** optional File name for the generated output. Must be a string. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **searchString** required Text to search for on pages. The data type must need to be a string. |\n\nTo search for a barcode use the following macros string: `[[barcode:]]`. \n\nTo search for barcode type **without** analyzing its value, use this notation instead:\n\n`[[barcode:]]`. \n\n**Supported Barcode types:**\n\n```\nAustralianPostCode\nAztec\nBorderedTable\nCheckbox\nCircle\nCircularI2of5\nCodabar\nCodablockF\nCode128\nCode16K\nCode39\nCode39Extended\nCode39Mod43\nCode39Mod43Extended\nCode93\nDataMatrix\nDPMDataMatrix\nEAN13\nEAN2\nEAN5\nEAN8\nGS1\nGS1DataBarExpanded\nGS1DataBarExpandedStacked\nGS1DataBarLimited\nGS1DataBarOmnidirectional\nGS1DataBarStacked\nGTIN12\nGTIN13\nGTIN14\nGTIN8\nHorizontalLine\nIntelligentMail\nInterleaved2of5\nITF14\nMaxiCode\nMICR\nMicroPDF\nMSI\nOval\nPatchCode\nPDF417\nPharmacode\nPostNet\nPZN\nQRCode\nRectangle\nRoyalMail\nRoyalMailKIX\nSegment\nTrioptic\nUnderlinedField\nUPCA\nUPCE\nUPU\nVerticalLine\n``` \n\n**Example 1: split by qr code**\n\n```\n..\n\"searchString\": \"[[barcode:qrcode]]\",\n..\n```\n\n**Example 2: split by qr code with value**\n\n```\n..\n\"searchString\": \"[[barcode:qrcode bytescout]]\",\n..\n```\n\n**Example 3: split by qr code with value search with regex**\n\n```\n..\n\"searchString\": \"[[barcode:qrcode /bytescout\\\\.com/]]\",\n..\n```\n\n**Example 4: split by qr code or datamatrix with value search with regex**\n\n```\n..\n\"searchString\": \"[[barcode:qrcode,datamatrix /bytescout\\\\.com/]]\",\n..\n```\n\n| **Attributes** |\n| --- |\n| **excludeKeyPages** optional, `false` by default Set to `true` if you want to exclude pages where text was found. |\n| **regexSearch** optional, `false` by default Set to `true` to enable regular expressions for the search string. \" \n| **caseSensitive** optional, `false` by default Set to `true` to enable case-sensitive search. |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **name** optional File name for the generated output. The data type must need to be a string. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Data must need to be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/pdf/split2 (split by barcode)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-split/split_by_barcode.pdf\",\n \"searchString\": \"[[barcode:qrcode,datamatrix /bytescout\\\\.com/]]\",\n \"excludeKeyPages\": true,\n \"regexSearch\": false,\n \"caseSensitive\": false,\n \"inline\": true,\n \"name\": \"output-split-by-barcode\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/split2",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"split2"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"ed10aeb4522d8c123a3e9517dc983a93\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "3cf2204c-622f-4174-942c-fe153196f307"
},
{
"key": "X-Runtime",
"value": "4.723064"
},
{
"key": "Date",
"value": "Mon, 19 Sep 2022 11:44:02 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"urls\": [\n \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/A2WX2GR0PX4818EIKW96VR3BZTK5FWT2/output-split-by-barcode_page1.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzEK3%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDH1Gv1Q88EtgGpfAYiKCAaQTLV5ot8KMblEXIEFzeznT8mOeGKylp0uktJk2Se8SK5r3nfQTJKa8JqJE0GcW9vOtcBPPqHcPZXf2iQkvSk3yvFJv6cDj8%2B6kck0Eadz4BOXz0ljrE1Vt%2BX2gItx86Fd8rldFG3TL7u99FKiuc1rN9OaBRJpPHL12fVP2gjuVUUIomqShmQYyKHbhGDuLKoCWq%2BdLkggz2eTJna6w9eWR7QMvpIJxc8sBGFT1WEm%2FsyA%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHORHIVCFW/20220919/us-west-2/s3/aws4_request&X-Amz-Date=20220919T114402Z&X-Amz-SignedHeaders=host&X-Amz-Signature=8241ad05ecb5555cbbd4998b5c334104f2849bf4177384e86fbb5cc5d7e81ce8\",\n \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/B6Z9J274GZ5BK5QYK547ST4T5WF61LNQ/output-split-by-barcode_page3-5.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzEK3%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDH1Gv1Q88EtgGpfAYiKCAaQTLV5ot8KMblEXIEFzeznT8mOeGKylp0uktJk2Se8SK5r3nfQTJKa8JqJE0GcW9vOtcBPPqHcPZXf2iQkvSk3yvFJv6cDj8%2B6kck0Eadz4BOXz0ljrE1Vt%2BX2gItx86Fd8rldFG3TL7u99FKiuc1rN9OaBRJpPHL12fVP2gjuVUUIomqShmQYyKHbhGDuLKoCWq%2BdLkggz2eTJna6w9eWR7QMvpIJxc8sBGFT1WEm%2FsyA%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHORHIVCFW/20220919/us-west-2/s3/aws4_request&X-Amz-Date=20220919T114402Z&X-Amz-SignedHeaders=host&X-Amz-Signature=94764cfb37819f2a4885ba064dd1ae20f38f42d6bc6c1a208010637fca74a591\",\n \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/XT5TD1BDBFDNKX0LM6N5GLFLOAF1UC0Y/output-split-by-barcode_page7-9.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzEK3%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDH1Gv1Q88EtgGpfAYiKCAaQTLV5ot8KMblEXIEFzeznT8mOeGKylp0uktJk2Se8SK5r3nfQTJKa8JqJE0GcW9vOtcBPPqHcPZXf2iQkvSk3yvFJv6cDj8%2B6kck0Eadz4BOXz0ljrE1Vt%2BX2gItx86Fd8rldFG3TL7u99FKiuc1rN9OaBRJpPHL12fVP2gjuVUUIomqShmQYyKHbhGDuLKoCWq%2BdLkggz2eTJna6w9eWR7QMvpIJxc8sBGFT1WEm%2FsyA%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHORHIVCFW/20220919/us-west-2/s3/aws4_request&X-Amz-Date=20220919T114402Z&X-Amz-SignedHeaders=host&X-Amz-Signature=0a7c90a05fd159659451d29273284fbf422d34bd204c07fbc9abdf7a36a84294\"\n ],\n \"pageCount\": 10,\n \"error\": false,\n \"status\": 200,\n \"name\": \"output-split-by-barcode.pdf\",\n \"credits\": 350,\n \"duration\": 4456,\n \"remainingCredits\": 98221710\n}"
}
]
}
],
"description": "Split PDF into multiple PDF files.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "31.1 PDF Merge",
"item": [
{
"name": "/pdf/merge",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-merge/sample1.pdf,https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-merge/sample2.pdf\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/merge",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"merge"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output. Data must need to be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Data must need to be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/pdf/merge",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-merge/sample1.pdf,https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-merge/sample2.pdf\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/merge",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"merge"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"1dce21b30851ab3f25027c51530d74e5\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "e6823806-acbc-43e3-9268-8eb4051bbd7f"
},
{
"key": "X-Runtime",
"value": "0.631270"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:09:53 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/3ec287356c0b4e02b5231354f94086f2/result.pdf\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 98465\n}"
}
]
}
],
"description": "Merge PDF from two or more PDF files into a new one.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "31.2 PDF Merge From Anything",
"item": [
{
"name": "/pdf/merge2 (supports zip, doc, rtf, xls, png, jpg etc)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-merge/sample1.pdf,https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls, https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-merge/images-and-documents.zip\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/merge2",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"merge2"
]
},
"description": "This endpoint is similar to `/pdf/merge` but it also supports `zip, doc, docx, xls, xlsx, rtf, txt, png, jpg` files as source. \n\nWe recommended to use this endpoint in `\"async\": true` mode because it may need to convert source documents to pdf. \n\nThis endpoint also consumes more credits because of the internal conversions.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/pdf/merge2",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-merge/sample1.pdf,https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls, https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-merge/images-and-documents.zip\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/merge2",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"merge2"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"1dce21b30851ab3f25027c51530d74e5\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "e6823806-acbc-43e3-9268-8eb4051bbd7f"
},
{
"key": "X-Runtime",
"value": "0.631270"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:09:53 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/3ec287356c0b4e02b5231354f94086f2/result.pdf\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 98465\n}"
}
]
}
],
"description": "Merge PDF from two or more pdf, doc, xls, images, even zip with documents and images into a new PDF.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "32. PDF Password And Security",
"item": [
{
"name": "/pdf/security/add",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-merge/sample1.pdf\",\n \"ownerPassword\": \"12345\",\n \"userPassword\": \"54321\",\n \"EncryptionAlgorithm\": \"AES_128bit\",\n \"AllowPrintDocument\": false,\n \"AllowFillForms\": false,\n \"AllowModifyDocument\": false,\n \"AllowContentExtraction\": false,\n \"AllowModifyAnnotations\": false,\n \"PrintQuality\": \"LowResolution\",\n \"name\": \"output-protected.pdf\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/security/add",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"security",
"add"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **ownerPassword** required The **main** owner password that is used for document encryption and for setting/removing restrictions. |\n| **userPassword** optional The optional user password will be asked for viewing and printing document. |\n| **encryptionAlgorithm** optional Encryption algorithm. Valid values: `RC4_40bit`, `RC4_128bit`, `AES_128bit`, `AES_256bit`. AES_128bit or higher is recommended. |\n| **allowAccessibilitySupport** optional Allow or prohibit content extraction for accessibility needs. `true/false`. Note: this restriction applies when `userPassword` (if any) is entered. This restriction does not apply if the user enters `Owner Password`. |\n| **allowAssemblyDocument** optional Allow or prohibit assembling the document. `true/false`. Note: this restriction applies when `userPassword` (if any) is entered. This restriction does not apply if the user enters `Owner Password`. |\n| **allowPrintDocument** true/false Allow or prohibit printing PDF document. Note: this restriction applies when `userPassword` (if any) is entered. This restriction does not apply if the user enters `Owner Password`. |\n| **allowFillForms** true/false Allow or prohibit the filling of interactive form fields (including signature fields) in the PDF documents. Note: this restriction applies when `userPassword` (if any) is entered. This restriction does not apply if the user enters `Owner Password`. |\n| **allowModifyDocument** true/false Allow or prohibit modification of PDF document. Note: this restriction applies when `userPassword` (if any) is entered. This restriction does not apply if the user enters `Owner Password`. |\n| **allowContentExtraction** true/false Allow or prohibit copying content from PDF document. Note: this restriction applies when `userPassword` (if any) is entered. This restriction does not apply if the user enters `Owner Password`. |\n| **allowModifyAnnotations** true/false Allow or prohibit interacting with text annotations and forms in PDF document. Note: this restriction applies when `userPassword` (if any) is entered. This restriction does not apply if the user enters `Owner Password`. |\n| **printQuality** optional Allowed printing quality. Valid values: `HighResolution`, `LowResolution`. Note: this restriction applies when `userPassword` (if any) is entered. This restriction does not apply if the user enters `Owner Password`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **password** required The owner/user password to open files and remove security features. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **name** optional File name for the generated output. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Data must need to be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/pdf/security/remove",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-security/ProtectedPDFFile.pdf\",\n \"password\": \"admin@123\",\n \"name\": \"unprotected\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/security/remove",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"security",
"remove"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"2d1414977d73575baf9477691cc22a68\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "8f8ccd94-b557-4729-9be2-24f841180171"
},
{
"key": "X-Runtime",
"value": "0.619337"
},
{
"key": "Date",
"value": "Sat, 17 Apr 2021 14:43:03 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/9f2a754f76db46ac93781b3d2c6694c3/ProtectedPDFFile.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"ProtectedPDFFile.pdf\",\n \"remainingCredits\": 616187,\n \"credits\": 21\n}"
}
]
}
],
"description": "Add password and security limitations to PDF or remove existing limits and password from existing PDF files.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "32.1. User Controlled Data Encryption and Decryption",
"item": [
{
"name": "Read Custom Encrypted PDF",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "your api key for PDF.co API access. Get yours at https://app.pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.pdf\",\n \"async\": false,\n \"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'HelloThisKey1234', 'DataDecryptionIV': 'TreloThisKey1234' }\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/info",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"info"
]
},
"description": "This sample request demonstrates how to set `profiles` with built-in decryption options for AES encrypted document (doc/docx) to pdf endpoint.\n\nFor the details on available user-controlled encryption and decryption options please review [this article](https://apidocs.pdf.co/kb/Security/user-controlled-encryption-and-decryption-options)."
},
"response": [
{
"name": "Read Custom Encrypted PDF",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "your api key for PDF.co API access. Get yours at https://app.pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.pdf\",\n \"async\": false,\n \"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'HelloThisKey1234', 'DataDecryptionIV': 'TreloThisKey1234' }\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/info",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"info"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"9ac26baac4909d902c602331f3aca8c8\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "e190d6f8-b15a-4684-abaf-860b9ed97f82"
},
{
"key": "X-Runtime",
"value": "0.462471"
},
{
"key": "Date",
"value": "Fri, 20 May 2022 11:50:33 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"info\": {\n \"PageCount\": 1,\n \"Author\": \"Hiren Patel\",\n \"Title\": \"\",\n \"Producer\": \"Microsoft® Word 2016\",\n \"Subject\": \"\",\n \"CreationDate\": \"2021-01-10T10:10:54+05:30\",\n \"Bookmarks\": \"\",\n \"Keywords\": \"\",\n \"Creator\": \"Microsoft® Word 2016\",\n \"Encrypted\": false,\n \"PasswordProtected\": false,\n \"PageRectangle\": {\n \"Location\": {\n \"IsEmpty\": true,\n \"X\": 0,\n \"Y\": 0\n },\n \"Size\": \"612, 792\",\n \"X\": 0,\n \"Y\": 0,\n \"Width\": 612,\n \"Height\": 792,\n \"Left\": 0,\n \"Top\": 0,\n \"Right\": 612,\n \"Bottom\": 792,\n \"IsEmpty\": false\n },\n \"ModificationDate\": \"2021-01-10T10:10:54+05:30\",\n \"AttachmentCount\": 0,\n \"EncryptionAlgorithm\": \"None\",\n \"PermissionPrinting\": true,\n \"PermissionModifyDocument\": true,\n \"PermissionContentExtraction\": true,\n \"PermissionModifyAnnotations\": true,\n \"PermissionFillForms\": true,\n \"PermissionAccessibility\": true,\n \"PermissionAssemble\": true,\n \"PermissionHighQualityPrint\": true,\n \"CustomProperties\": []\n },\n \"error\": false,\n \"status\": 200,\n \"credits\": 7,\n \"duration\": 446,\n \"remainingCredits\": 98320547\n}"
}
]
},
{
"name": "Custom encrypted Docx to PDF",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. Your API key for PDF.co. Get your API key at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.docx\",\r\n \"name\": \"result.pdf\",\r\n \"async\": false,\r\n \"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'HelloThisKey1234', 'DataDecryptionIV': 'TreloThisKey1234' }\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/doc",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"doc"
]
},
"description": "This sample request demonstrates how to set `profiles` with built-in decryption options for AES encrypted document (doc/docx) to pdf endpoint.\n\nFor the details on available user-controlled encryption and decryption options please review [this article](https://apidocs.pdf.co/kb/Security/user-controlled-encryption-and-decryption-options)."
},
"response": [
{
"name": "Custom encrypted Docx to PDF",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. Your API key for PDF.co. Get your API key at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.docx\",\r\n \"name\": \"result.pdf\",\r\n \"async\": false,\r\n \"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'HelloThisKey1234', 'DataDecryptionIV': 'TreloThisKey1234' }\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/from/doc",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"from",
"doc"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"392ed5238f5d10eb0a86f3b13408c4fa\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "14aae584-1796-4c46-9c5e-4a3ea173fce7"
},
{
"key": "X-Runtime",
"value": "2.920015"
},
{
"key": "Date",
"value": "Fri, 20 May 2022 11:50:55 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/GB6XMWN2VGDTUMKBQBRI24EWYSFRLLLL/result.pdf\",\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"credits\": 21,\n \"duration\": 2903,\n \"remainingCredits\": 98320505\n}"
}
]
},
{
"name": "Read QR Code From Encrypted PNG",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. Your API key for PDF.co. Get your API key at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/barcode_encrypted_aes128.png\",\r\n\t\"types\": \"QRCode\",\r\n\t\"inline\": true,\r\n \"async\": false,\r\n\t\"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'Qweasd1234567890', 'DataDecryptionIV': '0mDI&qLv*ivTCd$*' }\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/read/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"read",
"from",
"url"
]
},
"description": "This sample request demonstrates how to set `profiles` with built-in decryption options for QR Code decoding from AES encrypted PNG image file.\n\nFor the details on available user-controlled encryption and decryption options please review [this article](https://apidocs.pdf.co/kb/Security/user-controlled-encryption-and-decryption-options)."
},
"response": [
{
"name": "Read QR Code From Encrypted PNG",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. Your API key for PDF.co. Get your API key at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/barcode_encrypted_aes128.png\",\r\n\t\"types\": \"QRCode\",\r\n\t\"inline\": true,\r\n \"async\": false,\r\n\t\"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'Qweasd1234567890', 'DataDecryptionIV': '0mDI&qLv*ivTCd$*' }\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/read/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"read",
"from",
"url"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"2533ffa5ceba51a718a98651d6b85be0\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "8a2c86c6-fc7e-4211-b620-8f5a5db7b8f5"
},
{
"key": "X-Runtime",
"value": "0.400168"
},
{
"key": "Date",
"value": "Fri, 20 May 2022 11:51:18 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"barcodes\": [\n {\n \"Value\": \"]Q3\\\\01695046551543111713033110TEST5632\",\n \"RawData\": \"\",\n \"Type\": 14,\n \"Rect\": \"11, 11, 75, 75\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/barcode_encrypted_aes128.png\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"QRCode\"\n }\n ],\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"credits\": 35,\n \"duration\": 375,\n \"remainingCredits\": 98320470\n}"
}
]
},
{
"name": "PDF Encrypted by SalesForce with AES128 To JPG",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. Your API key for PDF.co. Get your API key at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.pdf\",\r\n \"name\": \"result.jpg\",\r\n \"inline\" : true,\r\n \"pages\": \"0\",\r\n \"async\": false,\r\n \"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'HelloThisKey1234', 'DataDecryptionIV': 'TreloThisKey1234' }\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/jpg",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"jpg"
]
},
"description": "This sample request demonstrates how to set `profiles` with built-in decryption options for PDF to JPG conversion PDF file that was previously encrypted with AES 128 in SalesForce.\n\nFor the details on available user-controlled encryption and decryption options please review [this article](https://apidocs.pdf.co/kb/Security/user-controlled-encryption-and-decryption-options)."
},
"response": [
{
"name": "PDF Encrypted by SalesForce with AES128 To JPG",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. Your API key for PDF.co. Get your API key at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.pdf\",\r\n \"name\": \"result.jpg\",\r\n \"inline\" : true,\r\n \"pages\": \"0\",\r\n \"async\": false,\r\n \"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'HelloThisKey1234', 'DataDecryptionIV': 'TreloThisKey1234' }\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/convert/to/jpg",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"convert",
"to",
"jpg"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"2001574a33ea75512c51bc4c0dddf0b9\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "3bb740bc-ef37-43a7-9099-ceb63cd79c51"
},
{
"key": "X-Runtime",
"value": "0.428321"
},
{
"key": "Date",
"value": "Fri, 20 May 2022 11:51:41 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"urls\": [\n \"https://pdf-temp-files.s3.amazonaws.com/0C38ED7DQO0NB5UEJTAP35MEPPAPJXAT/result.jpg\"\n ],\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.jpg\",\n \"credits\": 12,\n \"duration\": 408,\n \"remainingCredits\": 98320458\n}"
}
]
},
{
"name": "Merge PDFs encrypted by SalesForce to new PDF encrypted for SalesForce",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript"
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. Your API key for PDF.co. Get your API key at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.pdf, https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.pdf\",\r\n \"name\": \"result.pdf\",\r\n \"pages\": \"0\",\r\n \"async\": false,\r\n \"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'HelloThisKey1234', 'DataDecryptionIV': 'TreloThisKey1234', 'DataEncryptionAlgorithm': 'AES128', 'DataEncryptionKey': 'HelloThisKey1234', 'DataEncryptionIV': 'TreloThisKey1234' }\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/merge",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"merge"
]
},
"description": "This sample request demonstrates how to set `profiles` with built-in decryption options for merging multiple PDF files previously encrypted with AES 128 encryption in SalesForce. Also, it enables user-controlled encryption for output PDF file so output PDF is also user-encrypted and will require applying AES decryption before processing in SalesForce or another platforms.\n\nFor the details on available user-controlled encryption and decryption options please review [this article](https://apidocs.pdf.co/kb/Security/user-controlled-encryption-and-decryption-options)."
},
"response": [
{
"name": "Merge PDFs encrypted by SalesForce to new PDF encrypted for SalesForce",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. Your API key for PDF.co. Get your API key at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.pdf, https://pdfco-test-files.s3.us-west-2.amazonaws.com/encryption/sample_encrypted_aes128.pdf\",\r\n \"name\": \"result.pdf\",\r\n \"pages\": \"0\",\r\n \"async\": false,\r\n \"profiles\": \"{ 'DataDecryptionAlgorithm': 'AES128', 'DataDecryptionKey': 'HelloThisKey1234', 'DataDecryptionIV': 'TreloThisKey1234', 'DataEncryptionAlgorithm': 'AES128', 'DataEncryptionKey': 'HelloThisKey1234', 'DataEncryptionIV': 'TreloThisKey1234' }\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/merge",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"merge"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"af68c04856e3b7eaf6b6b5409f06e15a\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "79887f56-7929-4ed5-bda4-2e56cae7dc7b"
},
{
"key": "X-Runtime",
"value": "0.475044"
},
{
"key": "Date",
"value": "Fri, 20 May 2022 11:51:52 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/DH86OQ2JRK7CZ3WCVTICA84TLPUVJCCS/result.pdf\",\n \"pageCount\": 2,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"credits\": 4,\n \"duration\": 457,\n \"remainingCredits\": 98320454\n}"
}
]
}
],
"description": "PDF.co platform provides built-in user controlled data encryption that you can use for input and output files.\n\nUser-controlled encryption and decryption can be applied in almost any API endpoint that reads input files and/or writes output files. Just use `profiles` parameter to pass user-controlled encryption and/or decryption options like encryption algorithm, password, initialization vector (aka 2nd password).\n\nFor the detailed information on options and encryption algorithms available, please [check this knowledgebase article](https://apidocs.pdf.co/kb/Security/user-controlled-encryption-and-decryption-options).\n\n**Popular Use Cases:**\n\n* Automatically encrypt output files with strong AES encryption and copy these files into cloud storage like Google Drive or Dropbox. With user controlled encrypted data inside, cloud storage services can not even scan the content of your files.\n* Automatically read encrypted documents provided and previously encrypted by by 3rd party services like SalesForce, Zapier, Integromat and others (including javascript, php, java, .net custom apps).\n* Add another layer of security by using user-controlled data encryption for processing documents. With user-controlled encryption even temporary files requires further decryption to be readable. This way even if a temporary link to a file is leaked, it is not possible to read this file without applying decryption with your custom provided password.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "33. PDF Rotate Pages",
"item": [
{
"name": "/pdf/edit/rotate",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-optimize/sample.pdf\",\n \"name\": \"result.pdf\",\n \"angle\": 90,\n \"pages\": \"0-2,4\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/rotate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"rotate"
]
},
"description": "Rotates selected pages inside a PDF file.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **angle** optional angle in degrees. Supported values `90`, `180`, and `270`. |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document. Data must need to be in a \"string\" format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Data must need to be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/pdf/edit/rotate",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-optimize/sample.pdf\",\n \"name\": \"result.pdf\",\n \"angle\": 90,\n \"pages\": \"0-2,4\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/rotate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"rotate"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"9c113df2476d1167a8ad26de4f34d203\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "df865b81-ead8-4df9-9311-bc682cf1570b"
},
{
"key": "X-Runtime",
"value": "0.530981"
},
{
"key": "Date",
"value": "Thu, 23 Jun 2022 13:59:02 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/2EK4QYIZU1XUEUH853VTSK47NPLXCUYX/result.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzEFsaDC5Vfgoi83YzdW9HXiKCAYBVHK096wqoUyu8Ckq8jEhV1DBv9VzHY1EcPWvfG3L2YrFa8QC5ZMr3UhFEn4%2B%2B2u6e%2FcdZd%2FXbdVaI45yNE%2Btz28UHMVxCQUClj9kCHrMyJ4W1%2BlnDgLi9JUHt7SkIvV9Lj7GLDBOXy22KCND86HdtPg0uT%2FNQtcjJm%2F34cISImKYov63NlQYyKG%2BEO%2FQLP%2BzJuugBdSLcKUOTL52dnc1l82ye1u5kYvTlbfPMdisU1tY%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHESTCUXXF/20220623/us-west-2/s3/aws4_request&X-Amz-Date=20220623T135902Z&X-Amz-SignedHeaders=host&X-Amz-Signature=78f2fe7f22ebd1fc2c329a855c7582f9deb09c0c5045281b9b2420a5afb792cf\",\n \"fileSize\": 1064923,\n \"pageCount\": 4,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"credits\": 28,\n \"duration\": 245,\n \"remainingCredits\": 98194839\n}"
}
]
},
{
"name": "/pdf/edit/rotate/auto",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-fix-rotation/rotated_pages.pdf\",\n \"name\": \"result.pdf\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/rotate/auto",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"rotate",
"auto"
]
},
"description": "Uses AI to automatically **fix the rotation** of pages inside scanned PDF based on text analysis. To change text language change the `lang` parameter (`eng` by default).\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **lang** optional Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. The default is \"eng\". Other languages are also supported: `deu`, `spa`, `chi_sim`, `jpn`, and many others (full list of supported OCR languages is [here](/kb/OCR/list-of-supported-languages-for-ocr). You can also use 2 languages simultaneously like this: `eng+deu` or `jpn+kor` (any combination). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Data must need to be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/pdf/edit/rotate/auto",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-fix-rotation/rotated_pages.pdf\",\n \"name\": \"result.pdf\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/rotate/auto",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"rotate",
"auto"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"7030601c6b8356313df01ef46cbba60f\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "588b14b9-ab4d-41a9-b657-e3c3c8f0562f"
},
{
"key": "X-Runtime",
"value": "6.279570"
},
{
"key": "Date",
"value": "Thu, 23 Jun 2022 14:10:05 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/HQ86WA7MFED1Q7C843NDSKVRW5AFVTMP/result.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzEFwaDD6ndEhlfId4KouQ8yKCASr8amowIV2tLAi%2BhjnlVi%2FNYjf8ZJ3MqgKWsYVm5dQ8fQx7hceGdmtqhB6OH8t9xdacbMEcoMIpQr1BcSSfu2ZFfGFBDaHNpaSTfPXhkNnQaZFOi5KFozZiPBP9xPoSCV%2Fj%2BLIrDsOF%2Fb89i1Nd4OJFoXnfhjf03ZHJ%2BNCQEC%2BbePsovsjNlQYyKIV1qb1wGdwgJ%2ByibJ5x%2BQGoG4x2ebnEGTQkKBf4zobYT9Uv6FVQ%2FJg%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHB3D5EZ56/20220623/us-west-2/s3/aws4_request&X-Amz-Date=20220623T141005Z&X-Amz-SignedHeaders=host&X-Amz-Signature=351ad45980cad0d3f634f7b784d5445b9c4e1ad2244912f56ea065209d73bb30\",\n \"fileSize\": 455115,\n \"pageCount\": 3,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"credits\": 84,\n \"duration\": 6002,\n \"remainingCredits\": 98194629\n}"
}
]
}
],
"description": "PDF utilities (change rotation, fix rotation, delete pages etc)",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "33.1. PDF Delete Pages",
"item": [
{
"name": "/pdf/edit/delete-pages",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json",
"disabled": true
},
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf\",\n \"pages\": \"1-2\",\n \"name\": \"result.pdf\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/delete-pages",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"delete-pages"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. **IMPORTANT:** The very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means first page, then 3rd page to 6th page, and then the range from 8th (index = `7`) page till the end of the document. Data must need to be in a \"string\" format. |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/pdf/edit/delete-pages",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json",
"disabled": true
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf\",\n \"pages\": \"1-2\",\n \"name\": \"result.pdf\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/edit/delete-pages",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"edit",
"delete-pages"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"168c96114478ca85be07bddc7f20c785\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "140a26a8-a42b-48a1-80fa-e2e624181675"
},
{
"key": "X-Runtime",
"value": "0.876268"
},
{
"key": "Date",
"value": "Mon, 07 Sep 2020 13:30:28 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/d15e5b2c89c04484ae6ac7244ac43ac2/result.pdf\",\n \"pageCount\": 2,\n \"error\": false,\n \"status\": 200,\n \"name\": \"result.pdf\",\n \"remainingCredits\": 60100\n}"
}
]
}
],
"description": "PDF utilities (change rotation, fix rotation, delete pages etc)",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "34. PDF Compress and Optimize",
"item": [
{
"name": "/pdf/optimize",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-optimize/sample.pdf\",\r\n \"name\": \"output.pdf\",\r\n \"profiles\": \"{ 'ImageOptimizationFormat': 'JPEG', 'JPEGQuality': 25, 'ResampleImages': true, 'ResamplingResolution': 120, 'GrayscaleImages': false }\",\r\n \"async\": false\r\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/optimize",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"optimize"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **name** optional File name for the generated output. Must be in a \"string\" format.|\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **password** optional Password of PDF file. Must be in a \"string\" format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. You can adjust PDF compression and optimization configuration using this parameter. Check [this KB article for compression configuration details](https://apidocs.pdf.co/kb/PDF%20Compress%20and%20Optimize%20(pdf-compress)/adjust-compression-options) or Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for all profile examples. |"
},
"response": [
{
"name": "/pdf/optimize",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\r\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-optimize/sample.pdf\",\r\n \"async\": false,\r\n \"profiles\": \"{ 'ImageOptimizationFormat': 'JPEG', 'JPEGQuality': 25, 'ResampleImages': true, 'ResamplingResolution': 120, 'GrayscaleImages': false }\"\r\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/pdf/optimize",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"pdf",
"optimize"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"b525bebf40c3f0e9f7362c6c588ba623\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "880cd98d-6cb5-4240-b4bf-f9a001a0981b"
},
{
"key": "X-Runtime",
"value": "3.148408"
},
{
"key": "Date",
"value": "Thu, 15 Sep 2022 13:52:07 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/TEPHYOOWTKN47RSMF11CXHXHD7U68ZSS/sample-compressed.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzEEsaDMAT9Cnzd6%2FnDfVKYSKCAU6XCvsgWTRfJHWmoO2iJfJ6YSVShb6ddOXU9Ks5G4Ai20O2idqOaLLslwt6uEnT9EbwpzBMEXuqREkoTTmUOEcXJi9zO5lkLoQ16tXCbfmUF8cvJxVYBXGRHJlzHQ20kJtN6lP237e8rlMtNRIK0f1QsIQswfWy2BFz8IuOndZRu8goquiLmQYyKBBjAmoWcEqs0iMA7MizFAdIbFGydTYXcptaixm%2F%2BfayUZKUByJHURU%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHNTO33MZG/20220915/us-west-2/s3/aws4_request&X-Amz-Date=20220915T135207Z&X-Amz-SignedHeaders=host&X-Amz-Signature=4f3334f68f1a98d3a9bfe09ec03d3e7d10fb7709ce58b711e36652c59a4d6b4a\",\n \"fileSize\": 798621,\n \"pageCount\": 5,\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample-compressed.pdf\",\n \"credits\": 105,\n \"duration\": 2886,\n \"remainingCredits\": 98256037\n}"
}
]
}
],
"description": "Optimize PDF document to reduce its size.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "35. XLS / XLSX to CSV",
"item": [
{
"name": "/xls/convert/to/csv",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/csv",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"csv"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **worksheetIndex** optional The index of the worksheet. |\n| **quotationSymbol** optional Must be in a \"string\" format.|\n| **separatorSymbol** optional Must be in a \"string\" format. |\n| **inline** optional, true/false Set to `true` to return result content in the response instead of linking to results. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/xls/convert/to/csv",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/csv",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"csv"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"77bd733db60b78c112cf61f8e283ec0c\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "f7d92194-d6bf-449e-8ecd-05d3900486aa"
},
{
"key": "X-Runtime",
"value": "0.450591"
},
{
"key": "Date",
"value": "Sat, 12 Sep 2020 15:00:01 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/bd58508fdbaf41cb81309e2195276305/Input.csv\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"Input.csv\",\n \"remainingCredits\": 59856\n}"
}
]
}
],
"description": "Convert XLS into CSV comma separated values file. ",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "36. XLS/XLSX to JSON",
"item": [
{
"name": "/xls/convert/to/json",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/json",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"json"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **worksheetIndex** optional The index of the worksheet to use. |\n| **inline** optional Set to `true` to return result content in the response instead of linking to the result. Must be one of: `true`, or `false`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/xls/convert/to/json",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/json",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"json"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"463248bd7de87b26ca652e0addda3784\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "32e8c5d8-5e62-455d-8632-ebf693c0317c"
},
{
"key": "X-Runtime",
"value": "1.354289"
},
{
"key": "Date",
"value": "Sat, 12 Sep 2020 14:59:37 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/c4e7e487bf324c3b955f5aa7388e3e17/Input.json\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"Input.json\",\n \"remainingCredits\": 59859\n}"
}
]
}
],
"description": "Convert XLS, XLSX or CSV into JSON.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "37. XLS/XLSX to HTML",
"item": [
{
"name": "/xls/convert/to/html",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"html"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **worksheetIndex** optional The index of the worksheet to use. |\n| **inline** optional Set to `true` to return result content in the response instead of the link to results. Must be one of: `true`, or `false`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/xls/convert/to/html",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/html",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"html"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"859d7dfeb17f63ebc6982dd200bfe146\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "0baed8a8-b9b3-42f3-b957-0b7c3ea1bf74"
},
{
"key": "X-Runtime",
"value": "0.461477"
},
{
"key": "Date",
"value": "Sat, 12 Sep 2020 14:59:15 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/d30b0c85ee244123aa0c13094aa80d2c/Input.html\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"Input.html\",\n \"remainingCredits\": 59862\n}"
}
]
}
],
"description": "Convert XLS, XLSX or CSV into HTML.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "38. XLS/XLSX to TXT",
"item": [
{
"name": "/xls/convert/to/txt",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/txt",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"txt"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **worksheetIndex** optional The index of the worksheet to use. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": []
}
],
"description": "Convert XLS, XLSX or CSV into Text file.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "39. XLS/XLSX to XML",
"item": [
{
"name": "/xls/convert/to/xml",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/xml",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"xml"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **worksheetIndex** optional The index of the worksheet to use. |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return the link to the output file (default). |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/xls/convert/to/json",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "async",
"value": "",
"description": "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`.",
"type": "text",
"disabled": true
},
{
"key": "encrypt",
"value": "true",
"description": "optional. Enable encryption for the output file. Must be one of: `true`, `false`.",
"type": "text"
},
{
"key": "file",
"value": "",
"description": "optional. Source PDF file.",
"type": "text",
"disabled": true
},
{
"key": "url",
"value": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/other/Input.xls",
"description": "optional. URL of the source XLS file. Must be a String.",
"type": "text"
},
{
"key": "name",
"value": "",
"description": "optional. File name for generated output. Must be a String.",
"type": "text",
"disabled": true
},
{
"key": "worksheetIndex",
"value": "",
"description": "optional. Must be a String.",
"type": "text",
"disabled": true
},
{
"key": "inline",
"value": "true",
"description": "optional. Must be one of: `true`, `false`.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/xls/convert/to/json",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"xls",
"convert",
"to",
"json"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"5e32d2266a44280e8609f28a06568d4b\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "e36c9030-feb9-4dae-9af5-41b982922c7f"
},
{
"key": "X-Runtime",
"value": "0.655221"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 13:58:29 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/18009bcb2d414cb794fa41032cbd7d0b/Input.json?X-Amz-Expires=3600&x-amz-security-token=FwoGZXIvYXdzEGcaDPYo6i5PK8497%2BllZiKBAYbQsgUq76LLLL265cy6QB5rJhrQEQBVlw2XdYpfNuBogitkFJE7ZdUKvIuP4h3%2BxJ861WpOUhheZSE5P4GpCoac6gUYJB5Qv8IEXBIDNjevMwI4ZYaHjUIqhRSjenDuMDCd406CXFDlqKrJM%2BzYmWnL%2FC2YNyN0CVr6snsvnaS7ySiFovTyBTIoG8X6teTW6Niw6yZIjR2QfkLQ20P720ku%2BsZwtImqLuxxxyzUJwLdBQ%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHFZBBM6NT/20200302/us-west-2/s3/aws4_request&X-Amz-Date=20200302T135827Z&X-Amz-SignedHeaders=host;x-amz-security-token&X-Amz-Signature=59606ca78a0de19115f3981b3bef3e8ca12649fa0612e90171bb0edc4c63f909\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"Input.json\",\n \"remainingCredits\": 98516\n}"
}
]
}
],
"description": "Convert XLS, XLSX or CSV into XML.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "40. Barcode Generator",
"item": [
{
"name": "/barcode/generate",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"barcode.png\",\n \"value\": \"abcdef123456\",\n \"type\": \"QRCode\",\n \"async\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/generate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"generate"
]
},
"description": "| **Attributes** |\n| --- |\n| **value** required Set the string value to encode inside the barcode. Must be in a \"string\" format. |\n| **type** optional Set the barcode type, `QRCode` By default. **supported barcode types:** Code128, Code39, Postnet, UPCA, EAN8, ISBN, Codabar, I2of5, Code93, EAN13, JAN13, Bookland, UPCE, PDF417, PDF417Truncated, DataMatrix, QRCode, Aztec, Planet, EAN128, GS1_128, USPSSackLabel, USPSTrayLabel, DeutschePostIdentcode, DeutschePostLeitcode, Numly, PZN, OpticalProduct, SwissPostParcel, RoyalMail, DutchKix, SingaporePostalCode, EAN2, EAN5, EAN14, MacroPDF417, MicroPDF417, GS1_DataMatrix, Telepen, IntelligentMail, GS1_DataBar_Omnidirectional, GS1_DataBar_Truncated, GS1_DataBar_Stacked, GS1_DataBar_Stacked_Omnidirectional, GS1_DataBar_Limited, GS1_DataBar_Expanded, GS1_DataBar_Expanded_Stacked, MaxiCode, Plessey, MSI, ITF14, GTIN12, GTIN8, GTIN13, GTIN14, GS1_QRCode, PharmaCode |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). | \n| **inline** optional Must be one of: `true` to return data as inline or `false` to return the link to the output file (default). |\n| **decorationImage** optional, `QR-Code` only Set this to the image that you want to be inserted the logo inside the QR-Code barcode. To use your file please upload it first to the temporary storage, see the `Upload and Manage Files` section below to learn how to do it.\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/barcode/generate",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"barcode.png\",\n \"value\": \"abcdef123456\",\n \"type\": \"QRCode\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/generate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"generate"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"c84a84fb0b97eceafb569a58c9c3fee8\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "4d403f9d-b0a7-4f72-99b7-3d91742bb711"
},
{
"key": "X-Runtime",
"value": "0.632109"
},
{
"key": "Date",
"value": "Tue, 25 Aug 2020 17:47:54 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/9a87556a8b9e4f4eae60843e697250d4/barcode.png\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"barcode.png\",\n \"remainingCredits\": 60631\n}"
}
]
},
{
"name": "/barcode/generate (qr code)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"barcode.png\",\n \"value\": \"abcdef123456\",\n \"type\": \"QRCode\",\n \"inline\": false,\n \"async\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/generate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"generate"
]
},
"description": "| **Attributes** |\n| --- |\n| **value** required Set the string value to encode inside the barcode. Must be in a \"string\" format. |\n| **type** optional Set the barcode type, Must be in a \"string\" format. `QRCode` By default. **supported barcode types:** Code128, Code39, Postnet, UPCA, EAN8, ISBN, Codabar, I2of5, Code93, EAN13, JAN13, Bookland, UPCE, PDF417, PDF417Truncated, DataMatrix, QRCode, Aztec, Planet, EAN128, GS1_128, USPSSackLabel, USPSTrayLabel, DeutschePostIdentcode, DeutschePostLeitcode, Numly, PZN, OpticalProduct, SwissPostParcel, RoyalMail, DutchKix, SingaporePostalCode, EAN2, EAN5, EAN14, MacroPDF417, MicroPDF417, GS1_DataMatrix, Telepen, IntelligentMail, GS1_DataBar_Omnidirectional, GS1_DataBar_Truncated, GS1_DataBar_Stacked, GS1_DataBar_Stacked_Omnidirectional, GS1_DataBar_Limited, GS1_DataBar_Expanded, GS1_DataBar_Expanded_Stacked, MaxiCode, Plessey, MSI, ITF14, GTIN12, GTIN8, GTIN13, GTIN14, GS1_QRCode, PharmaCode |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return the link to the output file (default). |\n| **decorationImage** optional, `QR-Code` only Set this to the image that you want to be inserted the logo inside the QR-Code barcode. To use your file please upload it first to the temporary storage, see the `Upload and Manage Files` section below to learn how to do it. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/barcode/generate (qr code)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"barcode.png\",\n \"value\": \"abcdef123456\",\n \"type\": \"QRCode\",\n \"inline\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/generate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"generate"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"8b8cc26ad4c05c682d999c3f82ad83f6\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "d9cdc8a2-bef6-488d-800d-5e4776016800"
},
{
"key": "X-Runtime",
"value": "0.399964"
},
{
"key": "Date",
"value": "Wed, 02 Feb 2022 22:16:51 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/72bc579b37844d9f9e63ce06de5196d8/barcode.png\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"barcode.png\",\n \"duration\": 380,\n \"remainingCredits\": 98725598,\n \"credits\": 7\n}"
}
]
},
{
"name": "/barcode/generate (qr code with logo inside)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"barcode.png\",\n \"value\": \"abcdef123456\",\n \"type\": \"QRCode\",\n \"inline\": false,\n \"async\": false,\n \"decorationImage\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-generator/logo.png\"\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/generate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"generate"
]
},
"description": "| **Attributes** |\n| --- |\n| **value** required Set the string value to encode inside the barcode. Must be in a \"string\" format. |\n| **type** optional Set the barcode type, Must be in a \"string\" format. `QRCode` By default. **supported barcode types:** Code128, Code39, Postnet, UPCA, EAN8, ISBN, Codabar, I2of5, Code93, EAN13, JAN13, Bookland, UPCE, PDF417, PDF417Truncated, DataMatrix, QRCode, Aztec, Planet, EAN128, GS1_128, USPSSackLabel, USPSTrayLabel, DeutschePostIdentcode, DeutschePostLeitcode, Numly, PZN, OpticalProduct, SwissPostParcel, RoyalMail, DutchKix, SingaporePostalCode, EAN2, EAN5, EAN14, MacroPDF417, MicroPDF417, GS1_DataMatrix, Telepen, IntelligentMail, GS1_DataBar_Omnidirectional, GS1_DataBar_Truncated, GS1_DataBar_Stacked, GS1_DataBar_Stacked_Omnidirectional, GS1_DataBar_Limited, GS1_DataBar_Expanded, GS1_DataBar_Expanded_Stacked, MaxiCode, Plessey, MSI, ITF14, GTIN12, GTIN8, GTIN13, GTIN14, GS1_QRCode, PharmaCode |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **decorationImage** optional, `QR-Code` only Set this to the image that you want to be inserted the logo inside the QR-Code barcode. To use your file please upload it first to the temporary storage, see the `Upload and Manage Files` section below to learn how to do it. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/barcode/generate",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"barcode.png\",\n \"value\": \"abcdef123456\",\n \"type\": \"QRCode\",\n \"inline\": false,\n \"decorationImage\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-generator/logo.png\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/generate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"generate"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"c84a84fb0b97eceafb569a58c9c3fee8\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "4d403f9d-b0a7-4f72-99b7-3d91742bb711"
},
{
"key": "X-Runtime",
"value": "0.632109"
},
{
"key": "Date",
"value": "Tue, 25 Aug 2020 17:47:54 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/9a87556a8b9e4f4eae60843e697250d4/barcode.png\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"barcode.png\",\n \"remainingCredits\": 60631\n}"
}
]
},
{
"name": "/barcode/generate (datauri as output)",
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"barcode.png\",\n \"value\": \"abcdef123456\",\n \"type\": \"QRCode\",\n \"inline\": true,\n \"async\": false\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/generate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"generate"
]
},
"description": "| **Attributes** |\n| --- |\n| **value** required Set the string value to encode inside the barcode. Must be in a \"string\" format. |\n| **type** optional Set the barcode type, Must be in a \"string\" format. `QRCode` By default. **supported barcode types:** Code128, Code39, Postnet, UPCA, EAN8, ISBN, Codabar, I2of5, Code93, EAN13, JAN13, Bookland, UPCE, PDF417, PDF417Truncated, DataMatrix, QRCode, Aztec, Planet, EAN128, GS1_128, USPSSackLabel, USPSTrayLabel, DeutschePostIdentcode, DeutschePostLeitcode, Numly, PZN, OpticalProduct, SwissPostParcel, RoyalMail, DutchKix, SingaporePostalCode, EAN2, EAN5, EAN14, MacroPDF417, MicroPDF417, GS1_DataMatrix, Telepen, IntelligentMail, GS1_DataBar_Omnidirectional, GS1_DataBar_Truncated, GS1_DataBar_Stacked, GS1_DataBar_Stacked_Omnidirectional, GS1_DataBar_Limited, GS1_DataBar_Expanded, GS1_DataBar_Expanded_Stacked, MaxiCode, Plessey, MSI, ITF14, GTIN12, GTIN8, GTIN13, GTIN14, GS1_QRCode, PharmaCode |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n| **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](https://apidocs.pdf.co/98-upload-files#Temporary%20Files%20Upload:~:text=Temporary%20Files%20Upload). The maximum duration for link expiration varies based on your current subscription plan. [Learn more](https://apidocs.pdf.co/kb/Upload%20Download%20Files/how-to-increase-output-link-expiration?)
To store permanent input files (e.g. re-usable images, pdf templates, documents), Consider using [PDF.co built-in Files Storage](https://app.pdf.co/files). |\n| **inline** optional Must be one of: `true` to return data as inline or `false` to return a link to the output file (default). |\n| **decorationImage** optional, `QR-Code` only Set this to the image that you want to be inserted the logo inside the QR-Code barcode. To use your file please upload it first to the temporary storage, see the `Upload and Manage Files` section below to learn how to do it. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/barcode/generate (datauri as output)",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/json"
},
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"barcode.png\",\n \"value\": \"abcdef123456\",\n \"type\": \"QRCode\",\n \"inline\": true\n}"
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/generate",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"generate"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"5a894d5ef01e8e0c7568a2f65c8f793d\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "81e7688d-47dd-4b48-b307-bf7aa735783d"
},
{
"key": "X-Runtime",
"value": "0.318592"
},
{
"key": "Date",
"value": "Wed, 02 Feb 2022 22:16:20 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEsAAABLCAYAAAA4TnrqAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAOlSURBVHhe7ZBBimMxEMVy/0v34CELkSmBjH96NhaIwKtXlY9fP5fMfawN7mNtcB9rg/tYG9zH2kAf6/V6Pa5hHeaUTPNTjftYg8Z9rEEjPdYJdoc5JZaT0imUOzopywW7w5wSy0npFModnZTlgt1hTonlpHQK5Y5ObJm5SUpODeuU3CSWE53YMnOTlJwa1im5SSwnOrFl5iYpOTWsU3KTWE50YsvMTWI5sY7lxDrMTWI50YktMzeJ5cQ6lhPrMDeJ5UQntszcJJYT61hOrMPcJJYTndgyc5Ps5ob1S24Sy4lObJm5SXZzw/olN4nlRCe2zNwku7lh/ZKbxHKik7JcsDuWE3YosXyXckcnZblgdywn7FBi+S7ljk7KcsHuWE7YocTyXcodnXD5Kck38qc0dDIdOZV8I39KQyfTkVPJN/KnNHzyZaaPrP4v7mNtcB9rA/3n6SOXxHLCDiXTfFmY9j4l03xZ0NZ0cEksJ+xQMs2XhWnvUzLNlwVtTQeXxHLCDiXTfFmY9j4l03xZSK3p+JJYTtgxC9Pe0rAOc2qkr5sOLonlhB2zMO0tDeswp0b6uungklhO2DEL097SsA5zaqSvs0PMi8Zuxzyh3En/YIeYF43djnlCuZP+wQ4xLxq7HfOEcmf7H+yo5WS3Q42puySWk9R5/2bsqOVkt0ONqbsklpPUef9m7KjlZLdDjam7JJaT1Hn/fg1+hElKTo3SIaXfLh3AjzBJyalROqT026UD+BEmKTk1SoeUfrv0BdLHHXSYUyN13r+/Tvq4gw5zaqTO+/fXSR930GFOjdR5//4Dl5+SWF7gLiWWk9Ih2uKhpySWF7hLieWkdIi2eOgpieUF7lJiOSkdoq3dQ8bJHe5SY+oujam7NHRSlgsnd7hLjam7NKbu0tBJWS6c3OEuNabu0pi6S0MntszcJJYb7NPCbp+UXZ3YMnOTWG6wTwu7fVJ2dWLLzE1iucE+Lez2SdnViS0zN0nJTWPqVsk0Xxo6sWXmJim5aUzdKpnmS0MntszcJCU3jalbJdN8aejElpmbxPJdyh12KNnNiU5smblJLN+l3GGHkt2c6MSWmZvE8l3KHXYo2c2JTspywe4wp8TywsmuoZee+jO7w5wSywsnu4ZeeurP7A5zSiwvnOwaeol/9pTEcsIONabup8RyQ1s89JTEcsIONabup8RyQ1s89JTEcsIONabup8Ryo7Uuf7mPtcF9rA3uY21wH2uD+1iZn58/9whzEbhRquEAAAAASUVORK5CYII=\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"barcode.png\",\n \"duration\": 298,\n \"remainingCredits\": 98725605,\n \"credits\": 7\n}"
}
]
}
],
"description": "Generate high quality barcode images. Supports QR Code, Datamatrix, Code 39, Code 128, PDF417 and many other barcode types.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "41. Barcode Reader",
"item": [
{
"name": "/barcode/read/from/url",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"types\": \"QRCode,Code128,Code39,Interleaved2of5,EAN13\",\n \"pages\": \"0\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/read/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"read",
"from",
"url"
]
},
"description": "Need to split PDF by barcode? Check `PDF Split by Barcode` (`pdf/split2` endpoint).\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **type** optional Set the barcode type, Must be in a \"string\" format. `QRCode` By default. **supported barcode types:** AustralianPostCode, Aztec, BorderedTable, Checkbox, Circle, CircularI2of5, Codabar, CodablockF, Code128, Code16K, Code39, Code39Extended, Code39Mod43, Code39Mod43Extended, Code93, DataMatrix, DPMDataMatrix, EAN13, EAN2, EAN5, EAN8, GS1, GS1DataBarExpanded, GS1DataBarExpandedStacked, GS1DataBarLimited, GS1DataBarOmnidirectional, GS1DataBarStacked, GTIN12, GTIN13, GTIN14, GTIN8, HorizontalLine, IntelligentMail, Interleaved2of5, ITF14, MaxiCode, MICR, MicroPDF, MSI, Oval, PatchCode, PDF417, Pharmacode, PostNet, PZN, QRCode, Rectangle, RoyalMail, RoyalMailKIX, Segment, Trioptic, UnderlinedField, UPCA, UPCE, UPU, VerticalLine. |\n| **pages** optional Comma-Separated list of page indices (or ranges) to process. IMPORTANT: the very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the end of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means the first page, then the 3rd page to the 6th page, and then the range from the 8th (index = `7`) page till the end of the document. Must be in a \"string\" format. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/barcode/read/from/url",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"types\": \"QRCode,Code128,Code39,Interleaved2of5,EAN13\",\n \"pages\": \"0\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/read/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"read",
"from",
"url"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"341eaa1ebd6a4f9acee4cbb38bb80cb8\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "c4abd71a-ab65-412e-8914-5137b4c41261"
},
{
"key": "X-Runtime",
"value": "6.447658"
},
{
"key": "Date",
"value": "Fri, 27 Aug 2021 14:09:24 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"barcodes\": [\n {\n \"Value\": \"abcdef123456\",\n \"RawData\": \"\",\n \"Type\": 14,\n \"Rect\": \"{X=448,Y=23,Width=106,Height=112}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"QRCode\"\n },\n {\n \"Value\": \"test123\",\n \"RawData\": \"\",\n \"Type\": 2,\n \"Rect\": \"{X=111,Y=60,Width=255,Height=37}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"Confidence\": 0.90625155,\n \"Metadata\": \"\",\n \"TypeName\": \"Code128\"\n },\n {\n \"Value\": \"123456\",\n \"RawData\": \"\",\n \"Type\": 4,\n \"Rect\": \"{X=111,Y=129,Width=306,Height=37}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"Confidence\": 0.7710818,\n \"Metadata\": \"\",\n \"TypeName\": \"Code39\"\n },\n {\n \"Value\": \"0112345678901231\",\n \"RawData\": \"\",\n \"Type\": 2,\n \"Rect\": \"{X=111,Y=198,Width=305,Height=37}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"Confidence\": 0.9156459,\n \"Metadata\": \"\",\n \"TypeName\": \"Code128\"\n },\n {\n \"Value\": \"12345670\",\n \"RawData\": [\n 1,\n 2,\n 3,\n 4,\n 5,\n 6,\n 7,\n 0\n ],\n \"Type\": 5,\n \"Rect\": \"{X=111,Y=267,Width=182,Height=0}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"I2of5\"\n },\n {\n \"Value\": \"1234567890128\",\n \"RawData\": \"\",\n \"Type\": 6,\n \"Rect\": \"{X=102,Y=336,Width=71,Height=72}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"Confidence\": 0.895925164,\n \"Metadata\": \"\",\n \"TypeName\": \"EAN13\"\n }\n ],\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"remainingCredits\": 99826192,\n \"credits\": 35\n}"
}
]
},
{
"name": "/barcode/read/from/url (read qr code)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"types\": \"QRCode\",\n \"pages\": \"0\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/read/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"read",
"from",
"url"
]
},
"description": "Need to split PDF by barcode? Check `PDF Split by Barcode` (`pdf/split2` endpoint).\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **types** required Comma-Separated list of barcode types to decode e.g `Code128, Code39`. **Supported Barcode Types:** AustralianPostCode, Aztec, BorderedTable, Checkbox, Circle, CircularI2of5, Codabar, CodablockF, Code128, Code16K, Code39, Code39Extended, Code39Mod43, Code39Mod43Extended, Code93, DataMatrix, DPMDataMatrix, EAN13, EAN2, EAN5, EAN8, GS1, GS1DataBarExpanded, GS1DataBarExpandedStacked, GS1DataBarLimited, GS1DataBarOmnidirectional, GS1DataBarStacked, GTIN12, GTIN13, GTIN14, GTIN8, HorizontalLine, IntelligentMail, Interleaved2of5, ITF14, MaxiCode, MICR, MicroPDF, MSI, Oval, PatchCode, PDF417, Pharmacode, PostNet, PZN, QRCode, Rectangle, RoyalMail, RoyalMailKIX, Segment, Trioptic, UnderlinedField, UPCA, UPCE, UPU, VerticalLine. |\n| **pages** optional Comma-Separated list of page indices (or ranges) to process. IMPORTANT: the very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the end of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means the first page, then the 3rd page to the 6th page, and then the range from the 8th (index = `7`) page till the end of the document. Must be in a \"string\" format. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/barcode/read/from/url (read qr code)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"types\": \"QRCode\",\n \"pages\": \"0\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/read/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"read",
"from",
"url"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"adaf788f244f266ffc6a044185b7b101\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "9cc8055e-6cde-4a4b-91a2-1468f85f22d5"
},
{
"key": "X-Runtime",
"value": "0.803961"
},
{
"key": "Date",
"value": "Wed, 02 Feb 2022 22:17:56 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"barcodes\": [\n {\n \"Value\": \"abcdef123456\",\n \"RawData\": \"\",\n \"Type\": 14,\n \"Rect\": \"{X=448,Y=23,Width=106,Height=112}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/barcode-reader/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"QRCode\"\n }\n ],\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"duration\": 781,\n \"remainingCredits\": 98725563,\n \"credits\": 35\n}"
}
]
}
],
"description": "Read barcodes from images and PDF. Can read all popular barcode types from `QR Code` and `Code 128`, `EAN` to `Datamatrix`, `PDF417`, `GS1` and many other barcodes. ",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "41.1 Optical Marks Reader (Checkboxes, Radiobutton, Fillable Fields, Segments etc)",
"item": [
{
"name": "/barcode/read/from/url (find checkboxes on scan image)",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n\t\"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n\t\"types\": \"Checkbox,UnderlinedField\",\n \"async\": false\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/read/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"read",
"from",
"url"
]
},
"description": "| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |\n| **httpusername** optional HTTP auth user name if required to access source `url`. |\n| **httppassword** optional HTTP auth password if required to access source `url`. |\n| **types** required Comma-separated list of object types to decode. Must be in a \"string\" format. Object types supported: **checkboxes**, **radioboxes**, Vertical and Horizontal **lines** and general **segments**:
1. `Segment` - locates and selects objects on a page (general selection) 2. `UnderlinedField` - detects **fillable fields** (typically, underlined spaces, i.e. fields to fill in a form). 3. `Rectangle` - detects rectangles, including **checkboxes**. Also returns the value as `1` if a **checkmark** or a filled rectangle was detected. 4. `Oval` - detects rounded or oval marks (typically, a **radiobox**). Returns value of `1` if filled out **radiobox** was detected. 5. `HorizontalLine` - detects **horizontal lines**. 6. `VerticalLine` - detects **vertical lines**.
For selecting multiple types just put them together with a separate comma. |\n| **pages** optional Comma-separated list of page indices (or ranges) to process. IMPORTANT: the very first page starts at `0` (zero). To set a range use the dash `-`, for example: `0,2-5,7-`. To set a range from the index to the last page use range like this: `2-` (from page #3 as the index starts at zero and till the end of the document). For ALL pages just leave this param empty. Example: `0,2-5,7-` means the first page, then the 3rd page to the 6th page, and then the range from the 8th (index = `7`) page till the end of the document. |\n| **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`](https://apidocs.pdf.co/97-background-jobs-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. |\n| **profiles** optional Use this parameter to set additional configurations for fine-tuning and extra options. Must be in a \"string\" format. Explore [PDF.co knowledgebase](https://apidocs.pdf.co/kb) for profile examples. |"
},
"response": [
{
"name": "/barcode/read/from/url (find checkboxes on scan image)",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n\t\"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n\t\"types\": \"Checkbox,UnderlinedField\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/barcode/read/from/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"barcode",
"read",
"from",
"url"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"724b133c7bead7e47511b89c962c60d7\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "1efad1e1-4131-43e6-8d95-c4f9b4e9a6d2"
},
{
"key": "X-Runtime",
"value": "0.882073"
},
{
"key": "Date",
"value": "Wed, 02 Feb 2022 22:18:32 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"barcodes\": [\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=34,Y=264,Width=526,Height=9}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=30,Y=299,Width=534,Height=9}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=30,Y=327,Width=132,Height=9}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=298,Y=327,Width=132,Height=9}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=30,Y=352,Width=132,Height=6}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=298,Y=352,Width=132,Height=6}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=30,Y=373,Width=132,Height=5}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=298,Y=373,Width=132,Height=5}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=30,Y=394,Width=132,Height=6}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=298,Y=394,Width=132,Height=6}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=30,Y=416,Width=132,Height=6}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=298,Y=416,Width=132,Height=6}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=30,Y=433,Width=132,Height=9}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n },\n {\n \"Value\": \"box\",\n \"RawData\": \"\",\n \"Type\": 53,\n \"Rect\": \"{X=298,Y=437,Width=132,Height=6}\",\n \"Page\": 0,\n \"File\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-to-html/sample.pdf\",\n \"Confidence\": 1,\n \"Metadata\": \"\",\n \"TypeName\": \"UnderlinedField\"\n }\n ],\n \"pageCount\": 1,\n \"error\": false,\n \"status\": 200,\n \"duration\": 860,\n \"remainingCredits\": 98725528,\n \"credits\": 35\n}"
}
]
}
],
"description": "Our barcode reader engine can also find the following marks and objects on scanned documents: \n\n1. **checkboxes**\n2. **radioboxes**\n3. vertical and horizontal **lines** \n4. general **segments** (basically, all content types on the page).",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "97. Background Jobs Check",
"item": [
{
"name": "/job/check",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"jobid\": \"12345\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/job/check",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"job",
"check"
]
},
"description": "| **Attributes** |\n| --- |\n| **jobId** required ID of background that was started asynchronously. To start a new async background job, you should set `async` to `true` for API methods. |\n| **force** optional Set to `true` to forcibly check the status of the background job. Intended to be used with really long and heavy background jobs only. |\n\nReturns JSON with the status of the background job.\n\nAvailable status values:\n\n- `working` background job is currently in work or does not exist. \n- `success` background job was successfully finished.\n- `failed` background job failed for some reason (see `message` for more details).\n- `aborted` background job was aborted.\n- `unknown` unknown background job id. Available only when `force` is set to `true` for input request."
},
"response": [
{
"name": "/job/check",
"originalRequest": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"jobid\": \"12345\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/job/check",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"job",
"check"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"fad5190f8c086977a81ac946520108ae\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "af95317e-0dd8-4587-8959-4b33e66c652c"
},
{
"key": "X-Runtime",
"value": "0.530154"
},
{
"key": "Date",
"value": "Fri, 28 Aug 2020 20:46:07 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"status\": \"working\",\n \"remainingCredits\": 60227\n}"
}
]
}
],
"description": "Checks status of background job that was previously created with PDF.co API.",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "98. Upload Files",
"item": [
{
"name": "/file/upload/get-presigned-url (GET generate secure URL for upload)",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload/get-presigned-url?name=test.pdf&encrypt=true&contentType=application/pdf",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"get-presigned-url"
],
"query": [
{
"key": "name",
"value": "test.pdf",
"description": "The name the file will be stored with. Must be a String."
},
{
"key": "encrypt",
"value": "true",
"description": "Enable encryption for the output file. Must be one of: `true`, `false`."
},
{
"key": "contentType",
"value": "application/pdf",
"description": "Optional. overrides `Content-Type` header. Set to `appication/pdf` for PDF files or `application/octet-stream` for other documents."
}
]
},
"description": "**Description:** This method generates links to upload your local file to. Use this `presignedUrl` from the response to upload your file. Once you upload your file to this `presignedUrl` using `PUT`, you can use the `url` link to access the uploaded file.\n\nWith this method you can upload files up to 2GB in size. Please note that to process these files you should use `async=true` mode with data extraction and tools endpoints along with `/job/check` to check status of background jobs you create.\n\n| **Attributes** |\n| --- |\n| **name** optional File name for the generated output. Must be in a \"string\" format. |\n\n**Steps to Upload File:**\n\n- First, call `/file/upload/get-presigned-url`. It will generate **link for uploading** (`presignedUrl`) and **final link** (`url`)\n- Now send your file to the `presignedUrl` link using the `PUT` method within the next 30 minutes. \n- Once finished, use `url` to access the file you have just uploaded.\n\n**Notes**\n\n- use `contentType` parameter to set `Content-Type` header for uploaded file. It can be `application/pdf` for PDF files or `application/octet-stream` for non-PDF documents or images.\n- `url` output param indicates temporary url to uploaded file. But for uploading a file you need to use `presignedUrl` with `PUT` upload via http method.\n- If you want to re-use temp url to the uploaded pdf for a preview or similar purposes then make sure to set `contentType` parameter to `application/pdf` so it will indicate proper file content type when accessed by a preview or a browser.\n\n\n**Important**: uploaded files are treated as *temporary* files and auto removed permanently after `1` hour by default. You can remove it earlier using `file/delete` function.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error.|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n**Workflow**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n\nGenerate secure link where you will upload your file:\n\n```\ncurl --location --request GET https://api.pdf.co/v1/file/upload/get-presigned-url?name=test.pdf&encrypt=true\n--header 'x-api-key: YOUR_API_KEY'\n\n200\n{\n \"presignedUrl\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=900&....\",\n \"url\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=....\",\n}\n\n// Now use PUT to upload file to \"presignedUrl\" link:\n\ncurl --location --request PUT '' \\\n--header 'x-api-key: YOUR_API_KEY' \\\n--header 'Content-Type: application/octet-stream' \\\n--data-binary '@./sample.pdf'\n\n200\n{ \n // 200 means all was uploaded OK\n}\n```\n\nNow your file is available via the link from `url` param from the first step"
},
"response": [
{
"name": "/file/upload/get-presigned-url (GET generate secure URL for upload)",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"url": {
"raw": "https://api.pdf.co/v1/file/upload/get-presigned-url?name=test.pdf&contentType=application/pdf",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"get-presigned-url"
],
"query": [
{
"key": "name",
"value": "test.pdf",
"description": "The name the file will be stored with. Must be a String."
},
{
"key": "contentType",
"value": "application/pdf",
"description": "Optional. Sets`Content-Type` header. Set to `appication/pdf` for PDF files or `application/octet-stream` for other documents. "
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"38063aadb89deee34a897d4816bcde73\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "bb4bcfbb-a1cc-499d-b16d-c3d65e5b1cb0"
},
{
"key": "X-Runtime",
"value": "0.281778"
},
{
"key": "Date",
"value": "Tue, 13 Sep 2022 07:41:59 GMT"
},
{
"key": "X-Rack-Cache",
"value": "miss"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"presignedUrl\": \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/A1VGV42YE0NWXMKEB4BUIWNYGKXEWTND/test.pdf?X-Amz-Expires=900&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIZJDPLX6D7EHVCKA/20220913/us-west-2/s3/aws4_request&X-Amz-Date=20220913T074159Z&X-Amz-SignedHeaders=content-type;host&X-Amz-Signature=53f326afde5bcfb3b2714ee8cb5322795bf10a03feb7dab3764e6ca63c017f43\",\n \"url\": \"https://pdf-temp-files.s3.us-west-2.amazonaws.com/A1VGV42YE0NWXMKEB4BUIWNYGKXEWTND/test.pdf?X-Amz-Expires=3600&X-Amz-Security-Token=FwoGZXIvYXdzEBgaDLZTUxFLOwF9iiGk%2FyKCATiLp%2FRn9nPmt%2Fey9PcilcRMXtLl0TS6IFNOpk%2BKtSF%2B%2BEVcbNFThw4c1KVx21RQxT5zf7csSEESGov1Xd4uDhF0xGoVkXff9saXGVUtgKrYgPKhUfv5KEO7gz3E0t%2FqCPZJn2KGs1yMbUkohzeIrEd0NH8EVvqfxrfCcW0ZANiG2iMoh8eAmQYyKLjRMfg02ZJPTgoFPQmfMyYt0FacTg4RhkP3PeD9mrWLefDXCwcYkkI%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHFHQYL4OV/20220913/us-west-2/s3/aws4_request&X-Amz-Date=20220913T074159Z&X-Amz-SignedHeaders=host&X-Amz-Signature=9b1a90f36635459bb40f09b0fc6fe3eba185ba3cfdb0a8ef1096ac9efa9b6299\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"test.pdf\",\n \"credits\": 7,\n \"duration\": 0,\n \"remainingCredits\": 98191146\n}"
},
{
"name": "PUT `presignedUrl` --data-binary file=..",
"originalRequest": {
"method": "PUT",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/pdf",
"description": "Optional. Set type of the content. Use `application/pdf` for uploading pdf. Use `application/octet-stream` for others. IMPORTANT: must use the same as was used in `file/upload/get-presigned-url`"
}
],
"body": {
"mode": "file",
"file": {
"src": "./sample.pdf"
}
},
"url": {
"raw": "",
"host": [
""
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "plain",
"header": [
{
"key": "x-amz-id-2",
"value": "cFtZMyWtgbJX+U59TheHPCLqskwbC52SNk52VWt1sw2uDeqBSgbap9hb4jxBUyCxPJyUYDnWctg="
},
{
"key": "x-amz-request-id",
"value": "4YDJ1NDK3X8W9SCY"
},
{
"key": "Date",
"value": "Thu, 16 Jul 2020 09:15:02 GMT"
},
{
"key": "x-amz-expiration",
"value": "expiry-date=\"Sat, 18 Jul 2020 00:00:00 GMT\", rule-id=\"Remove after 1 day\""
},
{
"key": "x-amz-server-side-encryption",
"value": "AES256"
},
{
"key": "ETag",
"value": "\"7e4870600b09d7d9ae2fbdfbbc027730\""
},
{
"key": "Content-Length",
"value": "0"
},
{
"key": "Server",
"value": "AmazonS3"
}
],
"cookie": [],
"body": ""
}
]
},
{
"name": "PUT `presignedUrl` --data-binary 'sample.pdf'",
"protocolProfileBehavior": {
"disabledSystemHeaders": {}
},
"request": {
"method": "PUT",
"header": [
{
"key": "Content-Type",
"value": "application/pdf",
"description": "Optional. Indicates PDF file. IMPORTANT: must use the same `Content-Type` header value as was used for `file/upload/get-presigned-url`\n",
"type": "text",
"disabled": true
},
{
"key": "Content-Disposition",
"value": "inline",
"description": "Optional. Sets Content-Disposition header",
"type": "text"
}
],
"body": {
"mode": "file",
"file": {
"src": "./sample.pdf"
}
},
"url": {
"raw": "",
"protocol": ""
]
},
"description": "With this method you can upload files up to 100mb in size. Please note that to process these files you should use `async=true` mode with data extraction and tools endpoints along with `/job/check` to check status of background jobs you create.\n\n**Steps to Upload File:**\n\n\n1. First, call `/file/upload/get-presigned-url`. It will generate **link for uploading** (`presignedUrl`) and **final link** (`url`)\n2. Now send your file to the `presignedUrl` link using the `PUT` method within the next 30 minutes. \n3. Once finished, use `url` from the step `1` to access the file you have just uploaded.\n\n\n**IMPORTANT**\n\n**When sending `PUT` request don't forget to add `Content-Type` header with proper value based on input file type**. \n\nFew examples of content-types applicable:\n\n| File Extension| `Content-Type` Value |\n| ----------- | ----------- |\n| `.txt`,`.csv`, `.xml`, `.json`| `text/plain`|\n| `.txt`,`.csv`, `.xml`| `text/plain`|\n| `.pdf` | `application/pdf` |\n| `.msg` and `.eml` | `application/vnd.ms-outlook` |\n|`.doc`| `application/msword`\t\n\n\nNot sure? Just use `Content-Type` : `application/octet-stream` header. It works for the most of file types.\n\n**Incorrect**\n\n```\nfunction uploadFile(file){\n...\n\n const formData = new FormData();\n formData.append(\"file\", file);\n\n await axios({\n method: 'PUT',\n url,\n data: formData,\n headers: {'Content-Type': 'multipart/form-data'}\n })\n...\n}\n```\n\n**Correct**\n\n```\nfunction uploadFile(file){\n...\n // upload file data directly\n // https://github.com/axios/axios#axiospatchurl-data-config\n await axios({\n method: 'PUT',\n url: url,\n data: file,\n headers: {'Content-Type': 'application/octet-stream'}\n })\n...\n}\n```\n\n\n**IMPORTANT 2**: all uploaded files are treated as temporary files and are automatically permanently removed after 1 hour. If you have a file that you want to reuse over and over, please upload it to [PDF.co File Storage](https://app.pdf.co/files) and get its `filetoken://` link that you may reuse inside PDF.co API.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error.|\n\n**Workflow**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n\nGenerate secure link where you will upload your file:\n\n```\ncurl --location --request GET https://api.pdf.co/v1/file/upload/get-presigned-url?name=test.pdf&encrypt=true\n--header 'x-api-key: YOUR_API_KEY'\n\n200\n{\n \"presignedUrl\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=900&....\",\n \"url\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=....\",\n}\n\n// Now use PUT to upload file to \"presignedUrl\" link:\n\ncurl --location --request PUT '' \\\n--header 'x-api-key: YOUR_API_KEY' \\\n--header 'Content-Type: application/octet-stream' \\\n--data-binary '@./sample.pdf'\n\n200\n{ \n // 200 means all was uploaded OK\n}\n```\n\nNow your file is available via the link from `url` param from the first step"
},
"response": [
{
"name": "/file/upload/get-presigned-url",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"url": {
"raw": "https://api.pdf.co/v1/file/upload/get-presigned-url?name=test.pdf&ContentType=application/pdf",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"get-presigned-url"
],
"query": [
{
"key": "name",
"value": "test.pdf",
"description": "The name the file will be stored with. Must be a String."
},
{
"key": "ContentType",
"value": "application/pdf",
"description": "Optional. Sets`Content-Type` header. Set to `appication/pdf` for PDF files or `application/octet-stream` for other documents. "
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"60d08185b7bc0c34bd12be786f196043\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "ba3230c3-93db-4bdf-a012-7b4b02def6a1"
},
{
"key": "X-Runtime",
"value": "0.484154"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:39:53 GMT"
},
{
"key": "X-Rack-Cache",
"value": "miss"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"presignedUrl\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/0c72bf56341142ba83c8f98b47f14d62/test.pdf?X-Amz-Expires=900&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIZJDPLX6D7EHVCKA/20200302/us-west-2/s3/aws4_request&X-Amz-Date=20200302T143951Z&X-Amz-SignedHeaders=host&X-Amz-Signature=8650913644b6425ba8d52b78634698e5fc8970157d971a96f0279a64f4ba87fc\",\n \"url\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/0c72bf56341142ba83c8f98b47f14d62/test.pdf?X-Amz-Expires=3600&x-amz-security-token=FwoGZXIvYXdzEGgaDA9KaTOXRjkCdCqSTCKBAW9tReCLk1fVTZBH9exl9VIbP8Gfp1pE9hg6et94IBpNamOaBJ6%2B9Vsa5zxfiddlgA%2BxQ4tpd9gprFAxMzjN7UtjU%2B2gf%2FKbUKc2lfV18D2wXKd1FEhC6kkGJVL5UaoFONG%2Fw2jXfLxe3nCfquMEDo12XzcqIQtNFWXjKPWBkQEvmii4tfTyBTIot4Na%2BAUqkLshH0R7HVKlEBV8btqa0ctBjwzwpWkoU%2BF%2BCtnm8Lm4Eg%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHEGHTOA4W/20200302/us-west-2/s3/aws4_request&X-Amz-Date=20200302T143951Z&X-Amz-SignedHeaders=host;x-amz-security-token&X-Amz-Signature=243419ac4a9a315eebc2db72df0817de6a261a684482bbc897f0e7bb5d202bb9\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"test.pdf\",\n \"remainingCredits\": 98145\n}"
},
{
"name": "PUT `presignedUrl` --data-binary file=..",
"originalRequest": {
"method": "PUT",
"header": [
{
"key": "Content-Type",
"type": "text",
"value": "application/pdf",
"description": "type of the content"
}
],
"body": {
"mode": "file",
"file": {
"src": "./sample.pdf"
}
},
"url": {
"raw": "",
"host": [
""
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "plain",
"header": [
{
"key": "x-amz-id-2",
"value": "cFtZMyWtgbJX+U59TheHPCLqskwbC52SNk52VWt1sw2uDeqBSgbap9hb4jxBUyCxPJyUYDnWctg="
},
{
"key": "x-amz-request-id",
"value": "4YDJ1NDK3X8W9SCY"
},
{
"key": "Date",
"value": "Thu, 16 Jul 2020 09:15:02 GMT"
},
{
"key": "x-amz-expiration",
"value": "expiry-date=\"Sat, 18 Jul 2020 00:00:00 GMT\", rule-id=\"Remove after 1 day\""
},
{
"key": "x-amz-server-side-encryption",
"value": "AES256"
},
{
"key": "ETag",
"value": "\"7e4870600b09d7d9ae2fbdfbbc027730\""
},
{
"key": "Content-Length",
"value": "0"
},
{
"key": "Server",
"value": "AmazonS3"
}
],
"cookie": [],
"body": ""
}
]
},
{
"name": "/file/upload (Uploading small file)",
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. Your API key for PDF.co. Get your API key at https://app.pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "name",
"value": "",
"description": "optional. The name the file will be stored with. Must be a String.",
"type": "text",
"disabled": true
},
{
"key": "file",
"description": "required. Local file should be selected",
"type": "file",
"src": []
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload"
]
},
"description": "**Description:** Uploads a small (up to 100KB) local file as a temporary file in PDF.co storage. Note: temporary files are automatically permanently removed after 1 hour.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. Use `/v1/file/upload/` for small files (<500kb). For faster and stable file uploads, use [get-presigned-url](https://apidocs.pdf.co/98-upload-files#get-fileuploadget-presigned-url-get-generate-secure-url-for-upload) and [PUT](https://apidocs.pdf.co/98-upload-files#put-put-presignedurl---data-binary-samplepdf) workflow. (see [source code samples](/samples)|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)"
},
"response": [
{
"name": "POST Upload small file: /file/upload",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "name",
"value": "",
"description": "optional. The name the file will be stored with. Must be a String.",
"type": "text",
"disabled": true
},
{
"key": "file",
"description": "required. Local file should be selected",
"type": "file",
"src": "/Users/em/Downloads/logo.png"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"a1e14b5e3c9547d621091e2acbbbf56b\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "1733e572-5dc4-47ae-a3e5-da22c509400e"
},
{
"key": "X-Runtime",
"value": "1.154704"
},
{
"key": "Date",
"value": "Thu, 16 Jul 2020 09:19:30 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/28b6041bcfe34c469ed44f15f0594d5f/logo.dat\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"logo\",\n \"remainingCredits\": 77772\n}"
},
{
"name": "/file/upload/url",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "name",
"value": "",
"description": "optional. The name the file will be stored with. Must be a String.",
"type": "text"
},
{
"key": "url",
"value": "pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf",
"description": "required. URL of the file to upload. Must be a String.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"url"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"6307d6384b29edb883e4e9b5e9c70d81\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "365faba1-1ca9-48d7-b596-dfe66250df17"
},
{
"key": "X-Runtime",
"value": "0.634358"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:40:33 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/1a4a92ac805c41c28ef75a24e0f35ba5/sample.pdf\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.pdf\",\n \"remainingCredits\": 98145\n}"
}
]
},
{
"name": "/file/upload/base64 (Upload small file as Base64)",
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "name",
"value": "custom name",
"description": "optional. The name the file will be stored with. Must be a String.",
"type": "text",
"disabled": true
},
{
"key": "file",
"value": "data:image/gif;base64,R0lGODlhEAAQAPUtACIiIScnJigoJywsLDIyMjMzMzU1NTc3Nzg4ODk5OTs7Ozw8PEJCQlBQUFRUVFVVVVhYWG1tbXt7fInDRYvESYzFSo/HT5LJVJPJVJTKV5XKWJbKWZbLWpfLW5jLXJrMYaLRbaTScKXScKXScafTdIGBgYODg6alprLYhbvekr3elr3el9Dotf///wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAAIf8LSW1hZ2VNYWdpY2sNZ2FtbWE9MC40NTQ1NQAsAAAAABAAEAAABpJAFGgkKhpFIRHpw2qBLJiLdCrNTFKt0wjD2Xi/G09l1ZIwRJeNZs3uUFQtEwCCVrM1bnhJYHDU73ktJQELBH5pbW+CAQoIhn94ioMKB46HaoGTB5WPaZmMm5wOIRcekqChliIZFXqoqYYkE2SaoZuWH1gmAgsIvr8ICQUPTRIABgTJyskFAw1ZDBAO09TUDw0RQQA7",
"description": "required. Base64-encoded file bytes. Must be a String.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload/base64",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"base64"
]
},
"description": "**Description:** Creates a temporary file using base64 source data. You may use this temporary file URL with other API methods. Temporary files are automatically permanently removed after 1 hour. `GET` or `POST` request.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. Use `/v1/file/upload/base64` for small files. For faster and stable file uploads, use [get-presigned-url](https://apidocs.pdf.co/98-upload-files#get-fileuploadget-presigned-url-get-generate-secure-url-for-upload) and [PUT](https://apidocs.pdf.co/98-upload-files#put-put-presignedurl---data-binary-samplepdf) workflow.|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n\n**POST**\n\n```\n{\n\t\"file\" : \"data:image/gif;base64,R0lGODlhEAAQAPUtACIiIScnJigoJywsLDIyMjMzMzU1NTc3Nzg4ODk5OTs7Ozw8PEJCQlBQUFRUVFVVVVhYWG1tbXt7fInDRYvESYzFSo/HT5LJVJPJVJTKV5XKWJbKWZbLWpfLW5jLXJrMYaLRbaTScKXScKXScafTdIGBgYODg6alprLYhbvekr3elr3el9Dotf///wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAAIf8LSW1hZ2VNYWdpY2sNZ2FtbWE9MC40NTQ1NQAsAAAAABAAEAAABpJAFGgkKhpFIRHpw2qBLJiLdCrNTFKt0wjD2Xi/G09l1ZIwRJeNZs3uUFQtEwCCVrM1bnhJYHDU73ktJQELBH5pbW+CAQoIhn94ioMKB46HaoGTB5WPaZmMm5wOIRcekqChliIZFXqoqYYkE2SaoZuWH1gmAgsIvr8ICQUPTRIABgTJyskFAw1ZDBAO09TUDw0RQQA7\"\n}\n```"
},
"response": [
{
"name": "https://api.pdf.co/v1/file/upload/base64",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "name",
"value": "custom name",
"description": "optional. The name the file will be stored with. Must be a String.",
"type": "text",
"disabled": true
},
{
"key": "file",
"value": "data:image/gif;base64,R0lGODlhEAAQAPUtACIiIScnJigoJywsLDIyMjMzMzU1NTc3Nzg4ODk5OTs7Ozw8PEJCQlBQUFRUVFVVVVhYWG1tbXt7fInDRYvESYzFSo/HT5LJVJPJVJTKV5XKWJbKWZbLWpfLW5jLXJrMYaLRbaTScKXScKXScafTdIGBgYODg6alprLYhbvekr3elr3el9Dotf///wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAAIf8LSW1hZ2VNYWdpY2sNZ2FtbWE9MC40NTQ1NQAsAAAAABAAEAAABpJAFGgkKhpFIRHpw2qBLJiLdCrNTFKt0wjD2Xi/G09l1ZIwRJeNZs3uUFQtEwCCVrM1bnhJYHDU73ktJQELBH5pbW+CAQoIhn94ioMKB46HaoGTB5WPaZmMm5wOIRcekqChliIZFXqoqYYkE2SaoZuWH1gmAgsIvr8ICQUPTRIABgTJyskFAw1ZDBAO09TUDw0RQQA7",
"description": "required. Base64-encoded file bytes. Must be a String.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload/base64",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"base64"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"61142ec21955956461bd692fd5d8b9d7\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "2aa3ce2a-b310-4ea2-8139-ff84db784a1a"
},
{
"key": "X-Runtime",
"value": "0.712050"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:39:10 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/a8ac8a3cec3344f08f556bfd2d678b2f/uploadfile.txt\",\n \"error\": false,\n \"status\": 200,\n \"remainingCredits\": 98145\n}"
},
{
"name": "POST Upload small file as Base64: /file/upload/base64",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "name",
"value": "custom name",
"description": "optional. The name the file will be stored with. Must be a String.",
"type": "text",
"disabled": true
},
{
"key": "file",
"value": "data:image/gif;base64,R0lGODlhEAAQAPUtACIiIScnJigoJywsLDIyMjMzMzU1NTc3Nzg4ODk5OTs7Ozw8PEJCQlBQUFRUVFVVVVhYWG1tbXt7fInDRYvESYzFSo/HT5LJVJPJVJTKV5XKWJbKWZbLWpfLW5jLXJrMYaLRbaTScKXScKXScafTdIGBgYODg6alprLYhbvekr3elr3el9Dotf///wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAAIf8LSW1hZ2VNYWdpY2sNZ2FtbWE9MC40NTQ1NQAsAAAAABAAEAAABpJAFGgkKhpFIRHpw2qBLJiLdCrNTFKt0wjD2Xi/G09l1ZIwRJeNZs3uUFQtEwCCVrM1bnhJYHDU73ktJQELBH5pbW+CAQoIhn94ioMKB46HaoGTB5WPaZmMm5wOIRcekqChliIZFXqoqYYkE2SaoZuWH1gmAgsIvr8ICQUPTRIABgTJyskFAw1ZDBAO09TUDw0RQQA7",
"description": "required. Base64-encoded file bytes. Must be a String.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload/base64",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"base64"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"a1efecd6282528feb445d1c4fce5ecf6\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "3190e072-2218-4705-9b37-d6b8f1f997a7"
},
{
"key": "X-Runtime",
"value": "0.477935"
},
{
"key": "Date",
"value": "Thu, 16 Jul 2020 09:20:00 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/7588d614c9ad41eb98ec317a02abda63/uploadfile.txt\",\n \"error\": false,\n \"status\": 200,\n \"remainingCredits\": 77769\n}"
}
]
},
{
"name": "/file/upload/url (Upload file from URL)",
"request": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "name",
"value": "sample.pdf",
"description": "optional. The name the file will be stored with. Must be a String.",
"type": "text"
},
{
"key": "url",
"value": "pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf",
"description": "required. URL of the file to upload. Must be a String.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"url"
]
},
"description": "**Description:** Downloads file from a source url and uploads it as a temporary file. Temporary files are automatically permanently removed after 1 hour.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. Use `/v1/file/upload/url` for small files (<500kb). For faster and stable file uploads, use [get-presigned-url](https://apidocs.pdf.co/98-upload-files#get-fileuploadget-presigned-url-get-generate-secure-url-for-upload) and [PUT](https://apidocs.pdf.co/98-upload-files#put-put-presignedurl---data-binary-samplepdf) workflow.|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n\n**POST**\n\n```\n{\n\"url\" : \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf\"\n}\n```"
},
"response": [
{
"name": "POST Upload from URL: /file/upload/url",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "name",
"value": "sample.pdf",
"description": "optional. The name the file will be stored with. Must be a String.",
"type": "text"
},
{
"key": "url",
"value": "pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf",
"description": "required. URL of the file to upload. Must be a String.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"url"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"090e0339daea804c21da8598079f5b17\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "50badaae-331a-417a-99c4-e9642401051b"
},
{
"key": "X-Runtime",
"value": "0.636366"
},
{
"key": "Date",
"value": "Thu, 16 Jul 2020 09:20:24 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/4e36f2962b7f4248b7167f4389d534d5/sample.pdf\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.pdf\",\n \"remainingCredits\": 77767\n}"
},
{
"name": "/file/upload/url",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "name",
"value": "",
"description": "optional. The name the file will be stored with. Must be a String.",
"type": "text"
},
{
"key": "url",
"value": "pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf",
"description": "required. URL of the file to upload. Must be a String.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"url"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"6307d6384b29edb883e4e9b5e9c70d81\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "365faba1-1ca9-48d7-b596-dfe66250df17"
},
{
"key": "X-Runtime",
"value": "0.634358"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:40:33 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/1a4a92ac805c41c28ef75a24e0f35ba5/sample.pdf\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.pdf\",\n \"remainingCredits\": 98145\n}"
}
]
},
{
"name": "/file/upload/url (Upload from URL)",
"protocolProfileBehavior": {
"disableBodyPruning": true
},
"request": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/upload/url?url=pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"url"
],
"query": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "url",
"value": "pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf"
}
]
},
"description": "**Description:** Downloads file from a source url and uploads it as a temporary file. Temporary files are automatically permanently removed after 1 hour.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. Use `/v1/file/upload/url` for small files (<500kb). For faster and stable file uploads, use [get-presigned-url](https://apidocs.pdf.co/98-upload-files#get-fileuploadget-presigned-url-get-generate-secure-url-for-upload) and [PUT](https://apidocs.pdf.co/98-upload-files#put-put-presignedurl---data-binary-samplepdf) workflow.|\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n\n**POST**\n\n```\n{\n\"url\" : \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf\"\n}\n```"
},
"response": [
{
"name": "/file/upload/url",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"url": {
"raw": "https://api.pdf.co/v1/file/upload/url",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"url"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"3117847346d4270d5bd3a0b755ea1987\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "a5ef271b-0081-411e-b872-2e844f8b24d3"
},
{
"key": "X-Runtime",
"value": "0.677637"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:40:44 GMT"
},
{
"key": "X-Rack-Cache",
"value": "miss"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/703aa298cfe745baa3449fbdaba4d1d7/sample.pdf\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.pdf\",\n \"remainingCredits\": 98145\n}"
},
{
"name": "GET Upload from URL: /file/upload/url",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"url": {
"raw": "https://api.pdf.co/v1/file/upload/url?url=pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"upload",
"url"
],
"query": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "url",
"value": "pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf"
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"91805f4224abdf3ad632cb36a4b1e9c8\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "f2827a8f-e377-495f-90f8-8a3d3b07cb6e"
},
{
"key": "X-Runtime",
"value": "0.639421"
},
{
"key": "Date",
"value": "Thu, 16 Jul 2020 09:20:55 GMT"
},
{
"key": "X-Rack-Cache",
"value": "miss"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/97415d1c45a04b29ac42c8dc01883316/sample.pdf\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"sample.pdf\",\n \"remainingCredits\": 77765\n}"
}
]
},
{
"name": "/file/delete",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"https://pdf-temp-files.s3.amazonaws.com/b5c1e67d98ab438292ff1fea0c7cdc9d/sample.pdf\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/file/delete",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"delete"
]
},
"description": "**Description:** Deletes temp file (that was uploaded by you or generated by API)\n\n**IMPORTANT**: All temp files are auto removed after 1 hour. You may use `/file/delete` methods to explicitly force remove temp files once you don't need them.\n\n| **Attributes** |\n| --- |\n| **url** required URL of the previously uploaded temporary file or output file that was generated by the API method. |"
},
"response": [
{
"name": "/file/delete",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "url",
"value": "https://pdf-temp-files.s3.amazonaws.com/b5c1e67d98ab438292ff1fea0c7cdc9d/sample.pdf",
"description": "required. URL of the file to calculate hash. Must be a String.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/delete",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"delete"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"9a7cfd25e113f4f14de906dbfca82351\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "13599b7a-6ed2-405d-9644-59a5177a6946"
},
{
"key": "X-Runtime",
"value": "0.575238"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:43:28 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\r\n \"error\": false,\r\n \"status\": 200,\r\n \"remainingCredits\": 9999986\r\n}"
},
{
"name": "POST /file/delete",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"body": {
"mode": "formdata",
"formdata": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
},
{
"key": "url",
"value": "https://pdf-temp-files.s3-us-west-2.amazonaws.com/63f7f641a3144f84ac209b4f514bc0df/myFile.png?X-Amz-Expires=3600&x-amz-security-token=FwoGZXIvYXdzECMaDC5PzTA618EQiHoskyKBAeYQcVKbK%2B0F5nnjBV6MKbPNvueaFlSBSPxPi31BdtFzw1jAIXjAvATkBwTPRx%2FVwhszDtYQRVkbhsZF6HLotVUedrcdGHOrsWV5DpN2xKgnX7xRcJrvUu0wieaJHDmHzFL1eNzFwj2927L%2BtadEfmz1a0SiEImJZujcLF78lJZ5mSj7s8D4BTIok4Xja8wyqnBBp2EOcZw8qrUxeR7Ufd0aw4bf7Z1Cur1f0PFg8hlrYQ%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA4NRRSZPHAPA4HUJS/20200716/us-west-2/s3/aws4_request&X-Amz-Date=20200716T091225Z&X-Amz-SignedHeaders=host;x-amz-security-token&X-Amz-Signature=26e27b48c5284665914fdd981d7b0b5b6e70e64839f28621f3dc82256e492879",
"description": "required. URL of the file to delete. Must be a String.",
"type": "text"
}
]
},
"url": {
"raw": "https://api.pdf.co/v1/file/delete",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"delete"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"bad9be5d7eed2949c307417d53d17e03\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "9e3da488-b142-4495-a855-c92100ef7058"
},
{
"key": "X-Runtime",
"value": "0.503666"
},
{
"key": "Date",
"value": "Thu, 16 Jul 2020 09:16:31 GMT"
},
{
"key": "X-Rack-Cache",
"value": "invalidate, pass"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"error\": false,\n \"status\": 200,\n \"remainingCredits\": 77778\n}"
}
]
},
{
"name": "/file/hash",
"request": {
"method": "POST",
"header": [
{
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/file/hash",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"hash"
]
},
"description": "**Description:** Calculate and return MD5 hash of file by url. Commonly used to control if the source document has been changed or not because every little change will cause hash string to differ as well. `GET` or `POST` request.\n\n| **Attributes** |\n| --- |\n| **url** required URL to the source file. Supports links from [Google Drive](https://drive.google.com), [Dropbox](https://dropbox.com), and [PDF.co built-in files storage](https://app.pdf.co/files). To upload files via API, Check out the [Files Upload](https://apidocs.pdf.co/98-upload-files) section.
**Note**: If you experience intermittent [`Too Many Requests`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) or [`Access Denied`](https://apidocs.pdf.co/kb/Errors/access-denied-or-too-many-requests) 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](https://apidocs.pdf.co/32-1-user-controlled-data-encryption-and-decryption). |"
},
"response": [
{
"name": "/file/hash",
"originalRequest": {
"method": "POST",
"header": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"type": "text",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
},
{
"key": "Content-Type",
"name": "Content-Type",
"value": "application/json",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"url\": \"pdfco-test-files.s3.us-west-2.amazonaws.compdf-split/sample.pdf\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "https://api.pdf.co/v1/file/hash",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"file",
"hash"
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"adc336704bd3b0837f776267711c2944\""
},
{
"key": "Cache-Control",
"value": "max-age=0, private, must-revalidate"
},
{
"key": "X-Request-Id",
"value": "17ea81f7-3c4f-4a6b-bed4-79e00dc9737a"
},
{
"key": "X-Runtime",
"value": "0.371686"
},
{
"key": "Date",
"value": "Mon, 02 Mar 2020 14:41:39 GMT"
},
{
"key": "X-Rack-Cache",
"value": "miss"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"hash\": \"d942e5becdcb0386598cce15e9e56deb1ca9d893b8578a88eca4a62f02c4000b\",\n \"remainingCredits\": 98143\n}"
}
]
}
],
"description": "**Files Storage**\n\nYou can upload files as temporary files into PDF.co. Temporary files are stored for 1 hour by default and then auto removed.\n\nTo store files permanently (pdf templates, images you want to reuse) please use PDF.co built-in files storage at [https://app.pdf.co/files](https://app.pdf.co/files) instead.\n\nYou can also use 3rd party cloud services:\n\n- Dropbox: you can use `public link` to a file from Dropbox\n- Google Drive: you can use link to a file that was shared as `anyone with a link`\n- Google Docs/Sheets/Slides: you can use a link to a document in Google Docs that was shared as `anyone with a link`\n- Any other cloud service that can store a file and provide a link to uploaded file.\n\n**IMPORTANT NOTE FOR GOOGLE DRIVE/DOCS users**: free Google Drive/Docs limits the number of requests to their files. If you use a link to file or document from Google Drive or Google Drive then make sure you have no more than 5-10 requests per minute. Otherwise Google Drive returns no file or error page.\n\n**Temporary Files Upload**\n\nYou can upload **temporary** files up to 2GB in size. Please note that to process these files you should use `async=true` mode with data extraction and tools endpoints along with `/job/check` to check status of background jobs you create.\n\n**Steps to Upload File:**\n\n1) First, call `/file/upload/get-presigned-url`. It will generate **link for uploading** (`presignedUrl`) and **final link** (`url`)\n2) Now send your file to the `presignedUrl` link using the `PUT` method within the next 30 minutes. \n3) Once finished, use `url` to access the file you have just uploaded.\n\nNote: all uploaded files are considered to be temporary files and are automatically permanently removed after 1 hour.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error.|\n\n**Example: Uploading a Temporary File**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n```\nGET\nhttps://api.pdf.co/v1/file/upload/get-presigned-url?name=test.pdf&encrypt=true\n\n200\n{\n \"presignedUrl\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=900&....\",\n \"url\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=....\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"test.pdf\",\n \"remainingCredits\": 93574\n}\n\nPUT\nhttps://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=900&....\n--form 'file=@/path/to/file'\n\n200\n{\n}\n\nNow you can access your file using link from \"url\" param to from the first step.\n```",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
},
{
"name": "99. Misc Account Info And Misc",
"item": [
{
"name": "/account/credit/balance",
"request": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"url": {
"raw": "https://api.pdf.co/v1/account/credit/balance",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"account",
"credit",
"balance"
],
"query": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
}
]
},
"description": "**Description:** Get remaining account balance.\n\n**Status Errors**\n\n| Code | Description |\n| --- | --- |\n| `200` | The request has succeeded |\n| `400` | bad input parameters |\n| `401` | unauthorized |\n| `403` | not enough credits |\n| `405` | Timeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info` |\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)"
},
"response": [
{
"name": "/account/credit/balance",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/"
}
],
"url": {
"raw": "https://api.pdf.co/v1/account/credit/balance",
"protocol": "https",
"host": [
"api",
"pdf",
"co"
],
"path": [
"v1",
"account",
"credit",
"balance"
],
"query": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Server",
"value": "Cowboy"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Etag",
"value": "W/\"6e00b45d69a6fc492724ff16f41bba80\""
},
{
"key": "Cache-Control",
"value": "must-revalidate, private, max-age=0"
},
{
"key": "X-Request-Id",
"value": "3174453e-2981-45aa-b436-bca0262122ed"
},
{
"key": "X-Runtime",
"value": "0.010917"
},
{
"key": "Date",
"value": "Wed, 01 Sep 2021 17:48:45 GMT"
},
{
"key": "X-Rack-Cache",
"value": "miss"
},
{
"key": "Vary",
"value": "Accept-Encoding, Origin"
},
{
"key": "Content-Encoding",
"value": "gzip"
},
{
"key": "Strict-Transport-Security",
"value": "max-age=31536000; includeSubDomains"
},
{
"key": "Transfer-Encoding",
"value": "chunked"
},
{
"key": "Via",
"value": "1.1 vegur"
}
],
"cookie": [],
"body": "{\n \"remainingCredits\": 99795868\n}"
}
]
},
{
"name": "/license/info (on-prem API Server only)",
"request": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"disabled": true
},
{
"key": "",
"value": "",
"type": "text",
"disabled": true
}
],
"url": {
"raw": "localhost:8080/license/info",
"host": [
"localhost"
],
"port": "8080",
"path": [
"license",
"info"
],
"query": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
}
]
},
"description": "**Description:** Get your complete license information.\n\n**Errors**\n\n| Code | Description |\n| --- | --- |\n| `200` | The request has succeeded |\n| `400` | bad input parameters |\n| `401` | unauthorized |\n| `403` | not enough credits |\n| `405` | Timeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info` |\n\n**Example**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)"
},
"response": [
{
"name": "/license/info (on-prem API Server only)",
"originalRequest": {
"method": "GET",
"header": [
{
"key": "x-api-key",
"type": "text",
"value": "{{x-api-key}}",
"description": "Required. API key for PDF.co. Get yours at https://pdf.co/",
"disabled": true
},
{
"key": "",
"value": "",
"type": "text",
"disabled": true
}
],
"url": {
"raw": "localhost:8080/license/info",
"host": [
"localhost"
],
"port": "8080",
"path": [
"license",
"info"
],
"query": [
{
"key": "x-api-key",
"value": "{{x-api-key}}",
"description": "Optional. Please use http headers instead when possible because passing your API key as parameter for POST or GET is not secure and is for legacy app compatibility only.\n",
"disabled": true
}
]
}
},
"status": "OK",
"code": 200,
"_postman_previewlanguage": "json",
"header": [
{
"key": "Date",
"value": "Wed, 01 Sep 2021 17:51:19 GMT"
},
{
"key": "Content-Type",
"value": "application/json; charset=utf-8"
},
{
"key": "Content-Length",
"value": "1715"
},
{
"key": "Connection",
"value": "keep-alive"
},
{
"key": "Cache-Control",
"value": "private"
},
{
"key": "Server",
"value": "Microsoft-IIS/8.5"
},
{
"key": "X-AspNet-Version",
"value": "4.0.30319"
},
{
"key": "X-Powered-By",
"value": "ASP.NET"
}
],
"cookie": [],
"body": "{\n \"body\": {\n \"modules\": [\n {\n \"moduleName\": \"PDFExtractor\",\n \"enabled\": true,\n \"licenseInfo\": {\n \"LicenseType\": \"Commercial\",\n \"UpdatesExpireOn\": \"Never\",\n \"LimitType\": \"Unlimited\",\n \"LimitTerm\": \"None\",\n \"Limit\": -1,\n \"Remainder\": -1\n }\n },\n {\n \"moduleName\": \"PDFToHTML\",\n \"enabled\": true,\n \"licenseInfo\": {\n \"LicenseType\": \"Commercial\",\n \"UpdatesExpireOn\": \"Never\",\n \"LimitType\": \"Unlimited\",\n \"LimitTerm\": \"None\",\n \"Limit\": -1,\n \"Remainder\": -1\n }\n },\n {\n \"moduleName\": \"PDFGenerator\",\n \"enabled\": true,\n \"licenseInfo\": {\n \"LicenseType\": \"Commercial\",\n \"UpdatesExpireOn\": \"Never\",\n \"LimitType\": \"Unlimited\",\n \"LimitTerm\": \"None\",\n \"Limit\": -1,\n \"Remainder\": -1\n }\n },\n {\n \"moduleName\": \"BarcodeGenerator\",\n \"enabled\": true,\n \"licenseInfo\": {\n \"LicenseType\": \"Commercial\",\n \"UpdatesExpireOn\": \"Never\",\n \"LimitType\": \"Unlimited\",\n \"LimitTerm\": \"None\",\n \"Limit\": -1,\n \"Remainder\": -1\n }\n },\n {\n \"moduleName\": \"BarcodeReader\",\n \"enabled\": true,\n \"licenseInfo\": {\n \"LicenseType\": \"Commercial\",\n \"UpdatesExpireOn\": \"Never\",\n \"LimitType\": \"Unlimited\",\n \"LimitTerm\": \"None\",\n \"Limit\": -1,\n \"Remainder\": -1\n }\n },\n {\n \"moduleName\": \"PDFRenderer\",\n \"enabled\": true,\n \"licenseInfo\": {\n \"LicenseType\": \"Commercial\",\n \"UpdatesExpireOn\": \"Never\",\n \"LimitType\": \"Unlimited\",\n \"LimitTerm\": \"None\",\n \"Limit\": -1,\n \"Remainder\": -1\n }\n },\n {\n \"moduleName\": \"Spreadsheet\",\n \"enabled\": true,\n \"licenseInfo\": {\n \"LicenseType\": \"Commercial\",\n \"UpdatesExpireOn\": \"Never\",\n \"LimitType\": \"Unlimited\",\n \"LimitTerm\": \"None\",\n \"Limit\": -1,\n \"Remainder\": -1\n }\n },\n {\n \"moduleName\": \"DocumentParser\",\n \"enabled\": true,\n \"licenseInfo\": {\n \"LicenseType\": \"Commercial\",\n \"UpdatesExpireOn\": \"Never\",\n \"LimitType\": \"Unlimited\",\n \"LimitTerm\": \"None\",\n \"Limit\": -1,\n \"Remainder\": -1\n }\n },\n {\n \"moduleName\": \"TextRecognition\",\n \"enabled\": true,\n \"licenseInfo\": {\n \"LicenseType\": \"Commercial\",\n \"UpdatesExpireOn\": \"Never\",\n \"LimitType\": \"Unlimited\",\n \"LimitTerm\": \"None\",\n \"Limit\": -1,\n \"Remainder\": -1\n }\n }\n ]\n },\n \"pageCount\": 0,\n \"error\": false,\n \"status\": 200\n}"
}
]
}
],
"description": "**Files Storage**\n\nYou can upload files as temporary files into PDF.co. Temporary files are stored for 1 hour by default and then auto removed.\n\nTo store files permanently (pdf templates, images you want to reuse) please use PDF.co built-in files storage at [https://app.pdf.co/files](https://app.pdf.co/files) instead.\n\nYou can also use 3rd party cloud services:\n\n- Dropbox: you can use `public link` to a file from Dropbox\n- Google Drive: you can use link to a file that was shared as `anyone with a link`\n- Google Docs/Sheets/Slides: you can use a link to a document in Google Docs that was shared as `anyone with a link`\n- Any other cloud service that can store a file and provide a link to uploaded file.\n\n**IMPORTANT NOTE FOR GOOGLE DRIVE/DOCS users**: free Google Drive/Docs limits the number of requests to their files. If you use a link to file or document from Google Drive or Google Drive then make sure you have no more than 5-10 requests per minute. Otherwise Google Drive returns no file or error page.\n\n**Temporary Files Upload**\n\nYou can upload **temporary** files up to 2GB in size. Please note that to process these files you should use `async=true` mode with data extraction and tools endpoints along with `/job/check` to check status of background jobs you create.\n\n**Steps to Upload File:**\n\n1) First, call `/file/upload/get-presigned-url`. It will generate **link for uploading** (`presignedUrl`) and **final link** (`url`)\n2) Now send your file to the `presignedUrl` link using the `PUT` method within the next 30 minutes. \n3) Once finished, use `url` to access the file you have just uploaded.\n\nNote: all uploaded files are considered to be temporary files and are automatically permanently removed after 1 hour.\n\n**Status Errors**\n\n| Code\t| Description|\n|-- |--\n|`200`| The request has succeeded|\n|`400`| bad input parameters|\n|`401`|\tunauthorized|\n|`403`|\tnot enough credits|\n|`405`|\tTimeout error. To process large documents or files please use asynchronous mode ( set `async` parameter to true) and then check the status using `/job/check` endpoint. If a file contains many pages then specify a page range using pages parameter. The number of pages of the document can be obtained using the endpoint `/pdf/info`|\n\n**Example: Uploading a Temporary File**\n\nSample Request:\n\n! Don't forget to set `x-api-key` url param or http header param (preferred) to API key, get yours [here](https://app.pdf.co/signup)\n\n```\nGET\nhttps://api.pdf.co/v1/file/upload/get-presigned-url?name=test.pdf&encrypt=true\n\n200\n{\n \"presignedUrl\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=900&....\",\n \"url\": \"https://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=....\",\n \"error\": false,\n \"status\": 200,\n \"name\": \"test.pdf\",\n \"remainingCredits\": 93574\n}\n\nPUT\nhttps://pdf-temp-files.s3-us-west-2.amazonaws.com/28e191b14f3a4f43b16fcef1d53d191e/test.pdf?X-Amz-Expires=900&....\n--form 'file=@/path/to/file'\n\n200\n{\n}\n\nNow you can access your file using link from \"url\" param to from the first step.\n```",
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
}
],
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"exec": [
""
]
}
}
]
}