Skip to main content

POST /submissions/audit

POST

Audit Reimbursement Claim Package

/submissions/audit

Performs an AI-powered compliance audit on a full reimbursement claim package. It cross-references receipts with proof of payment, inspects item descriptions against Florida PEP, UA, or custom handbook guidelines, checks dollar frequency limitations, and scores educational justification statements. Can be run synchronously (`async: false`) or queued asynchronously (`async: true`).

Headers

HTTP Headers
ParameterTypeDescription
Authorizationrequiredstring
Bearer token format: Bearer <API_KEY>
Example: Bearer pep_live_99281a8b
X-Tenant-IDoptionalstring
B2B Tenant identifier.
Example: stepup
Content-Typerequiredstring
application/json

Query Parameters

URL Query String
ParameterTypeDescription
detailedAnalysisoptionalboolean
default: true
When true, includes justification improvement hints and pedagogical alignment details in auditResult.
Example: true
strictHandbookRulesoptionalboolean
default: false
Enforces strict statutory handbook limits without administrative variance grace margins.
Example: true

Request Body

application/json
FieldTypeDescription
tenantIdoptionalstring
Tenant organization identifier.
Example: stepup
programKeyrequiredstring
Scholarship program code (e.g., FL_PEP, FL_FES_UA, AZ_ESA).
Example: FL_PEP
vendorrequiredstring
Name of the service provider or merchant.
Example: Kumon Math Center
amountrequirednumber
Total reimbursement claim amount requested.
Example: 180.00
asyncoptionalboolean
Whether to enqueue as an asynchronous job (default: false).
Example: false
lineItemsrequiredarray<LineItem>
Itemized claims with description, category, and parental justification.
↳descriptionrequiredstring
Line item description.
↳pricerequirednumber
Item unit price.
↳categoryrequiredstring
Primary reimbursement category.
↳typeoptionalstring
Sub-category classification.
↳justificationrequiredstring
Educational justification narrative provided by parent/guardian.
supportingFilesoptionalarray<FileRef>
Credentials, certifications, syllabus or required documentation.

Responses

4 status codes
200 OKAudit completed immediately (synchronous mode).
{
  "confidenceScore": 95,
  "overallStatus": "pass",
  "summary": "This submission meets all core program requirements and is eligible for reimbursement approval.",
  "receiptFormat": {
    "isValid": true,
    "summary": "All required receipt format elements are present (itemized, date, provider).",
    "missingFields": []
  },
  "purchaseLimitations": {
    "hasLimitations": false,
    "summary": "No purchase frequency caps or dollar limits violated for tutoring under FL_PEP guidelines.",
    "limitations": []
  },
  "supportingDocumentation": {
    "hasRequirements": true,
    "summary": "All required supporting documentation (Instructor Credentials) is attached and verified.",
    "requiredDocuments": [
      {
        "documentType": "Instructor Credentials",
        "isAttached": true,
        "status": "attached"
      }
    ]
  },
  "flags": [],
  "justificationAnalysis": [
    {
      "lineItemIndex": 0,
      "strength": "strong",
      "reason": "Justification clearly articulates the educational purpose and direct developmental benefit for the student.",
      "improvementHints": []
    }
  ],
  "disclaimer": "This audit is an AI-powered advisory review. Final reimbursement authority rests with the program scholarship granting organization."
}

Interactive Test Console

Bearer
detailedAnalysis
strictHandbookRules