Upgrade to ChromeUpgrade to FirefoxUpgrade to Internet ExplorerUpgrade to Safari

Order Validation

Before submitting an order, you can validate it to make sure it's good to go, or to tell you why it isn't

URL

https://api.pwinty.com/v2.2/Orders/{id}/SubmissionStatus

Method

GET

Parameters

  1. id Order id

Sample JSON Response

{
    "id": 1065,
    "isValid": false,
    "generalErrors" : [
        "PostalAddressNotSet",
        "ItemsContainingErrors"
    ]
    "photos" : [
        {
           "id" : 5431,
           "errors" : [
                "FileCouldNotBeDownloaded"
           ],
           "warnings" : []
        },
        {
           "id" : 5449
           "errors" : [],
           "warnings" : [
                "PictureSizeTooSmall",
                "CroppingWillOccur"
           ]
        }
    ]
}

Return values

Field Description
id Id of the order this object relates to
isValid Boolean- is the order valid for submission (will it succeed if you submit it)
photos Array of objects containing any photos in the order which have errors or warnings. Details on structure
generalErrors An array of strings, containing any top level errors associated with the order Possible values

Photo object (the photos array can contain 0 to many of these)

Field Description
id Id of the photo this object relates to
errors Array of objects containing any errors associated with this photo. Possible values
warnings Array of objects containing any warnings associated with this photo. Possible values

General Errors (which may be found in the generalErrors array)

AccountBalanceInsufficient
You cannot submit any more orders until you have paid off the balance outstanding on your account
ItemsContainingErrors
One or more of the photos in the order has errors- see the photos object for more information
NoItemsInOrder
The order has no photos associated with it, so cannot be submitted
PostalAddressNotSet
The postal address fields on the order were not properly set

Photo Errors

FileCouldNotBeDownloaded
You gave us a URL to download the image from. We could not download an image from the URL (we try multiple times)
NoImageFile
You haven't given us a URL to download an image from, nor have you POSTed us an image, so we have no image for this photo
InvalidImageFile
We found an image- but it is not a valid jpg file.
PostalAddressNotSet
The postal address fields on the order were not properly set (you must set at least address1, addressTownOrCity, postalOrZipCode and country

Photo Warnings

CroppingWillOccur
The image supplied does not match the aspect ratio of the photo size. We'll need to crop or resize it to fit it on the photo
PictureSizeTooSmall
The image supplied is below the recommended resolution for a photo of this size. Recommended resolutions
CouldNotValidateImageSize
You've supplied a photo with a URL, and submitted it before the photo has been downloaded. This means we can't yet see if the image size is above the recommended resolution for the size of photo
CouldNotValidateAspectRatio
You've supplied a photo with a URL, and submitted it before the photo has been downloaded. This means we can't yet see if the aspect ratio matches that of the chosen photo size

Errors

  • 404 - Order with the specified id was not found