DisputeNinja uses standard HTTP response codes to indicate API request status:
  • 2xx: Success
  • 4xx: Client/input error (e.g., missing parameters)
  • 5xx: Server error (rare)
Some 4xx errors include an error code for programmatic handling.

Error Response Structure

All error responses contain:
type
string
Error type: api_error or invalid_request_error
code
string
Short error code for programmatic handling
message
string
Human-readable error description
param
string
Parameter causing the error, if applicable

Error Types

  • api_error: DisputeNinja server issue (rare)
  • invalid_request_error: Invalid parameters or request