Image Dimensions Checker API

Check pixel width, height, simplified aspect ratio, orientation and file size for up to 500 images in one report.

Environment

Environment	Base URL
Production	`https://api.sadafiles.com/v1`

There is one environment and no sandbox, so every request here is real and counts toward your limits.

Request

POSThttps://api.sadafiles.com/v1/tools/image-dimensions-checker

Content type: multipart/form-data
Auth: X-API-Key with tools:run
Accepts: jpg, png, webp, avif, gif, bmp, tiff, heic and 1 more
Files per request: 1 to 500
Largest file: 2 GB
Job timeout: 120 s
Rate weight: 2 units
Web tool: Use Image Dimensions Checker without code

Response

Status	Body	When
`201`	json	The run finished within 60 seconds
`202`	Job summary JSON	Still running; poll the job
`4xx, 5xx`	Error JSON	See error codes

A file response carries X-Sada-Job and X-Sada-Expires-At. For long work, post to /v1/tools/image-dimensions-checker/jobs instead. See jobs and webhooks.

Also runs on the device

In the web tool and apps, Image Dimensions Checker can run locally with no upload. The API always processes on the server.

Try it yourself!

Pick a file, set the options and run a real request with your key. The code follows your changes.

Headers

X-API-KeystringrequiredStays in this tab's memory and goes straight to the API. It never appears in the code below.

You need a free key to run this request. Sign in and create a key.

Body

files[]filerequiredUp to 500. Processed as a real job and deleted within 24 hours.

1curl -X POST "https://api.sadafiles.com/v1/tools/image-dimensions-checker" \2  -H "X-API-Key: $SADAFILES_API_KEY" \3  -F "files[]=@input.jpg" \4  -o output.json

Developer docs