Troubleshoot

Navigate through our API troubleshooting information to efficiently address and resolve issues you encounter.

Quick Triage: Find Your Solution 

Use this table as a first-stop navigation aid. It points to likely starting resources, not definitive root causes.

SymptomStart HereNext Check
504 Gateway TimeoutTroubleshoot Request TimeoutsTimeouts and Limits, Code Profiler
429 Too Many RequestsThrottle RatesError Response Codes
401/403 authorization errorsAuthorizationAuthorization Scopes, SLAS
400 request validation errorsError Response CodesCommerce API references
500/internal errorsSCAPI Logs and Request TrackingCode Profiler
Unexpected response behaviorResponse HandlingCommerce API references

Troubleshooting Resources 

The B2C Commerce APIs provide capabilities to help you:

Step-by-Step Troubleshooting Process 

When you encounter an API issue, follow these steps:

1. Identify the Request 

Every SCAPI response includes a correlationID header. Use this to track and investigate request details.

2. Check the Response 

  • Review the HTTP status code and response body
  • Look for error messages and error details in the response
  • See Error Response Codes for common status codes

3. Review Logs 

Use Log Center in Business Manager to:

4. Monitor Performance 

If performance is an issue:

  • Use Code Profiler to identify bottlenecks
  • Check Reports & Dashboards for average response times
  • Review cache hit rates and optimization opportunities

5. Verify Configuration 

  • Confirm authentication and authorization setup
  • Check site preferences and locale settings
  • Verify custom code and hooks aren’t causing issues

6. Test and Validate 

  • Reproduce the issue in a test environment
  • Isolate the problem by simplifying the request
  • Use Postman or API testing tools to verify API behavior