Error codes surfaced by the Twitter API.

TWTRAPIErrorCode

Definition

typedef NS_ENUM(NSUInteger, TWTRAPIErrorCode ) {
    TWTRAPIErrorCodeCouldNotAuthenticate = 32,
    TWTRAPIErrorCodePageNotExist = 34,
    TWTRAPIErrorCodeNotAuthorizedForEndpoint = 37,
    TWTRAPIErrorCodeAccountSuspended = 64,
    TWTRAPIErrorCodeAPIVersionRetired = 68,
    TWTRAPIErrorCodeRateLimitExceeded = 88,
    TWTRAPIErrorCodeInvalidOrExpiredToken = 89,
    TWTRAPIErrorCodeSSLInvalid = 92,
    TWTRAPIErrorCodeOverCapacity = 130,
    TWTRAPIErrorCodeInternalError = 131,
    TWTRAPIErrorCodeCouldNotAuthenticateTimestampOutOfRange = 135,
    TWTRAPIErrorCodeAlreadyFavorited = 139,
    TWTRAPIErrorCodeCannotFollowOverLimit = 161,
    TWTRAPIErrorCodeNotAuthorizedToSeeStatus = 179,
    TWTRAPIErrorCodeOverDailyStatusUpdateLimit = 185,
    TWTRAPIErrorCodeStatusIsDuplicate = 187,
    TWTRAPIErrorCodeBadAuthenticationData = 215,
    TWTRAPIErrorCodeRequestIsAutomated = 226,
    TWTRAPIErrorCodeUserMustVerifyLogin = 231,
    TWTRAPIErrorCodeBadGuestToken = 239,
    TWTRAPIErrorCodeEndpointRetired = 251,
    TWTRAPIErrorCodeApplicationCannotPerformWriteAction = 261,
    TWTRAPIErrorCodeCannotMuteSelf = 271,
    TWTRAPIErrorCodeCannotMuteSpecifiedUser = 272,
    TWTRAPIErrorCodeAlreadyRetweeted = 327,
    TWTRAPIErrorCodeTooManyRequests = 429,
};

Constants

TWTRAPIErrorCodeCouldNotAuthenticate

Your call could not be completed as dialed.

TWTRAPIErrorCodePageNotExist

Corresponds with an HTTP 404 - the specified resource was not found.

TWTRAPIErrorCodeNotAuthorizedForEndpoint

Not authorized to use this endpoint.

TWTRAPIErrorCodeAccountSuspended

Corresponds with an HTTP 403 — the access token being used belongs to a suspended user and they can’t complete the action you’re trying to take

TWTRAPIErrorCodeAPIVersionRetired

Corresponds to a HTTP request to a retired v1-era URL.

TWTRAPIErrorCodeRateLimitExceeded

The request limit for this resource has been reached for the current rate limit window.

TWTRAPIErrorCodeInvalidOrExpiredToken

The access token used in the request is incorrect or has expired. Used in API v1.1.

TWTRAPIErrorCodeSSLInvalid

Only SSL connections are allowed in the API, you should update your request to a secure connection. See how to connect using SSL.

TWTRAPIErrorCodeOverCapacity

Corresponds with an HTTP 503 - Twitter is temporarily over capacity.

TWTRAPIErrorCodeInternalError

Corresponds with an HTTP 500 - An unknown internal error occurred.

TWTRAPIErrorCodeCouldNotAuthenticateTimestampOutOfRange

Corresponds with a HTTP 401 - it means that your oauth_timestamp is either ahead or behind our acceptable range.

TWTRAPIErrorCodeAlreadyFavorited

You have already favorited this status.

TWTRAPIErrorCodeCannotFollowOverLimit

Corresponds with HTTP 403 — returned when a user cannot follow another user due to some kind of limit.

TWTRAPIErrorCodeNotAuthorizedToSeeStatus

Corresponds with HTTP 403 — returned when a Tweet cannot be viewed by the authenticating user, usually due to the Tweet’s author having protected their Tweets.

TWTRAPIErrorCodeOverDailyStatusUpdateLimit

Corresponds with HTTP 403 — returned when a Tweet cannot be posted due to the user having no allowance remaining to post. Despite the text in the error message indicating that this error is only returned when a daily limit is reached, this error will be returned whenever a posting limitation has been reached. Posting allowances have roaming windows of time of unspecified duration.

TWTRAPIErrorCodeStatusIsDuplicate

The status text has been Tweeted already by the authenticated account.

TWTRAPIErrorCodeBadAuthenticationData

Typically sent with 1.1 responses with HTTP code 400. The method requires authentication but it was not presented or was wholly invalid.

TWTRAPIErrorCodeRequestIsAutomated

We constantly monitor and adjust our filters to block spam and malicious activity on the Twitter platform. These systems are tuned in real-time. If you get this response our systems have flagged the Tweet or DM as possibly fitting this profile. If you feel that the Tweet or DM you attempted to create was flagged in error, please report the details around that to us by filing a ticket at https://support.twitter.com/forms/platform

TWTRAPIErrorCodeUserMustVerifyLogin

Returned as a challenge in xAuth when the user has login verification enabled on their account and needs to be directed to twitter.com to generate a temporary password.

TWTRAPIErrorCodeBadGuestToken

“Bad guest token.” The token has probably expired. Try calling [Twitter logInGuestWithCompletion:] again later.

TWTRAPIErrorCodeEndpointRetired

Corresponds to a HTTP request to a retired URL.

TWTRAPIErrorCodeApplicationCannotPerformWriteAction

Corresponds with HTTP 403 — returned when the application is restricted from POST, PUT, or DELETE actions. See How to appeal application suspension and other disciplinary actions.

TWTRAPIErrorCodeCannotMuteSelf

Corresponds with HTTP 403. The authenticated user account cannot mute itself.

TWTRAPIErrorCodeCannotMuteSpecifiedUser

Corresponds with HTTP 403. The authenticated user account is not muting the account a call is attempting to unmute.

TWTRAPIErrorCodeAlreadyRetweeted

You have already retweeted this tweet.

TWTRAPIErrorCodeTooManyRequests

Returned in API v1.1 when a request cannot be served due to the application’s rate limit having been exhausted for the resource. See Rate Limiting in API v1.1.

See Also

https://dev.twitter.com/docs/error-codes-responses

Declared In

TWTRAPIErrorCode.h.