Use the Professional Claims V3 API

The Professional Claims APIs are designed for medical providers to submit insurance claims to payers.
Before submit your claims to the payer, use our Professional Claims /validation endpoint to check and validate your upcoming claim submission. Our /validation endpoint will not send your transaction to the payer. The validation does not examine the actual contents of your claim; it checks for the correct well-formed syntax of the submission and elements, such as correctly summing service line charges and verifying codes.

📘

NOTE

For more sophisticated checking of Professional claims, consider contracting for our Professional Claims Integrated Rules API, which applies intelligent rules evaluation to the actual contents of your claim, with rules tailored to the specific needs of your practice.

Many claims get rejected by either the clearinghouses, which forward medicals claims to the payer networks, or by the payers themselves, because of needless mistakes in formatting or syntax.

📘

NOTE

The JSON attributes in our APIs use snake-case, with the first letter of the attribute in lower case as in claimInformation. Our APIs are case-sensitive and your JSON request body must observe this convention.

Professional Claims endpoints and URLs

TaskEndpointDescription
Request MethodPOST
Bearer Token/apip/auth/v2/token
API endpoint/professionalclaims/v3
Validation endpoint/professionalclaims/v3/validation
Healthcheck endpoint/professionalclaims/v3/healthcheckVerifies that the operating status of our APIs is optimal and if the APIs are running and are accessible. For more information, see API Healthcheck.
Raw-X12/professionalclaims/v3/raw-x12-validation
/professionalclaims/v3/raw-x12-submission
Operation ModeReal-time, one request
ConsumesApplication/json
ProducesApplication/json
Sandbox URLhttps://sandbox-apigw.optum.com/medicalnetwork/professionalclaims/v3
Production URLhttps://apigw.optum.com/medicalnetwork/professionalclaims/v3

Professional claims elements

The Professional Claims API contains a series of JSON objects that use various important elements for completing submission of claims, including but not limited to the following:

ElementDescription
claimReferenceContains important values, such as the payerId, customerClaimNumber, claimType, and other values that mostly will be managed programmatically.
submitterProvider identification, including information, such as the organizationName.
subscriberIncludes the patient's insurance member ID and policyNumber.
dependentIf necessary, information about the insurance policy holder's dependent who received the medical services.
providersProviders involved with the medical claim.
claimInformationA key block of medical coding information that defines the actual procedures and services rendered for the medical encounter. It contains other JSON blocks including the serviceLines objects that contain the professionalService line item charges and diagnosis information. This section contains the standard charge entries that the provider(s) expect to receive for their services.

Using the Healthcheck endpoint

The /healthcheck endpoint verifies that the operating status of our APIs is optimal and the APIs are running and are accessible. Please see example in API Health Check.

Using the Validation endpoint

The /professionalclaims/v3/validation endpoint checks for the correct values of the claimReference object, which confirms that you will be sending the claim to the right place and it will not be rejected by the clearinghouse. Please see example in Use the Validation Endpoint.

✍️ In the Professional and Institutional Claims sandbox request, using value: test00005 (lower case and not uppercase), for
fieldName: patientControlNumber returns EDITS canned response.