Knowledge Center > Developer Platform > API > SOAP API > Error Handling > Faults



A fault is a fatal, call-level error. Faults differ from errors, which cause only part of a call to fail. When a fault occurs, the call fails completely and nothing is processed. Examples of faults include an incorrect ZOQL statement, an invalid authentication, and a server error.

Fault elements

When a fault occurs, the call fails entirely, nothing is processed, and a fault is returned.

Fault Description
ApiFault The base fault. This fault has a fault code (FaultCode) and a fault message (FaultMessage). The FaultCode points to the appropriate ErrorCode. If you make a call that results in a fault, then the call returns an exception with the ErrorCode, which tells you what happened. The FaultMessage is a string that provides details about the fault.
InvalidQueryLocatorFault The query locator expired or was otherwise invalid.
InvalidTypeFault An invalid type, unknown type, or a type not supported in the API version was specified.
InvalidValueFault An invalid value was specified.
LoginFault The specified login credentials were invalid. Log in again.
MalformedQueryFault The query string used an invalid format or syntax, or the string exceeds the maximum length of a query statement. The maximum length of a query string in 10,000 characters.
UnexpectedErrorFault There was an unexpected problem with the call. No further details are available.

Restricted Access Message

If your tenant has specified allowable IP address ranges for Zuora, the following fault response is returned when a call is sent from an IP address outside the specified range. Contact your tenant administrator for assistance. 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
      <soapenv:Fault xmlns:fns="http://fault.api.zuora.com/">
         <faultstring>Your IP address may be restricted. Please contact the administrator at your company for help.</faultstring>
               <fns:FaultMessage>Your IP address may be restricted. Please contact the administrator at your company for help.</fns:FaultMessage>

Last modified



(not set)