{
  "info": {
    "_postman_id": "45195989-d1f9-43d8-81d1-620cb18590e8",
    "name": "Factum Parse API",
    "description": "High-performance B2B document and e-invoice parser tailored for Italian administrative frameworks.\n\n**Features:**\n- Native Fast-Path processing for Italian XML FatturaPA\n- AI-powered parsing for PDF invoices and F24 forms\n- Privacy-first Zero Data Retention (volatile in-RAM execution)\n- Request-scoped PII pseudonymization via Rizzo PII sidecar\n\n**Authentication:** `X-API-Key` header. Get your key on [Zyla Marketplace](https://zylalabs.com/api-marketplace/legal+%26+compliance/factum+parse+api/13523).\n\n**Docs:** https://docs.factum.pyragogy.org\n**OpenAPI:** https://docs.factum.pyragogy.org/openapi.json\n**Postman:** https://docs.factum.pyragogy.org/postman_collection.json",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "createdAt": "2026-09-08T14:45:23.000Z",
    "updatedAt": "2026-09-08T14:45:23.000Z",
    "lastUpdatedBy": "58060705",
    "uid": "58060705-45195989-d1f9-43d8-81d1-620cb18590e8"
  },
  "item": [
    {
      "name": "Health Check",
      "id": "79503bae-0ad0-40f7-8829-cac01797bdcf",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "https://{{base_url}}/health",
          "protocol": "https",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "health"
          ]
        }
      },
      "response": [
        {
          "id": "2c2a60d4-d8b8-4618-bc80-f4dcea9cb0e9",
          "name": "Health OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://{{base_url}}/health",
              "protocol": "https",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "health"
              ]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "cookie": [],
          "responseTime": null,
          "body": "{\n  \"status\": \"healthy\",\n  \"version\": \"0.1.0\"\n}",
          "createdAt": "2026-09-08T14:45:24.000Z",
          "updatedAt": "2026-09-08T14:45:24.000Z",
          "uid": "58060705-2c2a60d4-d8b8-4618-bc80-f4dcea9cb0e9"
        }
      ],
      "createdAt": "2026-09-08T14:45:24.000Z",
      "updatedAt": "2026-09-08T14:45:24.000Z",
      "uid": "58060705-79503bae-0ad0-40f7-8829-cac01797bdcf"
    },
    {
      "name": "Status",
      "id": "493207af-7e9d-4902-9ce5-d9be609a6806",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "https://{{base_url}}/status",
          "protocol": "https",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "status"
          ]
        }
      },
      "response": [
        {
          "id": "e2efe875-2aa3-4c87-a921-6ead57948a29",
          "name": "Status OK",
          "originalRequest": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "https://{{base_url}}/status",
              "protocol": "https",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "status"
              ]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "cookie": [],
          "responseTime": null,
          "body": "{\n  \"status\": \"healthy\",\n  \"version\": \"0.1.0\",\n  \"services\": {\n    \"fast-path\": \"available\",\n    \"llm-vision\": \"available\",\n    \"rizzo-pii\": \"healthy\"\n  }\n}",
          "createdAt": "2026-09-08T14:45:24.000Z",
          "updatedAt": "2026-09-08T14:45:24.000Z",
          "uid": "58060705-e2efe875-2aa3-4c87-a921-6ead57948a29"
        }
      ],
      "createdAt": "2026-09-08T14:45:24.000Z",
      "updatedAt": "2026-09-08T14:45:24.000Z",
      "uid": "58060705-493207af-7e9d-4902-9ce5-d9be609a6806"
    },
    {
      "name": "Upload FatturaPA XML",
      "id": "4167883b-3989-43b2-9f32-8844340ce16c",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}",
            "type": "text",
            "description": "Your API key from Zyla Marketplace"
          },
          {
            "key": "X-Tier",
            "value": "{{tier}}",
            "type": "text",
            "description": "free | basic | pro"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "file",
              "type": "file",
              "src": "sample_fattura.xml"
            }
          ]
        },
        "url": {
          "raw": "https://{{base_url}}/v1/uploads",
          "protocol": "https",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "uploads"
          ]
        }
      },
      "response": [
        {
          "id": "a4741522-e01d-418f-85bf-d465f988912d",
          "name": "Upload Success",
          "originalRequest": {
            "method": "POST",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{api_key}}",
                "type": "text",
                "description": "Your API key from Zyla Marketplace"
              },
              {
                "key": "X-Tier",
                "value": "{{tier}}",
                "type": "text",
                "description": "free | basic | pro"
              }
            ],
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "file",
                  "type": "file",
                  "src": "sample_fattura.xml"
                }
              ]
            },
            "url": {
              "raw": "https://{{base_url}}/v1/uploads",
              "protocol": "https",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "uploads"
              ]
            }
          },
          "status": "Created",
          "code": 201,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "cookie": [],
          "responseTime": null,
          "body": "{\n  \"job_id\": \"3f2b5e6a-0000-4000-8000-000000000001\",\n  \"status\": \"uploaded\",\n  \"document_type\": \"fattura_pa\",\n  \"content_hash\": \"a1b2c3d4e5f67890abcdef1234567890abcdef12\",\n  \"file_size_bytes\": 15342,\n  \"ttl_minutes\": 60\n}",
          "createdAt": "2026-09-08T14:45:24.000Z",
          "updatedAt": "2026-09-08T14:45:24.000Z",
          "uid": "58060705-a4741522-e01d-418f-85bf-d465f988912d"
        }
      ],
      "createdAt": "2026-09-08T14:45:24.000Z",
      "updatedAt": "2026-09-08T14:45:24.000Z",
      "uid": "58060705-4167883b-3989-43b2-9f32-8844340ce16c"
    },
    {
      "name": "Upload PDF Invoice",
      "id": "9f14da04-05dd-4c9a-8191-6a43b931f33a",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}",
            "type": "text",
            "description": "Your API key from Zyla Marketplace"
          },
          {
            "key": "X-Tier",
            "value": "{{tier}}",
            "type": "text",
            "description": "free | basic | pro"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "file",
              "type": "file",
              "src": "sample_invoice.pdf"
            }
          ]
        },
        "url": {
          "raw": "https://{{base_url}}/v1/uploads",
          "protocol": "https",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "uploads"
          ]
        }
      },
      "response": [
        {
          "id": "65e41070-ed66-4d25-b14f-11ed85778a00",
          "name": "Upload Success",
          "originalRequest": {
            "method": "POST",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{api_key}}",
                "type": "text",
                "description": "Your API key from Zyla Marketplace"
              },
              {
                "key": "X-Tier",
                "value": "{{tier}}",
                "type": "text",
                "description": "free | basic | pro"
              }
            ],
            "body": {
              "mode": "formdata",
              "formdata": [
                {
                  "key": "file",
                  "type": "file",
                  "src": "sample_invoice.pdf"
                }
              ]
            },
            "url": {
              "raw": "https://{{base_url}}/v1/uploads",
              "protocol": "https",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "uploads"
              ]
            }
          },
          "status": "Created",
          "code": 201,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "cookie": [],
          "responseTime": null,
          "body": "{\n  \"job_id\": \"3f2b5e6a-0000-4000-8000-000000000002\",\n  \"status\": \"uploaded\",\n  \"document_type\": \"pdf\",\n  \"content_hash\": \"f1e2d3c4b5a67890abcdef1234567890abcdef12\",\n  \"file_size_bytes\": 245760,\n  \"ttl_minutes\": 60\n}",
          "createdAt": "2026-09-08T14:45:24.000Z",
          "updatedAt": "2026-09-08T14:45:24.000Z",
          "uid": "58060705-65e41070-ed66-4d25-b14f-11ed85778a00"
        }
      ],
      "createdAt": "2026-09-08T14:45:24.000Z",
      "updatedAt": "2026-09-08T14:45:24.000Z",
      "uid": "58060705-9f14da04-05dd-4c9a-8191-6a43b931f33a"
    },
    {
      "name": "Get Upload Status",
      "id": "2811bf42-3e66-4f6a-a70b-7b7df2dee7a6",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}",
            "type": "text",
            "description": "Your API key from Zyla Marketplace"
          },
          {
            "key": "X-Tier",
            "value": "{{tier}}",
            "type": "text",
            "description": "free | basic | pro"
          }
        ],
        "url": {
          "raw": "https://{{base_url}}/v1/uploads/3f2b5e6a-0000-4000-8000-000000000001",
          "protocol": "https",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "uploads",
            "3f2b5e6a-0000-4000-8000-000000000001"
          ]
        }
      },
      "response": [
        {
          "id": "bac30672-a66b-4fe7-8408-9bcfd93bb989",
          "name": "Job Done",
          "originalRequest": {
            "method": "GET",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{api_key}}",
                "type": "text",
                "description": "Your API key from Zyla Marketplace"
              },
              {
                "key": "X-Tier",
                "value": "{{tier}}",
                "type": "text",
                "description": "free | basic | pro"
              }
            ],
            "url": {
              "raw": "https://{{base_url}}/v1/uploads/3f2b5e6a-0000-4000-8000-000000000001",
              "protocol": "https",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "uploads",
                "3f2b5e6a-0000-4000-8000-000000000001"
              ]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "cookie": [],
          "responseTime": null,
          "body": "{\n  \"job_id\": \"3f2b5e6a-0000-4000-8000-000000000001\",\n  \"status\": \"done\",\n  \"document_type\": \"fattura_pa\",\n  \"content_hash\": \"a1b2c3d4e5f67890abcdef1234567890abcdef12\",\n  \"ttl_minutes\": 60\n}",
          "createdAt": "2026-09-08T14:45:24.000Z",
          "updatedAt": "2026-09-08T14:45:24.000Z",
          "uid": "58060705-bac30672-a66b-4fe7-8408-9bcfd93bb989"
        }
      ],
      "createdAt": "2026-09-08T14:45:24.000Z",
      "updatedAt": "2026-09-08T14:45:24.000Z",
      "uid": "58060705-2811bf42-3e66-4f6a-a70b-7b7df2dee7a6"
    },
    {
      "name": "Parse Document (text)",
      "id": "ce785dba-6016-4e80-945c-342bb71e7b09",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}",
            "type": "text",
            "description": "Your API key from Zyla Marketplace"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"text\": \"Fattura n. 2026/001 del 15/03/2026. Cedente: ACME S.r.l. \\u2014 Via Roma 1, Milano. P.IVA IT01234567890. Cliente: Mario Rossi. Totale documento: \\u20ac 1.220,00. Imponibile: \\u20ac 1.000,00. IVA 22%: \\u20ac 220,00.\",\n  \"doc_type\": \"auto\"\n}"
        },
        "url": {
          "raw": "https://{{base_url}}/v1/parse",
          "protocol": "https",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "parse"
          ]
        }
      },
      "response": [
        {
          "id": "77c9e62a-eb52-437d-a8b5-4800b8d2a011",
          "name": "Parse Success",
          "originalRequest": {
            "method": "POST",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{api_key}}",
                "type": "text",
                "description": "Your API key from Zyla Marketplace"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"text\": \"Fattura n. 2026/001 del 15/03/2026. Cedente: ACME S.r.l. \\u2014 Via Roma 1, Milano. P.IVA IT01234567890. Cliente: Mario Rossi. Totale documento: \\u20ac 1.220,00. Imponibile: \\u20ac 1.000,00. IVA 22%: \\u20ac 220,00.\",\n  \"doc_type\": \"auto\"\n}"
            },
            "url": {
              "raw": "https://{{base_url}}/v1/parse",
              "protocol": "https",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "parse"
              ]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "cookie": [],
          "responseTime": null,
          "body": "{\n  \"job_id\": \"3f2b5e6a-0000-4000-8000-000000000003\",\n  \"status\": \"done\",\n  \"document_type\": \"invoice\",\n  \"provider_used\": \"fast-path\",\n  \"prompt_version\": \"fast-path-v1\",\n  \"confidence\": 1.0,\n  \"cost_usd\": 0.0,\n  \"tokens\": 0,\n  \"fallbacks\": [],\n  \"content_hash\": \"a1b2c3d4e5f67890abcdef1234567890abcdef12\",\n  \"result\": {\n    \"schema_version\": \"2.0\",\n    \"document_type\": \"invoice\",\n    \"meta\": {\n      \"cost_eur\": 0.0,\n      \"confidence\": 1.0,\n      \"provider\": \"fast-path\",\n      \"prompt_version\": \"fast-path-v1\"\n    },\n    \"payload\": {\n      \"kind\": \"invoice\",\n      \"cedente_prestatore\": {\n        \"Denominazione\": \"ACME S.r.l.\",\n        \"PartitaIVA\": \"IT01234567890\"\n      },\n      \"cessionario_committente\": {\n        \"Denominazione\": \"Mario Rossi\"\n      },\n      \"dati_generali\": {\n        \"DatiGeneraliDocumento\": {\n          \"Data\": \"2026-03-15\",\n          \"Numero\": \"2026/001\"\n        }\n      },\n      \"dati_riepilogo\": [\n        {\n          \"ImponibileImporto\": 1000.0,\n          \"AliquotaIVA\": 22.0,\n          \"Imposta\": 220.0\n        }\n      ]\n    }\n  },\n  \"error\": null\n}",
          "createdAt": "2026-09-08T14:45:24.000Z",
          "updatedAt": "2026-09-08T14:45:24.000Z",
          "uid": "58060705-77c9e62a-eb52-437d-a8b5-4800b8d2a011"
        }
      ],
      "createdAt": "2026-09-08T14:45:24.000Z",
      "updatedAt": "2026-09-08T14:45:24.000Z",
      "uid": "58060705-ce785dba-6016-4e80-945c-342bb71e7b09"
    },
    {
      "name": "Parse Document (by job)",
      "id": "ebcca76f-90e2-4a39-8b3d-8d30c5a204c4",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "X-API-Key",
            "value": "{{api_key}}",
            "type": "text",
            "description": "Your API key from Zyla Marketplace"
          },
          {
            "key": "Content-Type",
            "value": "application/json",
            "type": "text"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"job_id\": \"3f2b5e6a-0000-4000-8000-000000000001\",\n  \"doc_type\": \"auto\",\n  \"async_mode\": false\n}"
        },
        "url": {
          "raw": "https://{{base_url}}/v1/parse",
          "protocol": "https",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "v1",
            "parse"
          ]
        }
      },
      "response": [
        {
          "id": "a6c5b006-c662-4bab-a682-af0d60f02e09",
          "name": "Parse Success (by job)",
          "originalRequest": {
            "method": "POST",
            "header": [
              {
                "key": "X-API-Key",
                "value": "{{api_key}}",
                "type": "text",
                "description": "Your API key from Zyla Marketplace"
              },
              {
                "key": "Content-Type",
                "value": "application/json",
                "type": "text"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"job_id\": \"3f2b5e6a-0000-4000-8000-000000000001\",\n  \"doc_type\": \"auto\",\n  \"async_mode\": false\n}"
            },
            "url": {
              "raw": "https://{{base_url}}/v1/parse",
              "protocol": "https",
              "host": [
                "{{base_url}}"
              ],
              "path": [
                "v1",
                "parse"
              ]
            }
          },
          "status": "OK",
          "code": 200,
          "_postman_previewlanguage": "json",
          "header": [
            {
              "key": "Content-Type",
              "value": "application/json"
            }
          ],
          "cookie": [],
          "responseTime": null,
          "body": "{\n  \"job_id\": \"3f2b5e6a-0000-4000-8000-000000000001\",\n  \"status\": \"done\",\n  \"document_type\": \"fattura_pa\",\n  \"provider_used\": \"fast-path\",\n  \"prompt_version\": \"fast-path-v1\",\n  \"confidence\": 1.0,\n  \"cost_usd\": 0.0,\n  \"tokens\": 0,\n  \"fallbacks\": [],\n  \"content_hash\": \"a1b2c3d4e5f67890abcdef1234567890abcdef12\",\n  \"result\": {\n    \"schema_version\": \"2.0\",\n    \"document_type\": \"invoice\",\n    \"meta\": {\n      \"cost_eur\": 0.0,\n      \"confidence\": 1.0,\n      \"provider\": \"fast-path\",\n      \"prompt_version\": \"fast-path-v1\"\n    },\n    \"payload\": {\n      \"kind\": \"invoice\",\n      \"dati_trasmissione\": {\n        \"IdTrasmittente\": {\n          \"IdPaese\": \"IT\",\n          \"IdCodice\": \"01234567890\"\n        }\n      },\n      \"cedente_prestatore\": {\n        \"Denominazione\": \"ACME S.r.l.\",\n        \"PartitaIVA\": \"IT01234567890\",\n        \"Sede\": {\n          \"Indirizzo\": \"Via Roma 1\",\n          \"CAP\": \"20121\",\n          \"Comune\": \"Milano\"\n        }\n      },\n      \"cessionario_committente\": {\n        \"Denominazione\": \"Mario Rossi\"\n      },\n      \"dati_generali\": {\n        \"DatiGeneraliDocumento\": {\n          \"Data\": \"2026-03-15\",\n          \"Numero\": \"2026/001\"\n        }\n      }\n    }\n  },\n  \"error\": null\n}",
          "createdAt": "2026-09-08T14:45:24.000Z",
          "updatedAt": "2026-09-08T14:45:24.000Z",
          "uid": "58060705-a6c5b006-c662-4bab-a682-af0d60f02e09"
        }
      ],
      "createdAt": "2026-09-08T14:45:24.000Z",
      "updatedAt": "2026-09-08T14:45:24.000Z",
      "uid": "58060705-ebcca76f-90e2-4a39-8b3d-8d30c5a204c4"
    }
  ],
  "variable": [
    {
      "key": "base_url",
      "value": "https://api.factum.pyragogy.org",
      "type": "string"
    },
    {
      "key": "api_key",
      "value": "YOUR_API_KEY",
      "type": "string"
    },
    {
      "key": "tier",
      "value": "free",
      "type": "string"
    }
  ]
}