How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Optum Institutional Claims API

Institutional Claims

Optum Institutional Claims API is one of 166 APIs that Optum publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Institutional Claims. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, a getting-started guide, authentication docs, a changelog, and API documentation.

This API exposes 4 operations across 4 paths, and defines 71 schemas. It is described by OpenAPI 3.2.0, at version V1.

Requests are made against a single base URL, https://sandbox-apigw.optum.com.

4 operations 4 paths 71 schemas 4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
V1
Base URL
https://apigw.optum.com/medicalnetwork/
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Optum Institutional Claims API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearer-key).

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 POST. Each is listed below with its method, path, parameters, and response codes.

Institutional Claims 4

Institutional Claims

POST
/medicalnetwork/institutionalclaims/v1/validation
Claim Validation
validateClaim 3 params body → 200
POST
/medicalnetwork/institutionalclaims/v1/submission
Claim Submission
processClaim 2 params body → 200
POST
/medicalnetwork/institutionalclaims/v1/raw-x12-submission
Claim Submission x12
processClaim_1 2 params body → 200
POST
/medicalnetwork/institutionalclaims/v1/raw-x12-validation
Claim Validation x12
validateRawX12 2 params body → 200

Schemas 71

The contract defines 71 schemas that model the data the API accepts and returns. The most detailed are ClaimInformation (40 properties), ServiceLine (25 properties), OtherSubscriberInformation (23 properties), MedicareInpatientAdjudication (19 properties). Each schema is shown below with its type and property counts.

ServiceLine
object
Loop: 2400, 2410, 2420A, 2420C, 2420D and 2430
25 properties 2 required
MedicareInpatientAdjudication
object
Loop: 2320, Segment: MIA, Notes: Medical inpatient claim information
19 properties 1 required
ServiceFacilityLocation
object
Loop: 2310E
5 properties 2 required
Receiver
object
Loop: 1000B
2 properties 1 required
ClaimDateInformation
object
5 properties 2 required
PatientReasonForVisit
object
2 properties 2 required
LineAdjudicationInformation
object
12 properties 5 required
InstitutionalService
object
Loop: 2400, Segment: SV2
9 properties 4 required
LineAdjustmentInformation
object
Loop 2430, Segment: CAS
11 properties 7 required
ClaimPricingInformation
object
Loop 2400, Segment: HCP
15 properties 2 required
ExternalCauseOfInjury
object
3 properties 2 required
ClaimInformation
object
Loop: 2000B, 2000C and 2300
40 properties 11 required
OtherProcedureInformation
object
3 properties 2 required
AdmittingDiagnosis
object
2 properties 2 required
Address
object
N3 and N4
7 properties 2 required
ConditionInformation
object
1 property 1 required
OtherPayerOperatingPhysician
object
REF
1 property 1 required
MedicareOutpatientAdjudication
object
Loop: 2320, Segment: MOA, Notes: Medical outpatient claim information
5 properties
ContactInformation
object
PER
5 properties 1 required
DiagnosisRelatedGroupInformation
object
1 property 1 required
ClaimCodeInformation
object
3 properties 2 required
ServiceLineReferenceInformation
object
Loop 2400, Segment: REF
3 properties
RawX12Request
object
1 property
Submitter
object
Loop: 1000A
3 properties 2 required
Response
object
11 properties
Error
object
Error
6 properties
Subscriber
object
Loop: 2000B, used in 2000C when dependent not present
13 properties 3 required
OccurrenceSpanInformation
object
3 properties 3 required
EpsdtReferral
object
2 properties 2 required
Dependent
object
Loop: 2000B and 2000C
9 properties 5 required
Payer
object
2 properties
ClaimAdjustment
object
2 properties 1 required
ClaimNotes
object
Loop 2300; Segment: NTE
15 properties
PrincipalProcedureInformation
object
HI
3 properties 2 required
OccurrenceInformation
object
2 properties 2 required
referring
object
Loop: 2310F
17 properties 1 required
billing
object
Loop: 2000A
17 properties 1 required
PayToAddressName
object
Loop: 2010AB Billing Provider Pay To Address Name
2 properties
ClaimContractInformation
object
6 properties 4 required
ServiceLineSupplementalInformation
object
Loop: 2400, Segment: PWK
3 properties 2 required
OperatingPhysician
object
Loop: 2420A, Segment: REF
8 properties 1 required
ServiceLineDateInformation
object
Loop: 2400, Segment: DTP
4 properties
OtherPayerBillingProvider
object
Loop: 2330I, Notes: Information regarding other payer billing provider
1 property 1 required
ServiceLineProvider
object
NM1 and REF
18 properties 1 required
rendering
object
Loop: 2310D
17 properties 1 required
ClaimSupplementalInformation
object
Loop: 2400, Segment: PWK
13 properties
Failure
object
2 properties
ReferenceIdentification
object
2 properties 2 required
OtherPayerOtherOperatingPhysician
object
REF
1 property 1 required
OtherDiagnosisInformation
object
3 properties 2 required
InstitutionalClaimsRequest
object
InstitutionalClaimsRequest
19 properties 6 required
LinePricingInformation
object
Loop 2400, Segment: HCP
14 properties 2 required
PayToPlanName
object
Loop: 2010AC
8 properties 1 required
EditResponse
object
13 properties
OtherPayerServiceFacilityLocation
object
Loop: 2330F, Notes: Information regarding other payer service facility location
1 property 1 required
OtherPayerRenderingProvider
object
REF
1 property 1 required
OtherPayerName
object
Loop: 2330B, Notes: Information regarding other payer
11 properties 3 required
OtherSubscriberName
object
Loop: 2330A, Notes: Information regarding other subscriber
10 properties 4 required
ClaimAdjustmentDetails
object
Loop: 2420, Segment: CAS
3 properties 2 required
otherOperatingPhysician
object
LOOP: 2310C
8 properties 1 required
ResponseMeta
object
meta data about the request
5 properties
OtherSubscriberInformation
object
Loop: 2320
23 properties 7 required
OtherPayerAttendingProvider
object
Loop: 2330C, Notes: Information regarding other attending provider
1 property 1 required
OtherPayerReferringProvider
object
REF
1 property 1 required
operatingPhysician
object
Loop 2310B
8 properties 1 required
ReportInformation
object
Loop: 2300, 2400; Segment: PWK
3 properties 3 required
ClaimReference
object
ClaimReference
8 properties
DrugIdentification
object
Loop 2410, Segment: LIN
5 properties 3 required
attending
object
Loop: 2310A
17 properties 1 required
ValueInformation
object
2 properties 2 required
PrincipalDiagnosis
object
HI
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

optum-institutional-claims-api-openapi.yml Raw ↑

Other APIs Optum publishes across the network.

Optum Real (Medical) API
Optum Interoperability APIs (CMS Patient Access)
Optum Ambulance Fee Schedule APIs API
Optum Anesthesia Fee APIs API
Optum APC Calculator APIs API
Optum APC Cross Codes APIs API
Optum Apip API
Optum Application.wadl API
Optum Attachment API
Optum Attachment Document API
Optum Attachment Status API
Optum Attachment Submission API
Where this information came from

This is an independent, third-party profile of Optum Institutional Claims API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.