--- title: "Extract ID card or passport" method: POST path: "/job/add/workflow" tags: ["Document AI — OCR & IDP", "Document AI — PDF", "Document AI — Anonymization"] --- # Extract ID card or passport `POST /job/add/workflow` ## Request - Base URL: `https://api.paperoffice.ai/latest` - URL: `https://api.paperoffice.ai/latest/job/add/workflow` - Auth: HTTP bearer WHEN TO USE: identity cards and passports — extracts document number, holder name, dates of birth, issue and expiry via the prepared "Identity Document" profile. This operation has 27 documented variants (same method and path, different fields): - [Extract ID card or passport](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-identity-document-id-cardpassport.md) — WHEN TO USE: identity cards and passports — extracts document number, holder name, dates of birth, issue and expiry via the prepared "Identity Document" profile. - [Extract insurance policy](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-insurance-policy.md) — Extract insurance policy fields — policy number, insured party, coverage period, and premium. - [Extract legal document](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-legal-document.md) — Extract structured sections and parties from legal documents and contracts. - [Start adhoc document integrity check](https://api.paperoffice.ai/latest/docs/endpoints/po-documents-trust-check.md) — WRITE: start an adhoc Trust / integrity scan (credits). No agent id. Required: pofid or documents_id. Optional profile and tier. Then read po_documents_trust_get. Use processing_lane for Start-SLA... - [Extract payroll / pay stub](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-payroll-pay-stub.md) — Payroll / Pay Stub Extract salary and payroll data. Fields: employee_name, pay_period, gross, net, deductions, taxes, employer - [Extract hotel invoice](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-hotel-invoice.md) — Extract hotel invoice fields — guest, stay dates, room charges, taxes, and total amount. - [Export DATEV SKR03 accounting](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-accounting-datev-skr03.md) — Extract structured accounting data in DATEV SKR03 format. Fields: document date, document number, posting text, debit/credit account, amount, tax rate. - [Extract bank check data](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-bank-check.md) — WHEN TO USE: cheque documents — extracts cheque number, date, payee, amounts, bank and account data via the prepared "Process Bank Check" profile. For bank statements use po_extraction_bank_details. - [Extract bank details](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-bank-details.md) — Extract bank account details from financial documents — IBAN, BIC, account holder, and bank name fields. - [Extract cash receipt data](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-cash-receipt.md) — Extract structured fields from cash receipts — amount, date, vendor, and payment method. - [Extract custom fields (IDP)](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-custom-fields-idp-fields.md) — WHEN TO USE: extraction with your OWN field definitions (free profile) instead of a prepared one. Field keys use the canonical form with a leading underscore (_check_number). Keys without it are normalized automatically; the result... - [Extract invoice](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-invoice.md) — Extract structured invoice fields via the IDP workflow (POST /job/add/workflow). - [Extract invoice (German/DATEV-optimized)](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-invoice-germandeutsch.md) — Extract data from German invoices with DATEV-compatible fields. Fields: invoice number, date, supplier, customer, net, gross, VAT, IBAN, BIC. - [Extract invoice basic fields](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-invoice-light-basic-fields.md) — Lightweight invoice extraction with essential fields only — vendor, total, date, and invoice number. - [Extract statement of account](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-statement-of-account.md) — Extract account statement fields — period, opening balance, transactions, and closing balance. - [Extract utility bill](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-utility-bill.md) — Extract utility bill fields — provider, billing period, consumption, and amount due. - [Extract letter or mail](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-letter-mail.md) — Letters: Letter / Mail Extract letter metadata and content. Fields: sender, recipient, date, subject, body_summary. category: letters Use processing_lane for Start-SLA (no_sla|sla_24h|sla_12h|sla_6h|sla_1h|instant). - [Extract receipt](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-receipt.md) — Extract retail receipt fields — merchant, line items, tax, and total. - [Extract delivery note](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-delivery-note.md) — Extract delivery note fields — shipper, recipient, items, quantities, and delivery date. - [Extract purchase order](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-purchase-order.md) — Orders: Purchase Order Extract purchase order data. Fields: order_number, date, vendor, buyer, items, delivery_date, total - [Extract shipping waybill](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-shipping-waybill.md) — Extract shipping waybill fields — tracking number, carrier, sender, recipient, and weight. - [Extract construction plan/blueprint](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-construction-plan-blueprint.md) — Extract metadata and annotations from construction plans and blueprints via AI-IDP workflow. - [Extract vehicle registration](https://api.paperoffice.ai/latest/docs/endpoints/po-extraction-vehicle-registration.md) — Vehicle Registration Extract vehicle registration data. Fields: plate_number, make, model, VIN, owner, registration_date - [Split PDF via AI](https://api.paperoffice.ai/latest/docs/endpoints/po-editing-pdf-ai-split.md) — Split a multi-document PDF into separate files using AI layout analysis. - [Anonymize document (single-step)](https://api.paperoffice.ai/latest/docs/endpoints/po-anonymization-anonymize-document.md) — POST /job/add/workflow. template=document_anonymize. Params: file|pofid, model (required: basic|premium|ultra; without it 400 MODEL_REQUIRED before billing), redact_categories, whitelist, custom_redact, custom_instructions, scenario... - [Detect PII preview](https://api.paperoffice.ai/latest/docs/endpoints/po-anonymization-detect-pii-preview.md) — POST /job/add/workflow multipart. template=document_anonymize_preview (required). Params: file|pofid, model (required: basic|premium|ultra; without it 400 MODEL_REQUIRED before billing), redact_categories, whitelist, custom_redact... - [Finalize anonymize (workflow)](https://api.paperoffice.ai/latest/docs/endpoints/po-anonymization-finalize-redaction.md) — POST /job/add/workflow template=document_anonymize_finalize. Alternative to paperoffice_dataripper___redact_image when staying in workflow templates. Params: preview_images, preview_bounding_boxes, redact_boxes. Canonical apply for... ## Response `200` Success - SuccessEnvelope: Success envelope. Payload fields are endpoint-specific (top-level fields, `result`/`job_result` for jobs, `data` on some account endpoints). - `status` 'success', required - `processing_time` union - string - number - `_billing` object ## Other responses - `202`: Accepted — job continues in the background - `4XX`: Error - `5XX`: Error --- [API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)