{"openapi":"3.0.0","info":{"title":"Real Dental Claim Submission API","description":"API for RTS Payer Dental Claim Submission.","version":"1.0.0"},"servers":[{"url":"https://sandbox-apigw.optum.com","description":"Sandbox environment"}],"tags":[{"name":"Dental Claim Submission","description":"Submit an X12 837D dental claim."},{"name":"HealthCheck","description":"Verify service availability."}],"paths":{"/py/oihub/claim/dnt/submit/v1/graphql":{"post":{"tags":["Dental Claim Submission"],"summary":"Submit a dental claim","description":"Submits a single X12 837D dental claim and returns the associated X12 277CA claim acknowledgment.\n\n**SubmitDentalClaim:** Validates the submitted dental claim and, when eligible, submits it for processing.","operationId":"submitDentalClaim","parameters":[{"name":"providerTaxId","in":"header","description":"Nine-digit provider tax identification number.","required":false,"schema":{"type":"string","pattern":"^[0-9]{9}$","example":"123456789"}},{"name":"x-optum-consumer-correlation-id","in":"header","description":"Consumer-provided correlation identifier used to trace the request. In the sandbox environment, approved values beginning with `test_` may trigger predefined mock responses.","required":false,"schema":{"type":"string","example":"4d4a8964-e5fa-42dc-a37d-12345789"},"examples":{"correlationId":{"summary":"Request tracing value","value":"4d4a8964-e5fa-42dc-a37d-12345789"},"sandboxMock":{"summary":"Sandbox success mock value","value":"test_dnt-claim-submission-200_success"}}}],"requestBody":{"description":"GraphQL mutation and variables for dental claim submission.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimSubmissionGraphQLRequest"},"examples":{"SubmitDentalClaim":{"summary":"Submit Dental Claim Request","value":{"query":"mutation SubmitDentalClaim($input: ClaimSubmissionInput!) { claimSubmission(input: $input) { transactionId x12Response277CA message statusCode } }","variables":{"input":{"x12RequestData":"ISA*00*          *00*          *ZZ*DENTAL123      *ZZ*PAYER456       *260113*1430*^*00501*000000001*0*P*:~GS*HC*DENTAL123*PAYER456*20260113*1430*1*X*005010X224A2~ST*837*0001*005010X224A2~BHT*0019*00*D001*20260113*1430*CH~NM1*41*2*ABC DENTAL*****XX*1234567890~PER*IC*CONTACT*TE*5551234567~NM1*40*2*DELTA DENTAL*****46*98765~HL*1**20*1~PRV*BI*PXC*1223G0001X~NM1*85*2*ABC DENTAL*****XX*1234567890~N3*555 DENTAL DR~N4*CITY*ST*12345~REF*EI*123456789~HL*2*1*22*0~SBR*P*18*******CI~NM1*IL*1*SMITH*JANE****MI*ABC123456~N3*456 ELM ST~N4*CITY*ST*12345~DMG*D8*19800101*F~NM1*PR*2*DELTA DENTAL*****PI*98765~CLM*D001*150***11:B:1*Y*A*Y*Y~DTP*431*D8*20260110~REF*D9*REF789~HI*ABK:K0210~LX*1~SV3*AD:D0120*150**1~TOO*JP*4~DTP*472*D8*20260110~SE*23*0001~GE*1*1~IEA*1*000000001~","payerId":"88848"}}}}}}}},"responses":{"200":{"description":"Dental claim submission response. Business and EDI validation outcomes may be returned in the GraphQL response body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClaimSubmissionGraphQLResponse"},"examples":{"successfulSubmission":{"summary":"Dental Claim Submission Response","value":{"data":{"claimSubmission":{"transactionId":"8841512345678901","x12Response277CA":"ISA*00*          *00*          *ZZ*87726          *ZZ*B00099999805   *250911*1927*^*00501*000000000*0*P*:~GS....~GE*1*0~IEA*1*000000000~","message":"Claim submitted successfully. Refer to the 277CA for validation outcomes.","statusCode":"000"}},"errors":[]}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"422":{"$ref":"#/components/responses/ValidationError"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"},"504":{"$ref":"#/components/responses/GatewayTimeout"}},"security":[{"bearerAuth":[]}]}},"/py/oihub/claim/dnt/submit/v1/health-check":{"get":{"tags":["HealthCheck"],"summary":"Check service health","description":"Returns the current health status of the service.","operationId":"healthCheck","responses":{"200":{"description":"Service is healthy"},"500":{"description":"Service is unhealthy"}},"security":[{"bearerAuth":[]}]}}},"components":{"schemas":{"ClaimSubmissionGraphQLRequest":{"type":"object","description":"GraphQL request containing the dental claim submission mutation and variables.","required":["query","variables"],"properties":{"query":{"type":"string","description":"GraphQL mutation query string.","example":"mutation SubmitDentalClaim($input: ClaimSubmissionInput!) { claimSubmission(input: $input) { transactionId x12Response277CA message statusCode } }"},"variables":{"$ref":"#/components/schemas/ClaimSubmissionVariables"}}},"ClaimSubmissionVariables":{"type":"object","description":"Variables supplied to the dental claim submission mutation.","required":["input"],"properties":{"input":{"$ref":"#/components/schemas/ClaimSubmissionInput"}}},"ClaimSubmissionInput":{"type":"object","description":"Input data required to submit a dental claim.","required":["x12RequestData","payerId"],"properties":{"x12RequestData":{"type":"string","description":"X12 837D dental claim data using the 005010X224A2 implementation guide.","example":"ISA*00*          *00*          *ZZ*DENTAL123      *ZZ*PAYER456       *260113*1430*^*00501*000000001*0*P*:~GS*HC*DENTAL123*PAYER456*20260113*1430*1*X*005010X224A2~ST*837*0001*005010X224A2~...~SE*23*0001~GE*1*1~IEA*1*000000001~"},"payerId":{"type":"string","description":"Identifier of the payer receiving the dental claim.","example":"88848"}}},"ClaimSubmissionGraphQLResponse":{"type":"object","description":"GraphQL response for dental claim submission.","properties":{"data":{"type":"object","nullable":true,"properties":{"claimSubmission":{"$ref":"#/components/schemas/ClaimSubmissionResponse"}}},"errors":{"type":"array","description":"GraphQL errors returned while processing the dental claim submission.","items":{"$ref":"#/components/schemas/GraphQLError"}}}},"ClaimSubmissionResponse":{"type":"object","description":"Dental claim submission result.","required":["transactionId","x12Response277CA","message","statusCode"],"properties":{"transactionId":{"type":"string","description":"Unique transaction ID assigned to the dental claim submission.","example":"8841512345678901"},"x12Response277CA":{"type":"string","description":"X12 277CA claim acknowledgment returned for the submitted dental claim.","example":"ISA*00*          *00*          *ZZ*87726          *ZZ*B00099999805   *250911*1927*^*00501*000000000*0*P*:~GS....~GE*1*0~IEA*1*000000000~"},"message":{"type":"string","description":"Message describing the outcome of the dental claim submission.","example":"Claim submitted successfully. Refer to the 277CA for validation outcomes."},"statusCode":{"type":"string","description":"Status code returned for the dental claim submission.","example":"000"}}},"GraphQLError":{"type":"object","description":"Error returned in a GraphQL response.","required":["message"],"properties":{"code":{"type":"string","description":"Code identifying the error.","example":"EDI_206"},"message":{"type":"string","description":"Description of the error.","example":"One or more X12 segments are invalid, out of order, or not allowed."}}},"ErrorResponse":{"type":"object","description":"HTTP error response.","required":["statusCode","message"],"properties":{"statusCode":{"type":"integer","format":"int32","description":"HTTP status code.","example":401},"code":{"type":"string","description":"Application-specific error code.","example":"REQ_401"},"message":{"type":"string","description":"Description of the error.","example":"Unauthorized"}}}},"responses":{"Unauthorized":{"description":"Unauthorized: credentials or access token are missing, invalid, or expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"statusCode":401,"code":"REQ_401","message":"Unauthorized"}}}},"ValidationError":{"description":"Request is syntactically valid but fails validation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"statusCode":422,"code":"REQ_422","message":"Request validation failed"}}}},"InternalServerError":{"description":"An unexpected internal server error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"statusCode":500,"code":"REQ_500","message":"Internal server error"}}}},"ServiceUnavailable":{"description":"The service or a downstream dependency is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"statusCode":503,"code":"REQ_503","message":"Service unavailable"}}}},"GatewayTimeout":{"description":"An upstream dependency did not respond within the allowed time.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"statusCode":504,"code":"REQ_504","message":"Gateway timeout"}}}}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Enter a bearer access token. The API Explorer applies the Bearer authentication scheme."}}},"security":[{"bearerAuth":[]}],"x-readme":{"explorer-enabled":true,"proxy-enabled":true}}