Internal APIs

Card Vision (OCR)

Extract structured data from ID card, student card, or business card photos.

POST/api/card-vision

Uses a strong vision AI model to perform OCR on card images, extracting structured fields (name, phone, email, ID number, organization, etc.) with hallucination validation. Supports Arabic and English text. Internal API used during attendee enrollment via card scan.

Authorization

Session Authentication

This is an internal API that requires an active browser session. It cannot be called with an API key.

Body Parameters

Parameter	Type	Required	Description
`imageDataUrl`	string	required	Base64-encoded data URL of the card image.
`org_id`	string (UUID)	required	Organization UUID (must match user membership).

Responses

Card extracted successfully.

{
  "card": {
    "name": "Ahmed Mohamed",
    "fullName": "Ahmed Mohamed Ali",
    "phone": "+201234567890",
    "email": null,
    "externalId": "20231234",
    "organization": "Cairo University",
    "visibleText": [
      "الاسم: أحمد محمد علي",
      "كود الطالب: 20231234"
    ]
  }
}