Submitter Error Messages

If the Submitter API rejects a transaction message or encounters an error before it sends the transaction to Rx Connect, it returns an error. The following is an example of an error response.

Error Response Table

This is a non-exhaustive list of objects and properties that can be included in an error response.

Properties Notes / Values
statusFor more information, see Error Message Codes.
typehttps://problems-registry.optum.com/[type-variable] For more information on the different type variables to include in the type URL, see Error Message Codes.
titleFor more information, see Error Message Codes.
detailFor more information, see Error Message Codes.
CodeThe status number with additional numbers
instanceSubmitter endpoint

Error Message Codes

The following are the error messages that Submitter API returns depending on the issue that Submitter encountered.
Note: The value in the Type column is meant to append the following URL:
https://problems-registry.optum.com/[type]

TypeTitleDetailStatus
bad-gatewayBad GatewayThe server encountered an invalid response while acting as a gateway or proxy. Please try again later502
bad-requestBad RequestThe request is invalid or malformed400
not-implementedNot ImplementedThe server does not support the functionality required to fulfill the request.501
server-errorServer ErrorThe server encountered an unexpected error500
service-unavailableService UnavailableThe service is currently unavailable503
UnauthorizedUnauthorizedSubmitter ID is invalid or inactive401