401 Unauthorized

Understand the 401 Unauthorized error codes for the Shopper APIs.

The 401 Unauthorized error code is an HTTP response status indicating that the server has not applied the request because it lacks valid authentication credentials for the target resource. This error signifies that the server refuses to grant access due to the absence of, or failure in, authentic credentials. If you encounter this error, you should ensure that your request includes the correct credentials and that you have permission to access the requested resource.


The provided client is incorrect. Provide the correct client information and try again.


The required parameter is missing or empty. Provide the missing parameter and try again.


An invalid token for the shopper session indicates the token is no longer valid and must be refreshed to continue making API calls. This error occurs when there is a bad Dispatch token or Global Commerce User API token. To resolve this error, issue an API call to identify where the token originated and when it expired, for example:

GET /oauth20/access-tokens?token=your_access_token HTTP/1.1 Host: api.digitalriver.com

Where your_access_token is a placeholder for the actual token.

The response shows you where the token originated in the domain field and when it expired in the expiresIn field. The possible error descriptions are as follows:

  • Invalid token for specified shopper

    The provided token is invalid for the specified shopper.

  • Session expired–The shopper session is expired. Try refreshing the token.

  • Request Site ID does not match Token Site ID

    The value of the Header siteId does not match the token's site ID.

  • Invalid Token for Shopper Session

    The provided token is invalid.

Last updated