Common Issues

Solutions to frequently encountered problems

Authentication failures

Verify your API key, header format, and environment variable configuration. Check for expired or rotated credentials.

Connectivity issues

Confirm network access to api.sansmercantile.com, firewall rules, and TLS certificate trust for HTTPS traffic.

Invalid payloads

Validate JSON request bodies and required fields. Use the API reference pages to confirm endpoint parameters.

Rate limiting

Monitor request volume and implement exponential backoff when you receive limit responses. Cache repeated requests to reduce usage.