Session Status

GET /api/v1/partner/sessions/{sessionId}

Poll this endpoint to track where a session is in the billing pipeline. Use the sessionId returned from Submit a Session.

Request

const response = await fetch(
  "https://api.usetaiga.com/api/v1/partner/sessions/SESSION_ID",
  {
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
    },
  }
);

const data = await response.json();

import requests

response = requests.get(
    "https://api.usetaiga.com/api/v1/partner/sessions/SESSION_ID",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

data = response.json()

curl https://api.usetaiga.com/api/v1/partner/sessions/SESSION_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Processing

{
  "sessionId": "uuid",
  "status": "processing",
  "message": "Session is being processed.",
  "patientName": "Sarah Johnson",
  "dateOfService": "2026-04-01",
  "createdAt": "2026-04-01T18:30:00.000Z",
  "updatedAt": "2026-04-01T18:31:00.000Z"
}

Once the claim has been submitted, the response includes additional claim and event details:

Paid

{
  "sessionId": "uuid",
  "status": "paid",
  "message": "Payment received from payer.",
  "patientName": "Sarah Johnson",
  "dateOfService": "2026-04-01",
  "claim": {
    "submittedAt": "2026-04-01T19:00:00.000Z",
    "lastUpdated": "2026-04-15T12:00:00.000Z"
  },
  "events": [
    { "type": "835_paid", "timestamp": "2026-04-15T12:00:00.000Z" },
    { "type": "277ca_accepted", "timestamp": "2026-04-01T19:30:00.000Z" }
  ]
}

Status values

Status	What's happening
`processing`	We're working on it — parsing, coding, review, claim preparation.
`submitted`	Claim sent to insurance payer, awaiting acknowledgment.
`accepted`	Payer accepted the claim, awaiting adjudication and payment.
`rejected`	Payer rejected the claim at intake. Our team is correcting and resubmitting.
`denied`	Payer denied the claim. Our team is reviewing for appeal.
`paid`	Payment received from payer.

Claim and event fields

These fields are included when the status is submitted, accepted, rejected, denied, or paid:

Field	Description
`claim.submittedAt`	When the claim was sent to the payer
`claim.lastUpdated`	Last status change timestamp
`events`	Array of EDI transaction events (e.g. `277ca_accepted`, `835_paid`)

Errors

Status	Cause
`401`	Invalid or missing API key
`404`	Session ID not found

See Polling for recommended polling intervals.

Request

Response

Status values

Claim and event fields

Errors

On this page