Shutterfly Open API  |  Common Response Codes


All Shutterfly APIs return a common set of HTTP status codes. In case of error, the HTTP response body may have additional error messaging. If you contact Shutterfly for support, look at your HTTP response body and tell us the additional messaging. Also, please consult the API-specific error messaging document, as well as the documentation for the particular Shutterfly API you are using.

200
The call (usually a Read, Update or Delete type of operation) was accepted and processed normally. The request is valid and the response body follows the API specification. The response body may describe application-level errors.
201
The call (usually a Create operation) executed successfully. The request is valid and the response body follows the API specification. The response body may describe minor application-level errors.
400
Bad request. A basic application parameter failure. The response will include an HTTP content body that tells you more about the error.
Retriable: No
401
Unauthorized. A required credential (such as an Authentication token) was not supplied, was invalid or expired, etc.
Retriable: No
403
Forbidden. A valid credential (such as an Authentication token) was supplied, but application-level permission for the operation is required and has not been granted.
Retriable: No
404
Not found. The requested resource or document could not be found.
Retriable: No
405
Method not allowed. The application attempted an HTTP method that is not supported. Usually, this means a method other than the basic POST, GET, PUT, DELETE. Making HTTP calls to an HTTPS-only API will also result in this error.
Retriable: No
409
Conflict. The Create operation could not be completed, because a logically equivalent object or resource already exists.
Retriable: No
500
Internal server error. Some error condition internal to Shutterfly occured. The request should be retried later.
Retriable: Yes
509
Bandwidth exceeded. The application has exceeded the number of calls (or perhaps the kilobytes transferred) for the current minute, hour or month. HTTP error text will state the problem.
Retriable: Yes

Frequently Asked Questions

An API is giving me a 4xx response code, like 400. How do I figure out the real problem?

A 4xx error code normally comes with additional error messaging in the HTTP response body. Please look at it.

An API is giving me a 5xx response code, like 500. How do I figure out the real problem?

A 5xx error code means a Shutterfly system error. Wait a few minutes, then retry the API call. If the problem persists, ask for help at developerhelp@shutterfly.com.

© 1999-2014 Shutterfly, Inc. All rights reserved.