Error Codes

OPSkins Error Codes

We use a constant set of error codes throughout OPSkins, including in the v2 API. This article documents those error codes.

Error codes are separated into a few types. The first digit of each code indicates the type.

The special code 1 indicates "OK". It means that the operation completed successfully with no error.

1xxx: User Account Error

1000GENERIC_USER_ACCOUNT_ERROR

This code indicates that there was a generic error which involved a problem with your user account. Further details are unavailable.

1001NOT_ENOUGH_COINS

This code indicates that the operation failed because your account balance is insufficient (we refer to funds as "coins" internally).

1002ACCESS_DENIED

The operation failed because your account does not have necessary permissions.

1003NOT_LOGGED_IN

The operation failed because you are not authenticated.

1004LISTING_LIMIT_EXCEEDED

The operation failed because you have too many items listed under your account.

1005NO_MORE_FREE_USES

The operation failed because you tried to use a paid feature for free (e.g. you tried to feature an item using a free featured listing from a subscription purchase), but your account has no more free uses of that item.

1006INVALID_PASSWORD

The supplied password was incorrect.

1007PASSWORD_UNSET

Your account does not have a password set on it.

1008TOO_MANY_PASSWORD_ATTEMPTS

You have gotten too many passwords wrong, and you must wait.

1009UNACCEPTABLE_PASSWORD

That password does not satisfy the password requirements.

1010TWOFACTOR_INCORRECT

The supplied two-factor authentication code was not correct.

1011USERNAME_TAKEN

That username has already been taken by another account.

1012UNACCEPTABLE_USERNAME

That username does not satisfy the username requirements.

1013EMAIL_UNVERIFIED

Your account's email address has not been verified.

1014NO_MORE_FREE_USES

You requested a free usage of something (e.g. featured listing), but your account doesn't have any more free uses remaining.

1015UNACCEPTABLE_EMAIL

That email address can't be used. Try another one.

2xxx: Internal Error

2000GENERIC_INTERNAL_ERROR

The operation failed due to a problem on our end. Further details are unavailable.

2001DATABASE_ERROR

The operation failed due to a problem with our database. Please try again in a few moments.

2002NOT_FOUND

The operation failed because the requested item (be it a user, a listing, etc.) was not found.

2003BAD_STATE

The operation failed because the requested object is in a bad state. The requested operation cannot be completed while the object is in its current state.

2004NO_MATCHING_ITEMS_FOUND

Similar to NOT_FOUND, this indicates that the operation failed because we couldn't find anything matching your query.

2005BOT_UNAVAILABLE

The operation failed because a bot that is needed to complete the operation is currently unavailable, most likely due to Steam issues. Please try again in a few moments.

2006PAYMENT_GATEWAY_UNAVAILABLE

The operation failed because a required payment gateway is not available.

2007CANNOT_CREATE_DIRECTORY

We weren't able to create a directory on our end.

2008FILE_UPLOAD_ERROR

The operation failed due to an error in the file upload.

2009FILE_UPLOAD_ALREADY_EXISTS

The file you are trying to upload already exists on the server.

2010CANNOT_DELETE_FILE

A requested file could not be deleted.

2011BOT_FULL

A required bot is full, and cannot accept any more items.

2012ALREADY_IN_THAT_STATE

You are trying to change the state of an object, but the object is already in the desired state.

2013LOCKED

The requested object is locked and cannot be changed.

2014PRICE_HAS_CHANGED

The price on the requested object has changed.

2015ENCRYPTION_KEY_INVALID

The encryption key you tried to use is not valid.

2016DISABLED

The requested endpoint or system is currently disabled.

2017MALFORMED_RESPONSE

A response we received from somewhere (probably Steam) was not well-formed.

3xxx: User Error

3000BAD_INPUT

The input to your request was malformed or otherwise bad.

3001UNACCEPTABLE_ITEM

When listing an item: we cannot accept that item for sale at this time. When editing an existing item: the requested operation cannot apply to that item.

3002DUPLICATE_ITEM

You're trying to list an item that is already on sale

You tried to list the same item in the same request twice

You tried to list two patterned CS:GO items with identical names and differing prices in the same trade

3003UNACCEPTABLE_PRICE

You can't list that item for that price.

3004DIFFERENT_BOTS_NOT_ALLOWED

You can't make this request for items on different bots (all items in the request must reside on the same bot)

3005BAD_REQUEST

Your request was missing some data, or it was otherwise bad.

3006TOO_MANY_REDEMPTIONS

This object has been redeemed too many times.

3007CAPTCHA_INVALID

Your CAPTCHA solution was incorrect, or you need to supply a CAPTCHA solution to complete this action.

3008RATE_LIMIT_EXCEEDED

You have been doing that action too frequently, and you must wait.

4xxx: Third Party Error

4000STEAM_UNAVAILABLE

Steam is currently not available. Please try again later when Steam is working.

4001STEAM_LIMIT

We've run into a Steam limitation (e.g. maximum number of trade offers, maximum number of items).

4002STEAM_UNAVAILABLE_CACHED

Steam is currently not available (we didn't actually check this time, but it failed recently so we're delaying requests so we don't slam Steam). Please try again later when Steam is working.

4003THIRD_PARTY_UNAVAILABLE

A third-party service is currently not available.

Trade Offer Status Codes

Where a trade offer ID is expected, these codes may be provided instead.

-1 A trade offer has not yet been sent, or a trade offer was sent but wasn't accepted in the allotted time and it has been canceled

-2 Either the user or the bot has too many trade offers out and cannot send any more

-3 The user cannot trade right now due to a ban or a trade cooldown (e.g. Steam Guard)

-4 A trade offer was sent but the user declined or countered it

-5 The user's trade URL is wrong or their inventory is full

-9 There was some unknown error; support will need to repair this item manually

-10 Steam reports that this item's ID does not exist anymore. If the item is in the system, support will need to repair it manually