ID Cropper

---

The ID Cropper API automatically crops ID images to keep only the document itself and remove any surrounding background. Send the image as a Base64 string, and the API detects the ID area, isolates it, and returns a clean, properly cropped version of the document.

ID Cropper

POST https://valifystage.com/api/v1/id_cropper_register

Headers

Name	Type	Description
Content-Type	string	application/json
Authentication	string	Bearer <access-token>

Request Body

Name	Type	Description
bundle_key	string	A bundle key provided to you by Valify.
img	string	Base64 image that need to be cropped
lang (optional)	string	The error message language

Status Codes

✅ 200 Successful

{
    "data": {
        "img": "<base64_cropped_image>"
    },
    "transaction_id": <str>,
    "trials_remaining": <str>
}

400 Missing input data

401 Invalid bundle key

403 Access token error

404 Check the endpoint

415 The format should be base64

422 Check Valify error codes

500 Contact us

---

Integration

🚀Postman

1. Download the JSON file from here.

1KB

ID Cropper API.postman_collection.json

Open

Passport OCR

1. Open Postman and click on Import.

   

   1. Drop the JSON file.

   

   1. Click on "Passport" and then click on "Authorization" and replace the <access token> field with your access token and then click on "Body".

1. Click on "Body" then fill in the required data and hit "Send".

🐍Python 3