{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cloudmersive/json-schema/cloudmersive-face-locate-with-landmarks-response-schema.json",
  "title": "FaceLocateWithLandmarksResponse",
  "description": "Results of locating faces in an image",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cloudmersive-face-api-openapi.yml#/components/schemas/FaceLocateWithLandmarksResponse",
  "type": "object",
  "properties": {
    "Successful": {
      "description": "True if the operation was successful, false otherwise",
      "type": "boolean"
    },
    "Faces": {
      "description": "Array of faces found in the image",
      "type": "array",
      "items": {
        "$ref": "#/$defs/FaceWithLandmarks"
      }
    },
    "FaceCount": {
      "format": "int32",
      "description": "Number of faces found in the image",
      "type": "integer"
    },
    "ErrorDetails": {
      "description": "Details of any errors that occurred",
      "type": "string"
    }
  },
  "$defs": {
    "FacePoint": {
      "description": "Point location within a face",
      "type": "object",
      "properties": {
        "X": {
          "format": "int32",
          "description": "X location, where 0 is the left-most pixel",
          "type": "integer"
        },
        "Y": {
          "format": "int32",
          "description": "Y location, where 0 is the top-most pixel",
          "type": "integer"
        }
      }
    },
    "FaceWithLandmarks": {
      "description": "Location of one face in an image",
      "type": "object",
      "properties": {
        "LeftX": {
          "format": "int32",
          "description": "X coordinate of the left side of the face",
          "type": "integer"
        },
        "TopY": {
          "format": "int32",
          "description": "Y coordinate of the top side of the face",
          "type": "integer"
        },
        "RightX": {
          "format": "int32",
          "description": "X coordinate of the right side of the face",
          "type": "integer"
        },
        "BottomY": {
          "format": "int32",
          "description": "Y coordinate of the bottom side of the face",
          "type": "integer"
        },
        "LeftEyebrow": {
          "description": "Point locations of the left eyebrow (the eyebrow cloesest to the left side of the picture)",
          "type": "array",
          "items": {
            "$ref": "#/$defs/FacePoint"
          }
        },
        "RightEyebrow": {
          "description": "Point locations of the right eyebrow (the eyebrow cloesest to the right side of the picture)",
          "type": "array",
          "items": {
            "$ref": "#/$defs/FacePoint"
          }
        },
        "LeftEye": {
          "description": "Point locations of the left eye (the eye closest to the left side of the picture)",
          "type": "array",
          "items": {
            "$ref": "#/$defs/FacePoint"
          }
        },
        "RightEye": {
          "description": "Point locations of the right eye (the eye closest to the right side of the picture)",
          "type": "array",
          "items": {
            "$ref": "#/$defs/FacePoint"
          }
        },
        "BottomAndSidesOfFace": {
          "description": "Point locations of the bottom and sides of the face (cheeks and chin)",
          "type": "array",
          "items": {
            "$ref": "#/$defs/FacePoint"
          }
        },
        "NoseBridge": {
          "description": "Point locations of the nose bridge (the vertical portion of the nose)",
          "type": "array",
          "items": {
            "$ref": "#/$defs/FacePoint"
          }
        },
        "NoseBottom": {
          "description": "Point locations of the bottom (nostrils) of the nose",
          "type": "array",
          "items": {
            "$ref": "#/$defs/FacePoint"
          }
        },
        "LipsInnerOutline": {
          "description": "Point locations of the inner outline of the lips",
          "type": "array",
          "items": {
            "$ref": "#/$defs/FacePoint"
          }
        },
        "LipsOuterOutline": {
          "description": "Point locations of the outer outline of the lips",
          "type": "array",
          "items": {
            "$ref": "#/$defs/FacePoint"
          }
        }
      }
    }
  }
}