Difference between revisions of "Error Codes"

From Updox API
Jump to: navigation, search
(Notification error codes)
 
(10 intermediate revisions by 2 users not shown)
Line 8: Line 8:
 
{{Response Code Table Row|4012}}
 
{{Response Code Table Row|4012}}
 
{{Response Code Table Row|4013}}
 
{{Response Code Table Row|4013}}
 +
{{Response Code Table Row|4014}}
 +
{{Response Code Table Row|4020}}
 
{{Response Code Table Row|4060}}
 
{{Response Code Table Row|4060}}
 
{{Response Code Table Row|4070}}
 
{{Response Code Table Row|4070}}
 
{{Response Code Table Row|4071}}
 
{{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 ==
 
== Practice error codes ==
Line 19: Line 27:
 
{{Response Code Table Row|4130}}
 
{{Response Code Table Row|4130}}
 
{{Response Code Table Row|4131}}
 
{{Response Code Table Row|4131}}
 +
{{Response Code Table Row|4132}}
 
{{Response Code Table Row|4140}}
 
{{Response Code Table Row|4140}}
 +
{{Response Code Table Row|4150}}
 
|}
 
|}
: 4110: no practice ID 
+
 
: 4130: account already exists 
+
: 4131: account does not exist 
+
: 4140: web address is already taken 
+
 
+
 
== User error codes ==
 
== User error codes ==
 
{{Error Code Table Header}}   
 
{{Error Code Table Header}}   
Line 31: Line 37:
 
{{Response Code Table Row|4230}}
 
{{Response Code Table Row|4230}}
 
{{Response Code Table Row|4231}}
 
{{Response Code Table Row|4231}}
 +
{{Response Code Table Row|4232}}
 +
{{Response Code Table Row|4233}}
 
{{Response Code Table Row|4240}}
 
{{Response Code Table Row|4240}}
 
{{Response Code Table Row|4250}}
 
{{Response Code Table Row|4250}}
: 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 ==
 
{{Error Code Table Header}}   
 
{{Error Code Table Header}}   
 
{{Response Code Table Row|4330}}
 
{{Response Code Table Row|4330}}
 
{{Response Code Table Row|4331}}
 
{{Response Code Table Row|4331}}
: 4330: contact already exists 
 
: 4331: contact does not exist 
 
 
|}  
 
|}  
 
    
 
    
Line 52: Line 53:
 
{{Response Code Table Row|4410}}
 
{{Response Code Table Row|4410}}
 
{{Response Code Table Row|4420}}
 
{{Response Code Table Row|4420}}
: 4410: message not found 
+
{{Response Code Table Row|4430}}
: 4420: no actions found 
+
 
|}  
 
|}  
 
   
 
   
Line 60: Line 60:
 
{{Response Code Table Row|4610}}
 
{{Response Code Table Row|4610}}
 
{{Response Code Table Row|4620}}
 
{{Response Code Table Row|4620}}
 +
{{Response Code Table Row|4621}}
 
{{Response Code Table Row|4630}}
 
{{Response Code Table Row|4630}}
 
{{Response Code Table Row|4640}}
 
{{Response Code Table Row|4640}}
 
{{Response Code Table Row|4641}}
 
{{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|4651}}
 
{{Response Code Table Row|4652}}
 
{{Response Code Table Row|4652}}
: 4610: direct address error: direct address is taken 
 
: 4620: direct address error: domain does not match the direct domain for this account 
 
: 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 this user 
 
: 4651: direct error: send failed and/or invalid direct address 
 
: 4652: direct error: either from or patientDemographics is required 
 
 
|}  
 
|}  
 
    
 
    
Line 78: Line 75:
 
{{Response Code Table Row|4730}}
 
{{Response Code Table Row|4730}}
 
{{Response Code Table Row|4731}}
 
{{Response Code Table Row|4731}}
: 4730: patient account already exists 
 
: 4731: patient account does not exist 
 
 
|}  
 
|}  
 
    
 
    
Line 86: Line 81:
 
{{Response Code Table Row|4830}}
 
{{Response Code Table Row|4830}}
 
{{Response Code Table Row|4831}}
 
{{Response Code Table Row|4831}}
: 4830: portal account already exists 
+
|}
: 4831: portal account does not exist
+
 
 +
== 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