Skip to main content

NOTE Effective January 31, 2026, ARD will no longer be available as an API programmatic ordering option for imagery through our platform. See the deprecation notice.

Request JSON File

Overview​

The {orderID}-request.json file is a copy of the order request body.

Note: there may be more than one order stored in the same prefix location. When this occurs, there will be an {orderID}-request.json file for each order.

Example request file​

{
"settings": {
            "acquisitions": ["03cf5011-7fd0-49ab-8bcf-36d7e2a1075f-inv"],
            "aoi": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [47.8, 29.25],
                        [47.8, 29.27],
                        [47.81, 29.27],
                        [47.81, 29.25],
                        [47.8, 29.25]
                    ]
                ]
        },
		"ard_settings": {
			"bundle_adjust": true,
			"healthy_vegetation_mask": false,
			"water_mask": false
		}
	},
	"output_config": {
		"amazon_s3": {
			"bucket": "example-bucket",
			"prefix": "example-prefix"
		}
	},
	"notifications": [{
		"type": "email",
		"target": "myemail@email.com",
		"level": "INTERMEDIATE"
	}],
	"metadata": {
		"project_id": "onboarding"
	}

}

File information​

File name: {orderID}-request.json

File location: root

File type: JSON