Skip to main content
Webhook event is sent when processing of PII completes

Request

Headers: Body:
{
  "event": "rec.pii",
  "service": "rec",
  "event_time": 1759234802,
  "transaction_id": "4d39628e-7916-47d7-bc35-a00cb986942b",
  "data": {
    "status": "parsing_complete",
    "document_id": "ed66604d-9d62-4f71-a5fb-b78a490148a0",
    "data": {
      "pii": [
        {
          "file_index": 0,
          "page_num": 1,
          "document_date": 1562697000,
          "patient": {
            "age": {
              "years": 25,
              "months": 0,
              "days": 0
            },
            "gender": "male",
            "name": "THREE DUMMY"
          },
          "report_info": {
            "date_sample_collection": "10/07/2019 15:07:00",
            "date_sample_received": "10/07/2019 15:08:19",
            "date_report_generated": "10/07/2019 15:44:01",
            "doctor": "Dr. UNKNWON",
            "facility": "Dr Lal PathLabs"
          }
        }
      ]
    }
  }
}

Field Descriptions

  • data: Contains additional details related to the event.
    • status: Current parsing state (parsing_complete, parsing_error).
    • document_id: ID of the document that was parsed.
    • data: Additional Data.
      • pii: PII Data.
        • file_index: Zero-based index of the source file within the document.
        • page_num: One-based page number within that file.
        • document_date: Document timestamp (Unix epoch seconds).
        • patient : Patient metadata extracted from the page.
          • age Age at document_date.
            • years Years.
            • months Months.
            • days Days.
          • gender gender (male, female, other)
          • name Patient display name as printed on the report.
        • report_info : Laboratory/report details.
          • date_sample_collection Sample collection datetime.
          • date_sample_received Sample received datetime.
          • date_report_generated Report generated datetime.
          • doctor Ordering/referring physician.
          • facility Lab or organization name.
Note: The status field is an enum with following possible values:
  • parsing_complete
  • parsing_error
I