{
  "_readme": "Illustrative records for the DocTrace sandbox. Every person, number and hospital here is made up; this is not real data and it is not served by the live API.",
  "base_url": "https://api.doctrace.scangeni.us",
  "scenarios": [
    {
      "id": "clean",
      "label": "Registered, clean",
      "request": {
        "council": "Karnataka Medical Council",
        "reg_no": "000000"
      },
      "status": 200,
      "body": {
        "ok": true,
        "verified": true,
        "canonical_uid": "DT-KMC-000000",
        "practitioner": {
          "name": "A. Example",
          "registration_number": "000000",
          "state_medical_council": "Karnataka Medical Council",
          "registration_date": "2015-06-01T00:00:00.000Z",
          "registration_year": 2015,
          "registration_status": "active",
          "qualification": "MBBS, MD (General Medicine)",
          "university": "Example University of Health Sciences",
          "college": null
        },
        "disciplinary_standing": {
          "has_disciplinary_record": false,
          "status": "CLEAN_STANDING",
          "orders": []
        },
        "hospital_affiliations": [],
        "statutory_provenance": {
          "source": "National Medical Commission & State Medical Council Statutory Rolls",
          "verified_at": "2026-10-22T14:42:48.673Z"
        }
      },
      "act": "Proceed. Store the whole response with its verified_at as your record."
    },
    {
      "id": "sanctioned",
      "label": "Registered, sanctioned",
      "request": {
        "council": "Maharashtra Medical Council",
        "reg_no": "000001"
      },
      "status": 200,
      "body": {
        "ok": true,
        "verified": true,
        "canonical_uid": "DT-MMC-000001",
        "practitioner": {
          "name": "B. Example",
          "registration_number": "000001",
          "state_medical_council": "Maharashtra Medical Council",
          "registration_status": "active",
          "qualification": "MBBS"
        },
        "disciplinary_standing": {
          "has_disciplinary_record": true,
          "status": "SANCTIONED",
          "orders": [
            {
              "event_type": "penal_erasure_temporary",
              "event_date": "2023-08-22T00:00:00.000Z",
              "authority": "Maharashtra Medical Council Disciplinary Committee",
              "order_reference": "EXAMPLE/2023/000",
              "description": "Example summary of the sanction.",
              "source_url": "https://example.org/order"
            }
          ]
        },
        "statutory_provenance": {
          "source": "National Medical Commission & State Medical Council Statutory Rolls",
          "verified_at": "2026-10-22T14:42:48.673Z"
        }
      },
      "act": "Do not auto-approve. Send it to a person, with the order reference and source_url attached."
    },
    {
      "id": "suspended",
      "label": "Registration suspended",
      "request": {
        "council": "Delhi Medical Council",
        "reg_no": "000002"
      },
      "status": 200,
      "body": {
        "ok": true,
        "verified": true,
        "canonical_uid": "DT-DMC-000002",
        "practitioner": {
          "name": "C. Example",
          "registration_number": "000002",
          "state_medical_council": "Delhi Medical Council",
          "registration_status": "suspended",
          "qualification": "MBBS, MS (Surgery)"
        },
        "disciplinary_standing": {
          "has_disciplinary_record": true,
          "status": "SANCTIONED",
          "orders": [
            {
              "event_type": "warning_notice",
              "event_date": "2024-02-10T00:00:00.000Z",
              "authority": "Delhi Medical Council Disciplinary Committee",
              "order_reference": "EXAMPLE/2024/000",
              "description": "Example summary of the order.",
              "source_url": "https://example.org/order"
            }
          ]
        },
        "statutory_provenance": {
          "source": "National Medical Commission & State Medical Council Statutory Rolls",
          "verified_at": "2026-10-22T14:42:48.673Z"
        }
      },
      "act": "Do not proceed. A suspended registration cannot be relied on, so route it to a person."
    },
    {
      "id": "not_found",
      "label": "Not found",
      "request": {
        "council": "Karnataka Medical Council",
        "reg_no": "999999"
      },
      "status": 404,
      "body": {
        "ok": false,
        "verified": false,
        "message": "Doctor not found in national statutory register"
      },
      "act": "Ask for the number again and check the council name. Not found is not proof of fraud."
    },
    {
      "id": "bad_request",
      "label": "Missing parameter",
      "request": {
        "council": "Karnataka Medical Council",
        "reg_no": ""
      },
      "status": 400,
      "body": {
        "ok": false,
        "verified": false,
        "message": "Missing required parameter: reg_no"
      },
      "act": "Fix the request: send both council and reg_no. Do not retry it unchanged."
    }
  ]
}