---
title: "Dental Claim Actions API"
method: POST
path: "/py/oihub/claim/dnt/submit/v1/graphql"
tags: ["Dental Claim Actions"]
---

# Dental Claim Actions API

`POST /py/oihub/claim/dnt/submit/v1/graphql`

## Request

- Base URL: `https://sandbox-apigw.optum.com`
- URL: `https://sandbox-apigw.optum.com/py/oihub/claim/dnt/submit/v1/graphql`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/optum/apis/security-and-authorization-v3/docs/py/oihub/claim/dnt/submit/v1/graphql/post.ts> (a function with typed inputs; its response is checked against the schema)

The Dental Claim Action API facilitates dental claim submission in X12 format and returns responses in the 277CA format. It provides a flexible GraphQL endpoint to streamline end-to-end dental claim action processing. Below operation is supported: <strong>SubmitDentalClaim:</strong> Validates if the dental claim submitted is eligible for claim submission and upon validation if the claim is eligible for submission, claim will be submitted.

## Headers

- `providerTaxId` string
- `x-optum-consumer-correlation-id` string

## Request body

- object: GraphQL request with query and variables for Dental Claim Submission
  - `query` string, required: GraphQL mutation query string
  - `variables` object, required: Variables for the GraphQL query
    - `input` ClaimSubmissionInput, required: ClaimSubmissionInput
      - `x12RequestData` string: EDI837 X12 formatted claim data
      - `payerId` string: payer ID

## Response `200`

**SubmitDentalClaim**



**Success Response:**

* 000 - Dental claim submitted successfully. Refer 277CA for validation outcomes.



**Error Codes (Global Codes):**

* REQ_401 - Unauthorized: Missing/invalid/expired credentials or token

* REQ_422 - Validation failed: Request is syntactically valid but fails semantic validation

* REQ_500 - Internal server error: Unexpected error

* REQ_503 - Service unavailable: Downstream service is currently unavailable

* REQ_504 - Gateway timeout: Upstream dependency timed out

* GTW_06 - TA1 Rejection: TA1 acknowledgment indicates envelope failure

* GTW_08 - Unknown Document: Gateway does not recognize document structure

* GTW_11 - Service Failure: General processing error at the downstream service

* GTW_12 - Downstream Timeout: Payer system failed to respond within SLA

* GTW_13 - Persistence Error: Internal storage failure at the gateway

* GTW_14 - Ack Failure: Failure generating downstream 999/277 files

* GTW_15 - Config Error: Downstream environment configuration mismatch

* EDI_200 - Wrong Claim Type: Expected 837D (Dental)

* EDI_203 - Batch Not Allowed: Multiple ST-SE segments detected. Single-claim submissions only

* EDI_206 - Invalid segment: One or more segments are invalid, out of order, or not allowed

- object
  - `data` object
    - `claimSubmissionResponse` ClaimSubmissionResponse: ClaimSubmissionResponse
      - `transactionId` string: unique transactionID created by the payer for the claim submission request.
      - `x12Response277CA` string: edi x12-277 claim acknowledgement.
      - `message` string: Message describing the final outcome of the claim submission process.
      - `statusCode` string: status code for the submission process.
  - `errors` object[]: List of errors that occurred during Dental Claim Actions
    - `code` string: Error code identifying the specific error
    - `description` string: Detailed error message

## Other responses

- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/optum/apis/security-and-authorization-v3.md) - [All operations](https://skmtc.dev/optum/apis/security-and-authorization-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/optum/apis/security-and-authorization-v3/revisions/771dcdf312e4?raw)