AI Documents

Upload a file and receive extracted fields and classification when processing completes (via the endpoint response and your callback).

Run AI on a document

POST /ai_documents — Upload a document for AI extraction. Returns immediately with a token; results are sent to your callback URL when processing completes.

Request Parameters

Parameter	Required	Description
file	Yes	PDF document only, up to 50 MB (52,428,800 bytes)
callback_url	Yes	URL to receive results when processing completes

export API_BASE="https://api.medsender.com/api/v2"
export API_KEY="sk_test_..."

curl -s -X POST -H "Authorization: Bearer $API_KEY" \
  -F "file=@./sample.pdf" \
  -F "callback_url=https://example.com/webhooks/ai" \
  "$API_BASE/ai_documents"

bash

export API_BASE="https://api.medsender.com/api/v2"
export API_KEY="sk_test_..."

curl -s -X POST -H "Authorization: Bearer $API_KEY" \
  -F "file=@./sample.pdf" \
  -F "callback_url=https://example.com/webhooks/ai" \
  "$API_BASE/ai_documents"

export API_BASE="https://api.medsender.com/api/v2"
export API_KEY="sk_test_..."

curl -s -X POST -H "Authorization: Bearer $API_KEY" \
  -F "file=@./sample.pdf" \
  -F "callback_url=https://example.com/webhooks/ai" \
  "$API_BASE/ai_documents"

List AI Documents

GET /ai_documents

curl -s -H "Authorization: Bearer sk_test_..." "https://api.medsender.com/api/v2/ai_documents" | jq

bash

curl -s -H "Authorization: Bearer sk_test_..." "https://api.medsender.com/api/v2/ai_documents" | jq

curl -s -H "Authorization: Bearer sk_test_..." "https://api.medsender.com/api/v2/ai_documents" | jq

Get AI Document

GET /ai_documents/:id where :id is the returned token.

curl -s -H "Authorization: Bearer sk_test_..." "https://api.medsender.com/api/v2/ai_documents/REPLACE_AI_TOKEN" | jq

bash

curl -s -H "Authorization: Bearer sk_test_..." "https://api.medsender.com/api/v2/ai_documents/REPLACE_AI_TOKEN" | jq

curl -s -H "Authorization: Bearer sk_test_..." "https://api.medsender.com/api/v2/ai_documents/REPLACE_AI_TOKEN" | jq

Response Examples

Create

{
  "message": "AI Document Classification has initiated, callback will be sent upon completion.",
  "aiToken": "c4d5e6f7a8b9"
}

JSON

{
  "message": "AI Document Classification has initiated, callback will be sent upon completion.",
  "aiToken": "c4d5e6f7a8b9"
}

{
  "message": "AI Document Classification has initiated, callback will be sent upon completion.",
  "aiToken": "c4d5e6f7a8b9"
}

Get / List

{
  "aiResult": {
    "aiToken": "d9eabe46-7ba7-40a3-902f-1e383f636140",
    "patientName": "John Doe",
    "patientDob": "1990-01-15",
    "patientPhoneNumber": "+15550100001",
    "patientGender": "Male",
    "patientAddress": "123 Example Street, Anytown, CA 90210",
    "documentClassification": "Referral",
    "documentSummary": "Cardiology referral for routine evaluation.",
    "insurancePlanName": "Example Health PPO",
    "insurancePayer": "Example Insurance Co",
    "insuranceGroupNumber": "GRP-000001",
    "insuranceMemberId": "MEM000000001",
    "insuranceSubscriberName": "John Doe",
    "insuranceMemberNames": "John Doe",
    "icdCodesJson": [{"code": "R00.0"}, {"code": "I10"}],
    "cptCodesJson": [{"code": "99213"}, {"code": "93000"}],
    "hcpcsCodesJson": [],
    "completedAt": "2025-01-15T11:00:00.000Z",
    "errorDetails": null
  }
}

JSON

{
  "aiResult": {
    "aiToken": "d9eabe46-7ba7-40a3-902f-1e383f636140",
    "patientName": "John Doe",
    "patientDob": "1990-01-15",
    "patientPhoneNumber": "+15550100001",
    "patientGender": "Male",
    "patientAddress": "123 Example Street, Anytown, CA 90210",
    "documentClassification": "Referral",
    "documentSummary": "Cardiology referral for routine evaluation.",
    "insurancePlanName": "Example Health PPO",
    "insurancePayer": "Example Insurance Co",
    "insuranceGroupNumber": "GRP-000001",
    "insuranceMemberId": "MEM000000001",
    "insuranceSubscriberName": "John Doe",
    "insuranceMemberNames": "John Doe",
    "icdCodesJson": [{"code": "R00.0"}, {"code": "I10"}],
    "cptCodesJson": [{"code": "99213"}, {"code": "93000"}],
    "hcpcsCodesJson": [],
    "completedAt": "2025-01-15T11:00:00.000Z",
    "errorDetails": null
  }
}

{
  "aiResult": {
    "aiToken": "d9eabe46-7ba7-40a3-902f-1e383f636140",
    "patientName": "John Doe",
    "patientDob": "1990-01-15",
    "patientPhoneNumber": "+15550100001",
    "patientGender": "Male",
    "patientAddress": "123 Example Street, Anytown, CA 90210",
    "documentClassification": "Referral",
    "documentSummary": "Cardiology referral for routine evaluation.",
    "insurancePlanName": "Example Health PPO",
    "insurancePayer": "Example Insurance Co",
    "insuranceGroupNumber": "GRP-000001",
    "insuranceMemberId": "MEM000000001",
    "insuranceSubscriberName": "John Doe",
    "insuranceMemberNames": "John Doe",
    "icdCodesJson": [{"code": "R00.0"}, {"code": "I10"}],
    "cptCodesJson": [{"code": "99213"}, {"code": "93000"}],
    "hcpcsCodesJson": [],
    "completedAt": "2025-01-15T11:00:00.000Z",
    "errorDetails": null
  }
}

Response Fields

The aiResult object contains extracted information:

Field	Description
aiToken	Unique identifier for this AI document request
documentClassification	Document type: "Referral", "Lab Result", "Prior Authorization", "Imaging Result", "Pharmacy Request", "Consult Note", "Discharge Summary", "Medical Records Request", or "Other"
documentSummary	AI-generated summary of the document contents
patientName	Full patient name extracted from document
patientDob	Patient date of birth (YYYY-MM-DD)
patientPhoneNumber	Patient phone number
patientGender	Patient gender
patientAddress	Patient address
insurancePlanName	Primary insurance plan name
insurancePayer	Primary insurance payer/company
insuranceGroupNumber	Insurance group number
insuranceMemberId	Insurance member ID
icdCodesJson	Array of ICD codes: [{"code": "I10"}, ...]
cptCodesJson	Array of CPT codes: [{"code": "99213"}, ...]
hcpcsCodesJson	Array of HCPCS codes
completedAt	When processing completed (ISO 8601)
errorDetails	Error message if processing failed, otherwise null