{"info":{"_postman_id":"bfeed24e-4ab4-4cc8-a186-fd3cabb5c8d4","name":"Face Matching API","description":"

Complete API collection for face verification and matching services.

Features

Verify if two faces match using advanced AI models
Automatic face detection and comparison
High accuracy face matching with confidence scores
Support for various use cases and scenarios

Authentication

All requests require an API key in the x-api-co-id header.

Base URL

https://use.api.co.id/face-match\n

File Requirements

Supported formats: JPG, JPEG, PNG
Maximum file size: 5 MB per image
Content: Images containing clear, visible faces

Supported Use Cases

1. ID Card to Selfie Verification

Compare a person's ID card photo with their current selfie photo. Ideal for:

Identity verification in onboarding processes
KYC (Know Your Customer) compliance
Account registration and authentication
Access control systems

2. Selfie to Selfie Comparison

Compare two selfie photos to verify they are the same person. Useful for:

Multi-step verification processes
Profile photo updates verification
Account recovery procedures

3. ID Card to ID Card Comparison

Compare photos from two different ID cards. Suitable for:

Document authenticity verification
Cross-reference identity checks
Duplicate detection

4. Profile Photo to Selfie Verification

Compare a profile photo with a live selfie. Perfect for:

Social media account verification
Dating platform identity checks
Professional profile verification

5. Historical Photo Comparison

Compare an old photo with a current selfie. Useful for:

Long-term identity verification
Age progression verification
Historical record matching

6. Group Photo Face Extraction

Extract and compare faces from group photos. Ideal for:

Event attendance verification
Group membership validation
Photo tagging and organization

Response Fields

match: Boolean indicating if faces match (true/false)
confidence: Float value (0.0 to 1.0) representing match confidence score

Pricing

Cost per successful verification: 400 points
Charges apply only on successful API calls
Failed requests are not charged

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50289783","collectionId":"bfeed24e-4ab4-4cc8-a186-fd3cabb5c8d4","publishedId":"2sB3dMyBpb","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-03T17:24:08.000Z"},"item":[{"name":"Face Verification","item":[{"name":"Verify Faces","id":"91c1d390-8274-42c7-875e-7c771c6e745a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image1","type":"file","description":"

First image file containing a face (JPG, JPEG, or PNG). Maximum size: 5 MB

\n","value":null},{"key":"image2","type":"file","description":"

Second image file containing a face (JPG, JPEG, or PNG). Maximum size: 5 MB

\n","value":null}]},"url":"https://use.api.co.id/face-match/verify","description":"

Verify if two faces match by comparing images.

Request

Method: POST
Content-Type: multipart/form-data
File fields:
- image1 (required) - First image containing a face
- image2 (required) - Second image containing a face
\n

Supported File Types

JPG/JPEG (image/jpeg)
PNG (image/png)

File Size Limit

Maximum: 5 MB per image

Use Case Examples

ID Card to Selfie Verification

image1: ID card photo
image2: Current selfie photo
Use case: Verify user identity during registration or login

Selfie to Selfie Comparison

image1: First selfie photo
image2: Second selfie photo
Use case: Multi-step verification or profile update confirmation

Profile Photo to Selfie

image1: Profile photo from social media or database
image2: Live selfie photo
Use case: Account verification or profile authenticity check

ID Card to ID Card Comparison

image1: Photo from first ID card
image2: Photo from second ID card
Use case: Document cross-verification or duplicate detection

Response

Returns match result with confidence score:

match: Boolean indicating if faces match
confidence: Confidence score (0.0 to 1.0, higher is better)

Best Practices

Ensure faces are clearly visible in both images
Use well-lit photos for better accuracy
Avoid heavily edited or filtered images
Face should occupy a reasonable portion of the image
Both images should be of similar quality

\n","urlObject":{"path":["face-match","verify"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[{"id":"aa2ff4f6-a13a-4cfc-ac24-d3d53935f894","name":"Success - Faces Match","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image1","type":"file","src":["id_card.jpg"]},{"key":"image2","type":"file","src":["selfie.jpg"]}]},"url":"https://use.api.co.id/face-match/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"match\": true,\n \"confidence\": 0.95\n }\n}"},{"id":"d4e0a8ef-aa32-4de8-9fca-ead251baf4a0","name":"Success - Faces Do Not Match","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image1","type":"file","src":["person1.jpg"]},{"key":"image2","type":"file","src":["person2.jpg"]}]},"url":"https://use.api.co.id/face-match/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"match\": false,\n \"confidence\": 0.35\n }\n}"},{"id":"3bca1de2-4457-4b12-8e6d-f9d73c214549","name":"Error - Missing API Key","originalRequest":{"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"image1","type":"file","src":["image1.jpg"]},{"key":"image2","type":"file","src":["image2.jpg"]}]},"url":"https://use.api.co.id/face-match/verify"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"API key required in x-api-co-id header\",\n \"data\": null\n}"},{"id":"b55a9fa8-ce83-4958-ad33-38bd3c58145d","name":"Error - Missing Image1","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image2","type":"file","src":["image2.jpg"]}]},"url":"https://use.api.co.id/face-match/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"image1 is required. Please upload an image file using 'image1' field in multipart/form-data\",\n \"data\": null\n}"},{"id":"3e31f3a2-c188-4735-b7cb-062e5af48c1c","name":"Error - Missing Image2","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image1","type":"file","src":["image1.jpg"]}]},"url":"https://use.api.co.id/face-match/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"image2 is required. Please upload an image file using 'image2' field in multipart/form-data\",\n \"data\": null\n}"},{"id":"91f3c541-39b1-47e6-8f6d-a42cfdc6ceea","name":"Error - Invalid File Type","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image1","type":"file","src":["document.pdf"]},{"key":"image2","type":"file","src":["image.jpg"]}]},"url":"https://use.api.co.id/face-match/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"Invalid image1 file type. Only JPG, JPEG, and PNG image files are allowed\",\n \"data\": null\n}"},{"id":"322625b6-3901-4c4e-962f-627f869b83a4","name":"Error - File Too Large","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image1","type":"file","src":["large_image.jpg"]},{"key":"image2","type":"file","src":["image2.jpg"]}]},"url":"https://use.api.co.id/face-match/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"image1 file size exceeds maximum limit of 5 MB\",\n \"data\": null\n}"},{"id":"ecd9d95a-c20d-4250-beac-61a6c681eaf4","name":"Error - Insufficient Balance","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image1","type":"file","src":["image1.jpg"]},{"key":"image2","type":"file","src":["image2.jpg"]}]},"url":"https://use.api.co.id/face-match/verify"},"status":"Payment Required","code":402,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"Insufficient points balance. Please top up to continue.\",\n \"data\": null\n}"},{"id":"fba873d1-e3b2-4ac9-b85b-96d8b83e4a5d","name":"Error - No Face Detected","originalRequest":{"method":"POST","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image1","type":"file","src":["landscape.jpg"]},{"key":"image2","type":"file","src":["image2.jpg"]}]},"url":"https://use.api.co.id/face-match/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": false,\n \"message\": \"Failed to verify faces. Please ensure both images are valid and contain faces.\",\n \"data\": null\n}"}],"_postman_id":"91c1d390-8274-42c7-875e-7c771c6e745a"}],"id":"2c9dc360-52f9-4cbd-82de-2e8182a560ca","description":"

Face verification endpoints for comparing and matching faces in images.

\n","_postman_id":"2c9dc360-52f9-4cbd-82de-2e8182a560ca"}],"variable":[{"key":"base_url","value":"https://use.api.co.id","type":"string","description":"Base URL for the API"},{"key":"api_key","value":"YOUR_API_KEY_HERE","type":"string","description":"Your API key for authentication. Get it from api.dashboard or your database."}]}