Difference between revisions of "Error Codes"

From Updox API
Jump to: navigation, search
(Notification error codes)
 
(12 intermediate revisions by 2 users not shown)
Line 2: Line 2:
  
 
== General error codes ==  
 
== General error codes ==  
{{Relevant Response Codes Table Header}}
+
{{Error Code Table Header}}
 
{{Response Code Table Row|4000}}
 
{{Response Code Table Row|4000}}
 +
{{Response Code Table Row|4010}}
 +
{{Response Code Table Row|4011}}
 +
{{Response Code Table Row|4012}}
 +
{{Response Code Table Row|4013}}
 +
{{Response Code Table Row|4014}}
 +
{{Response Code Table Row|4020}}
 +
{{Response Code Table Row|4060}}
 +
{{Response Code Table Row|4070}}
 +
{{Response Code Table Row|4071}}
 +
{{Response Code Table Row|4072}}
 +
{{Response Code Table Row|4073}}
 +
{{Response Code Table Row|4074}}
 +
{{Response Code Table Row|4075}}
 +
{{Response Code Table Row|4076}}
 +
{{Response Code Table Row|4077}}
 +
{{Response Code Table Row|4080}}
 
|}
 
|}
  
 +
== Practice error codes ==
 
{{Error Code Table Header}}
 
{{Error Code Table Header}}
{{Response Code 4000}}
+
{{Response Code Table Row|4110}}
{{Response Code 4010}}
+
{{Response Code Table Row|4130}}
{{Response Code 4011}}
+
{{Response Code Table Row|4131}}
{{Response Code 4012}}
+
{{Response Code Table Row|4132}}
{{Response Code 4013}}
+
{{Response Code Table Row|4140}}
{{Response Code 4060}}
+
{{Response Code Table Row|4150}}
{{Response Code 4070}}
+
|}
{{Response Code 4071}}
+
 
 +
== User error codes ==
 +
{{Error Code Table Header}} 
 +
{{Response Code Table Row|4210}}
 +
{{Response Code Table Row|4230}}
 +
{{Response Code Table Row|4231}}
 +
{{Response Code Table Row|4232}}
 +
{{Response Code Table Row|4233}}
 +
{{Response Code Table Row|4240}}
 +
{{Response Code Table Row|4250}}
 
|}
 
|}
  
== Practice error codes ==
 
: 4110: no practice ID 
 
: 4130: account already exists 
 
: 4131: account does not exist 
 
: 4140: web address is already taken 
 
 
 
== User error codes == 
 
: 4210: no user ID 
 
: 4230: user already exists 
 
: 4231: user does not exist 
 
: 4240: user does not exist; use PracticeUpdate instead 
 
: 4250: user dob invalid 
 
 
 
 
== Contact error codes ==
 
== Contact error codes ==
: 4330: contact already exists  
+
{{Error Code Table Header}}  
: 4331: contact does not exist 
+
{{Response Code Table Row|4330}}
 +
{{Response Code Table Row|4331}}
 +
|}
 
    
 
    
 
== Message error codes ==
 
== Message error codes ==
: 4410: message not found 
+
{{Error Code Table Header}}
: 4420: no actions found 
+
{{Response Code Table Row|4410}}
 +
{{Response Code Table Row|4420}}
 +
{{Response Code Table Row|4430}}
 +
|}
 
   
 
   
 
== Direct address error codes ==
 
== Direct address error codes ==
: 4610: direct address error: direct address is taken 
+
{{Error Code Table Header}}
: 4620: direct address error: domain does not match the direct domain for this account 
+
{{Response Code Table Row|4610}}
: 4630: direct address error: account does not have a direct domain configured 
+
{{Response Code Table Row|4620}}
: 4640: direct address error: invalid direct address 
+
{{Response Code Table Row|4621}}
: 4641: direct address error: no direct address found for this user 
+
{{Response Code Table Row|4630}}
: 4651: direct error: send failed and/or invalid direct address 
+
{{Response Code Table Row|4640}}
: 4652: direct error: either from or patientDemographics is required 
+
{{Response Code Table Row|4641}}
 +
{{Response Code Table Row|4642}}
 +
{{Response Code Table Row|4643}}
 +
{{Response Code Table Row|4650}}
 +
{{Response Code Table Row|4651}}
 +
{{Response Code Table Row|4652}}
 +
