Skip to main content

  • API License Agreement Update: We have made significant enhancements to our API License Agreement, including detailed data protection measures and compliance with international regulations. Important restrictions have been applied to the use of Restricted APIs and AI content. Developers must review the updated agreement to ensure compliance.
  • Important Update: eBay's API integrations will be modified to address data handling requirements for select developers. Usernames will be replaced with immutable user IDs, and financial data will be protected for certain users. Learn more here.

Help with User Tokens

My OAuth token expired

First, verify that you are using the correct type of token:

  • REST API calls that only do searches (e.g., the Browse API) can use an Application access token.
  • REST API calls that get a user’s personal data must use a User access token.

User tokens typically expire within two hours. Therefore, if you’re using a tool like the eBay API Explorer, Postman, or SOAPui to test your requests and you’re pasting in a user token, please keep in mind that you’ll need to get a new user token every 2 hours or so.

To update a user token without signing into eBay every time, configure a refresh token, and then use it to get new user access tokens programmatically.

For details on managing OAuth tokens, see: