Error codes
When an error occurs, an API-specific error code and an associated message will be added to the response. There are a wide variety of possible errors, so you should always check responses for problems before processing.
These error messages are primarily intended for developers during their testing; they will seem rather cryptic to your end users. A good approach is to present a generic message to the user while sending the actual message to an error log.
Please note - in the response headers, 200 OK is returned when the request is completed successfully. If an API error occurs, this response header is changed to best reflect the error (e.g. 403 Forbidden when no API Key is sent). However, you may disable this behaviour and always return 200 OK, regardless of the underlying API error code - see requests.
| Code | Message |
|---|---|
| 1 | The API service is currently unavailable for a short period. |
| 10 | You have requested a resource that does not exist. |
| 11 | You have exceeded the set request limit for this time window. |
| 12 | The resource does not support the request method used. |
| 13 | The version number is invalid. |
| 14 | The resource is not available under this version of the API. |
| 50 | You have not supplied an API key with your request. |
| 51 | The supplied API key is not valid. |
| 52 | The supplied API key has been revoked. |
| 53 | The request was denied. |
| 54 | The supplied API key has expired. |
| 55 | The supplied API key has reached its IP address limit. |
| 56 | The supplied API Key is invalid for this domain. |
| 100 | The requested response format was not recognised. |
| 200 | You have not specified a search query. |
| 201 | You have not specified a journal entry date. |
| 202 | The specified journal entry date is not in yyyy-mm-dd format. |
| 203 | You must either specifiy an entry ID or both a username and enry date. |
| 204 | You cannot exceed 5 entries per lookup. |
| 206 | You must specifiy a valid entry ID. |
| 210 | You have not specified a view. |
| 211 | The specified view is not supported. |
| 212 | The specified max value is not a number. |
| 213 | The specified max value exceeds the allowed value of 48. |
| 220 | You have not specified any contributor names. |
| 221 | The user must be a member. |
| 222 | The entry is already favourited. |
| 223 | The limit of 3 favourites per 24 hours is already reached. |
| 224 | The user is already subscribed to the journal. |
| 225 | The user is not subscribed to the journal. |
| 226 | A user cannot subscribe to or unsubscribe from their own journal. |
| 227 | You cannot retrieve more than 5 contributors. |
| 228 | The specified group does not exist. |
| 500 | Deprecated - You have not specified an authentication token. |
| 501 | The specified authentication token is invalid. |
| 502 | You have not specified an authentication nonce. |
| 503 | You have not specified an authentication signature. |
| 504 | You have not specified an authentication token. |
| 505 | You have not specified an authentication timestamp. |
| 506 | The authentication window has elapsed. |
| 507 | The supplied authentication nonce has already been used. |
| 508 | Authentication failed. |
| 509 | The resource is not available with your API key. |
| 510 | No email address provided. |
| 511 | No password provided. |
| 512 | The requested entry does not exist. |
| 513 | The requested user does not exist. |
| 514 | No comment provided. |
| 515 | Comments are disabled for this entry. |
| 516 | No temporary token provided. |
| 517 | The temporary token was invalid. |
| 518 | You are unable to post a comment on this entry. |
| 519 | Comment could not be added. |
| 600 | Request did not include image data. |
| 601 | The image format is not supported, or the image did not upload successfully. |
| 602 | The image filesize exceeds the allowed limit. |
| 603 | The image dimensions are too small. |
| 604 | An internal error occured which prevented the file from uploading. |
| 605 | There is no previously uploaded image available. |
| 606 | Request did not include a date, or the image EXIF date was not set. |
| 607 | The entry date was invalid. |
| 608 | The entry date is a date in the future. |
| 609 | The entry date is before your signup date. |
| 610 | There is an existing journal entry for the entry date. |
| 611 | The entry date is before your date of birth. |
| 612 | The specified journal entry date does not correspond to a day of the year. |
| 613 | The image could not be reached from the specified URL. |
| 616 | The crop parameter was invalid. |
| 617 | The crop dimensions will not produce a valid image. |
| 1000 | An internal error occured and your request could not be processed. |