Skip to main content

Common Errors

This page documents common errors and troubleshooting guidance for the US Core Bulk Data Export API v1.

Authentication Errors​

401 Unauthorized​

  • Cause: Missing or invalid authentication token
  • Solution: Ensure valid OAuth 2.0 token is included in Authorization header

403 Forbidden​

  • Cause: Valid token but insufficient permissions
  • Solution: Verify token has required scopes for bulk data access

Export Request Errors​

404 Not Found​

  • Cause: Group resource does not exist or is not accessible
  • Solution: Verify Group ID and ensure resource exists in the system

400 Bad Request​

  • Cause: Invalid parameters in export request
  • Solution: Check parameter format and supported values in CapabilityStatement

Export Status Errors​

404 Not Found​

  • Cause: Export status URL not found or expired
  • Solution: Verify status URL from Content-Location header

410 Gone​

  • Cause: Export job has expired
  • Solution: Re-initiate export request

File Download Errors​

404 Not Found​

  • Cause: File not available or has expired
  • Solution: Download files promptly after export completion

403 Forbidden​

  • Cause: Access denied to file
  • Solution: Use same authorization token that initiated the export

Server Errors​

500 Internal Server Error​

  • Cause: Unexpected server error during export processing
  • Solution: Contact Netsmart support for assistance

501 Not Implemented​

  • Cause: Operation not supported
  • Solution: Verify operation support in CapabilityStatement