{"info":{"_postman_id":"6fb01419-f1c3-4a26-9a02-d93244d40081","name":"Doqlo Bulk Fill Public API","description":"

Use this collection to run the Doqlo Bulk Fill Public API locally in Postman.

Doqlo Bulk Fill Public API executes .doqlo packages exported from the web Bulk Fill editor.

Before you run the requests:

create the layout and mapping in the web app first
export the .doqlo package from the web app
create a Bulk Fill API key from your account page
set DOQLO_API_KEY in the imported Postman environment
choose local files for pdf and doqlo_file
submit a job
poll the job if needed
download the ZIP result when the job is completed

Free plan users can run the Public API within Free plan limits. Paid plans support larger PDFs and higher monthly volume.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"54295397","collectionId":"6fb01419-f1c3-4a26-9a02-d93244d40081","publishedId":"2sBXqKneZN","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-04-30T19:48:53.000Z"},"item":[{"name":"Create export job with JSON rows","event":[{"listen":"test","script":{"type":"text/javascript","exec":["let data = null;","try {"," data = pm.response.json();","} catch (error) {"," data = null;","}","if (data && typeof data.job_id === 'string' && pm.environment && typeof pm.environment.set === 'function') {"," pm.environment.set('DOQLO_JOB_ID', data.job_id);","}"],"id":"ebc6982b-4d9f-4bcc-ad0b-f9de6840eb72"}}],"id":"e884e6d7-7ee0-4f5b-b33e-57db7ae7786a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Idempotency-Key","value":"{{DOQLO_IDEMPOTENCY_KEY}}","type":"text"},{"key":"X-Request-Id","value":"{{DOQLO_REQUEST_ID}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"pdf","type":"file","description":"

Choose source.pdf locally after import. Postman collections do not bundle local files.

\n","value":null},{"key":"doqlo_file","type":"file","description":"

Choose package.doqlo locally after import. Postman collections do not bundle local files.

\n","value":null},{"key":"max_failed_row_percent","value":"5","type":"text"},{"key":"rows_json","value":"[{\"column_0\":\"Alice Nguyen\",\"column_1\":\"INV-1001\"},{\"column_0\":\"Marco Silva\",\"column_1\":\"INV-1002\"}]","type":"text"},{"key":"filename_columns","value":"[\"column_0\",\"column_1\"]","type":"text"},{"key":"flatten_forms","value":"false","type":"text"},{"key":"include_stickers","value":"false","type":"text"}]},"url":"{{DOQLO_BASE_URL}}/v1/bulkfill/export-jobs","description":"

Create a minimal response-mode export job.

Choose local pdf and doqlo_file files after import because Postman collections do not bundle local files.
rows_json uses positional keys such as column_0 and column_1.
If the response includes a top-level job_id, this request saves it to DOQLO_JOB_ID in the active environment.
Use a new DOQLO_IDEMPOTENCY_KEY value for each new logical create request. Change it before switching between JSON and CSV create examples.

Choose source.pdf locally after import. Postman collections do not bundle local files.

\n","value":null},{"key":"doqlo_file","type":"file","description":"

Choose package.doqlo locally after import. Postman collections do not bundle local files.

\n","value":null},{"key":"csv_file","type":"file","description":"

Choose rows.csv locally after import. The public CSV contract is positional and does not auto-detect headers.

\n","value":null},{"key":"max_failed_row_percent","value":"5","type":"text"},{"key":"filename_columns","value":"[\"column_0\",\"column_1\"]","type":"text"},{"key":"flatten_forms","value":"false","type":"text"},{"key":"include_stickers","value":"false","type":"text"}]},"url":"{{DOQLO_BASE_URL}}/v1/bulkfill/export-jobs","description":"

Create a response-mode export job from a CSV upload.

Choose local pdf, doqlo_file, and csv_file files after import because Postman collections do not bundle local files.
Provide exactly one of rows_json or csv_file.
The public CSV contract is positional. Keep your mapped columns aligned to column_0, column_1, and later positions.
If the response includes a top-level job_id, this request saves it to DOQLO_JOB_ID in the active environment.
Use a new DOQLO_IDEMPOTENCY_KEY value for each new logical create request. Change it before switching between JSON and CSV create examples.

Read the current state of one export job.

