Face Matching

Compare two faces and get a similarity score.

Product pagePostman collectionOpenAPI spec

Base URL

https://use.api.co.id

Send two images as multipart/form-data (image1 and image2) with the x-api-co-id header. The response contains match (whether the faces match) and confidence (a 0.0–1.0 score, higher is more similar).

File format & limits

Requirement	Value
Formats	JPG, JPEG, PNG
Maximum size	5 MB per image
Content	Clearly visible face

Pricing

• 400 points per successful verification.
• Charges apply only to successful API calls; failed requests are not charged.

Verify Faces

POST/face-match/verify

Verify if two faces match by comparing images. Maximum file size: 5 MB per image. Supported formats: JPG, JPEG, PNG. Both images should contain clear, visible faces.

Body (multipart/form-data)

Name	Type	Description
image1Required	file	First image containing a face. Maximum size: 5 MB. Supported formats: JPG, JPEG, PNG
image2Required	file	Second image containing a face. Maximum size: 5 MB. Supported formats: JPG, JPEG, PNG

Response fields

Name	Type	Description
matchOptional	boolean	Boolean indicating if faces match Example: true
confidenceOptional	number	Confidence score from 0.0 to 1.0 (higher is better) Example: 0.95

Request

curl -X POST "https://use.api.co.id/face-match/verify" \  -H "x-api-co-id: $API_CO_ID_KEY" \  -F "[email protected]" \  -F "[email protected]"

Response

200OKSuccess - Faces Verified

{  "match": true,  "confidence": 0.95}

Use case

ID card to selfie

Compare the photo on an ID card with a current selfie for onboarding, KYC compliance, account registration, and access control.

Selfie to selfie

Confirm two selfies show the same person for multi-step verification, profile photo updates, and account recovery.

ID card to ID card

Compare photos from two ID cards for document authenticity checks, cross-reference identity checks, and duplicate detection.

Profile photo to selfie

Match a profile photo with a live selfie for social media, dating platform, and professional profile verification.

Historical photo comparison

Compare an old photo with a current selfie for long-term identity verification and historical record matching.

Faces from a group photo

Extract and compare faces from group photos for event attendance verification and group membership validation.