TypeScript and Python SDKs

Stedi has official software development kits (SDKs) for TypeScript and Python. Get them from npm and PyPI.

The SDKs give you types, retries, and error handling. You only write the parts that are specific to your product.

terminal

pnpm add @stedi/sdk

Packages: +13

Progress: resolved , reused 0, downloaded , added

dependencies:

+ @stedi/sdk 0.0.10

Done in 1.4s using pnpm v10.20.0

Claims manager

Claim submission

12 days ago

Acknowledgment

9 days ago

Claim re-submission

12 days ago

Acknowledgment

12 days ago

Claim payment information

12 days ago

Typed operations

Send typed commands in TypeScript or typed input models in Python.

Built-in retries

The SDKs retry failed requests automatically. Keep the smart default or configure your own retry strategy.

Typed errors

The SDKs surface service errors as typed exceptions. Each includes the HTTP status code and a clear message.

One client for every endpoint

Use a single client that routes operations to the correct Stedi API endpoint. You only need to manage one set of credentials.

Why SDKs

Built for developers and AI coding agents

Our SDKs make it easier for developers and AI coding agents to produce reliable Stedi integrations. Each SDK package is generated from Stedi’s own internal API models. They stay in lockstep with Stedi’s REST APIs.

TypeScript SDK

With our TypeScript SDK, you can create one client that sends typed commands for every operation.

The client routes each command to the correct Stedi API endpoint. You use one client and one set of credentials for the entire SDK.

Visit the npm page for installation and quickstart instructions.

quickstart.ts

import { randomUUID } from "node:crypto";
import { readFileSync } from "node:fs";

import {
  StediClient,
  CreateProfessionalClaimSubmissionCommand,
  type CreateProfessionalClaimSubmissionCommandInput,
} from "@stedi/sdk";

const client = new StediClient({
  apiKey: { apiKey: process.env.STEDI_API_KEY! },
});

// Submit a complete CMS-1500 claim.
const claim = JSON.parse(
  readFileSync("claim.json", "utf8"),
) as CreateProfessionalClaimSubmissionCommandInput;

const response = await client.send(
  new CreateProfessionalClaimSubmissionCommand({
    ...claim,
    idempotencyKey: randomUUID(),
  }),
);

console.log(`${response.status}: ${response.claimId}`);

Python SDK

The Python client is async and acts as a context manager. To send a typed operation, just pass its input model.

The SDK automatically retries failed requests. You can configure retries, interceptors, and transport options.

Visit the PyPI page for installation and quickstart instructions.

quickstart.py

import asyncio

from stedi import Config, Stedi


async def main() -> None:
    # Submit a complete CMS-1500 claim.
    claim = load_claim()

    async with Stedi(Config(api_key="...")) as client:
        response = await client.create_professional_claim_submission(claim)

        print(f"{response.status}: {response.claim_id}")


asyncio.run(main())

Runnable examples for every operation

You’ll find runnable, end-to-end examples for every operation in the TypeScript and Python examples directories.

fixtures/test-claim.json

{
  "purpose": "CHARGEABLE",
  "payer": {
    "id": "STEDITEST",
    "name": { "organization": "Stedi Test Payer" }
  },
  "insured": {
    "memberId": "U7777788888",
    "name": { "person": { "firstName": "John", "lastName": "Anon" } }
  }
}

create-professional-claim-submission.ts

const client = new StediClient({ apiKey: { apiKey } });

const submission = await client.send(
  new CreateProfessionalClaimSubmissionCommand(await loadClaim()),
);

console.log(`claim ${submission.claimId}, submission ${submission.submissionId}`);

Get started with the Stedi SDKs

The TypeScript SDK is available on npm. The Python SDK is available on PyPI.

To use the SDKs, you must have a Stedi API key.

TypeScript and Python SDKs

Benefits of the Stedi SDKs

Typed operations

Built-in retries

Typed errors

One client for every endpoint

Built for developers and AI coding agents

TypeScript SDK

Python SDK

Runnable examples for every operation

Get started with the Stedi SDKs