ScannedBusinessCard

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/actuallycare-com/json-schema/actuallycare-com-scanned-business-card-schema.json",
  "title": "ScannedBusinessCard",
  "description": "Structured output from the card-scan model. Every printed field is\nnullable — a card that omits a mobile number yields null, not \"\".\nMirrors CARD_SCHEMA in contacts/services/card-scan.service.js.\n",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_original/actuallycare-com-v1-openapi.json#/components/schemas/ScannedBusinessCard",
  "type": "object",
  "required": [
    "isBusinessCard",
    "confidence"
  ],
  "properties": {
    "isBusinessCard": {
      "type": "boolean",
      "description": "False if the image is not a business card"
    },
    "firstName": {
      "type": [
        "string",
        "null"
      ]
    },
    "lastName": {
      "type": [
        "string",
        "null"
      ]
    },
    "company": {
      "type": [
        "string",
        "null"
      ]
    },
    "jobTitle": {
      "type": [
        "string",
        "null"
      ]
    },
    "email": {
      "type": [
        "string",
        "null"
      ]
    },
    "phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "Primary/office number, as printed"
    },
    "mobile": {
      "type": [
        "string",
        "null"
      ]
    },
    "website": {
      "type": [
        "string",
        "null"
      ]
    },
    "addressLine": {
      "type": [
        "string",
        "null"
      ]
    },
    "city": {
      "type": [
        "string",
        "null"
      ]
    },
    "state": {
      "type": [
        "string",
        "null"
      ]
    },
    "postalCode": {
      "type": [
        "string",
        "null"
      ]
    },
    "licenseNumber": {
      "type": [
        "string",
        "null"
      ],
      "description": "DRE/BRE or other licence number if printed"
    },
    "confidence": {
      "type": "string",
      "enum": [
        "high",
        "medium",
        "low"
      ]
    },
    "model": {
      "type": "string",
      "description": "Model id that produced the extraction"
    },
    "usage": {
      "type": [
        "object",
        "null"
      ],
      "description": "Token usage reported by the provider"
    }
  }
}