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