Use this request if create returns queued or processing.
Wait until status is completed before downloading.
If status is failed, inspect the returned error details.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{DOQLO_API_KEY}}"}]},"isInherited":true,"source":{"_postman_id":"6fb01419-f1c3-4a26-9a02-d93244d40081","id":"6fb01419-f1c3-4a26-9a02-d93244d40081","name":"Doqlo Bulk Fill Public API","type":"collection"}},"urlObject":{"path":["v1","bulkfill","export-jobs","{{DOQLO_JOB_ID}}"],"host":["{{DOQLO_BASE_URL}}"],"query":[],"variable":[]}},"response":[{"id":"65528390-a532-4295-a5b6-226ffe7ef99c","name":"200 Completed export job status","originalRequest":{"method":"GET","header":[],"url":"{{DOQLO_BASE_URL}}/v1/bulkfill/export-jobs/{{DOQLO_JOB_ID}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"job_id\": \"example-job-id\",\n \"status\": \"completed\",\n \"created_at\": \"2026-04-24T15:18:30.577005Z\",\n \"started_at\": \"2026-04-24T15:18:30.592607Z\",\n \"completed_at\": \"2026-04-24T15:18:32.836613Z\",\n \"result\": {\n \"delivery_mode\": \"direct\",\n \"download_url\": \"/v1/bulkfill/export-jobs/example-job-id/download\",\n \"expires_at\": \"2026-04-24T21:18:32.824000Z\",\n \"file_size_bytes\": 2921485\n }\n}"}],"_postman_id":"4f32c6f4-b434-45c8-83cd-8055845911de"},{"name":"Download export result","event":[{"listen":"test","script":{"type":"text/javascript","exec":["// Proof-of-download visualization for ZIP file","const stream = pm.response.stream;","const bytes = new Uint8Array(stream);","const totalSize = bytes.length;","","// 1. Check ZIP magic signature: PK\\x03\\x04","const isZip = bytes.length >= 4 &&"," bytes[0] === 0x50 && bytes[1] === 0x4B &&"," bytes[2] === 0x03 && bytes[3] === 0x04;","","const magicHex = Array.from(bytes.slice(0, 4))"," .map((b) => b.toString(16).padStart(2, '0').toUpperCase())"," .join(' ');","","// 2. Format size","function formatSize(n) {"," if (n < 1024) return n + ' B';"," if (n < 1024 * 1024) return (n / 1024).toFixed(2) + ' KB';"," return (n / (1024 * 1024)).toFixed(2) + ' MB';","}","","// 3. Parse ZIP central directory to list files inside","function parseZipFileList(buf) {"," const files = [];"," let eocdOffset = -1;"," const maxScan = Math.min(buf.length, 65557);",""," for (let i = buf.length - 22; i >= buf.length - maxScan && i >= 0; i--) {"," if (buf[i] === 0x50 && buf[i + 1] === 0x4B && buf[i + 2] === 0x05 && buf[i + 3] === 0x06) {"," eocdOffset = i;"," break;"," }"," }",""," if (eocdOffset < 0) return files;",""," const dv = new DataView(buf.buffer, buf.byteOffset, buf.byteLength);"," const totalEntries = dv.getUint16(eocdOffset + 10, true);"," const cdOffset = dv.getUint32(eocdOffset + 16, true);",""," let p = cdOffset;"," for (let i = 0; i < totalEntries && p + 46 <= buf.length; i++) {"," if (!(buf[p] === 0x50 && buf[p + 1] === 0x4B && buf[p + 2] === 0x01 && buf[p + 3] === 0x02)) break;",""," const compressedSize = dv.getUint32(p + 20, true);"," const uncompressedSize = dv.getUint32(p + 24, true);"," const fileNameLen = dv.getUint16(p + 28, true);"," const extraLen = dv.getUint16(p + 30, true);"," const commentLen = dv.getUint16(p + 32, true);",""," const nameBytes = buf.slice(p + 46, p + 46 + fileNameLen);"," const name = new TextDecoder('utf-8').decode(nameBytes);",""," files.push({"," idx: i + 1,"," name: name,"," compressedFmt: formatSize(compressedSize),"," uncompressedFmt: formatSize(uncompressedSize)"," });",""," p += 46 + fileNameLen + extraLen + commentLen;"," }",""," return files;","}","","const files = isZip ? parseZipFileList(bytes) : [];","const contentType = pm.response.headers.get('Content-Type') || 'n/a';","const contentDisposition = pm.response.headers.get('Content-Disposition') || 'n/a';","","pm.test('Status code is 200', () => pm.response.to.have.status(200));","pm.test('Response is a valid ZIP file (PK header)', () => {"," pm.expect(isZip).to.be.true;","});","pm.test('ZIP contains at least one file', () => {"," pm.expect(files.length).to.be.above(0);","});","","const template = `","","","

"," ","","

","

ZIP Signature

","

"," {{#if isZip}}✓{{else}}✗{{/if}}"," {{magicHex}} (expected 50 4B 03 04)","

","

Total Size

","

{{sizeFmt}} ({{totalSize}} bytes)

","

Content-Type

","

Content-Disposition

","

Files in Archive

","

{{fileCount}}

","

","","{{#if fileCount}}","

","

Archive Contents

"," "," "," "," "," "," "," "," "," "," "," {{#each files}}"," "," "," "," "," "," "," {{/each}}"," ","

#	File Name	Compressed	Uncompressed
{{idx}}	{{name}}	{{compressedFmt}}	{{uncompressedFmt}}

","

","{{/if}}","`;","","const visualizerData = {"," isZip: isZip,"," magicHex: magicHex,"," totalSize: totalSize,"," sizeFmt: formatSize(totalSize),"," contentType: contentType,"," contentDisposition: contentDisposition,"," fileCount: files.length,"," files: files","};","","if (pm.visualizer && typeof pm.visualizer.set === 'function') {"," pm.visualizer.set(template, visualizerData);","}"],"id":"5771393b-6fca-4aa9-b6a1-82717259780f"}}],"id":"948f2ab2-1d58-4c1b-87fb-11e2bc25e1bc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{DOQLO_BASE_URL}}/v1/bulkfill/export-jobs/{{DOQLO_JOB_ID}}/download","description":"

Download the completed ZIP result.

Run this request after the job status is completed.
The response is an application/zip download.
In Postman, use Send and Download to save the ZIP file.
The ZIP contains generated row PDFs and manifest.json.

ZIP Download Verification

Archive Contents