|}
 
    
 
    
 
== Patient error codes ==
 
== Patient error codes ==
: 4730: patient account already exists 
+
{{Error Code Table Header}}
: 4731: patient account does not exist 
+
{{Response Code Table Row|4730}}
 +
{{Response Code Table Row|4731}}
 +
|}
 
    
 
    
 
== Portal error codes ==
 
== Portal error codes ==
: 4830: portal account already exists 
+
{{Error Code Table Header}}
: 4831: portal account does not exist
+
{{Response Code Table Row|4830}}
 +
{{Response Code Table Row|4831}}
 +
|}
 +
 
 +
== Notification error codes ==
 +
{{Error Code Table Header}}
 +
{{Response Code Table Row|5010}}
 +
{{Response Code Table Row|5011}}
 +
{{Response Code Table Row|5012}}
 +
|}

Latest revision as of 15:46, 11 December 2015

The response codes returned by the Updox API are either 2000s, 4000s, or 5000s. Codes in the 2000s represent a successful response, codes in the 4000s represent a client error, and codes in the 5000s represent a server error. This page outlines all of the 4000, client error, response codes currently in use.

Contents

General error codes

Code Message
4000 Bad Request
4010 Unauthorized
4011 Unauthorized [Practice does not exist or is inactive]
4012 Unauthorized [User does not exist or is inactive]
4013 No token found
4014 Unauthorized
4020 Bad Request: Request likely too large
4060 [This code is for a validation error in the request. For example not including a required field, an invalid e-mail address, too long of a value, etc. A list of the errors is included in the message.]
4070 Invalid recipient
4071 Recipient not found
4072 Invalid recipient type, requires PATIENT
4073 Invalid recipient type, requires CONTACT
4074 Invalid recipient type, requires PORTAL
4075 Invalid recipient type, requires DIRECT
4076 Invalid recipient type, requires EMAIL
4077 Invalid recipient type, requires FAX
4080 Recipient unable to receive messages

Practice error codes

Code Message
4110 no practice ID
4130 account already exists
4131 account does not exist
4132 account already has an accountId
4140 web address is already taken
4150 direct domain is already taken

User error codes

Code Message
4210 no user ID
4230 user already exists
4231 user does not exist
4232 user password is required
4233 user password is invalid. Password length must be between 8 and 30 characters, contain at least one upper case AND lower case character, and must contain one number OR special character.
4240 user does not exist; use PracticeUpdate instead
4250 user dob invalid

Contact error codes

Code Message
4330 contact already exists
4331 contact does not exist

Message error codes

Code Message
4410 message not found
4420 no actions found
4430 message type does not have any MDNs

Direct address error codes

Code Message
4610 direct address error: direct address is taken
4620 direct address error: domain does not match the direct domain for this account
4621 direct address error: domain does not match the direct domain for this vendor
4630 direct address error: account does not have a direct domain configured
4640 direct address error: invalid direct address
4641 direct address error: no direct address found for sending user
4642 direct address error: identity verification required to send to this address
4643 direct address error: RA/CA information required to provision this address
4650 direct error: send failed
4651 direct error: send failed and/or invalid direct address
4652 direct error: either from or patientDemographics is required

Patient error codes

Code Message
4730 patient account already exists
4731 patient account does not exist

Portal error codes

Code Message
4830 portal account already exists
4831 portal account does not exist

Notification error codes

Code Message
5010 at least one notification must be provided
5011 the maximum number of notifications per request has been exceeded
5012 at least one id must be specified for the get request