TypeScript SDK (Beta)

1
import { CollateClient } from "@collate/sdk";
2
3
const collate = new CollateClient({
4
  apiKey: process.env.COLLATE_API_KEY,
5
  environment: process.env.COLLATE_BASE_URL ?? "https://api.sandbox.trycollate.ai",
6
});

1
import { randomUUID } from "node:crypto";
2
3
const authorization = await collate.authorizations.create({
4
  "Idempotency-Key": randomUUID(),
5
  providerNpi: "1234567893",
6
  request: {
7
    payerId: "payer_aetna",
8
    coverageState: "CA",
9
    requestType: "drug",
10
    serviceCode: { system: "hcpcs", code: "J0791" },
11
  },
12
  policy: { finalSubmission: "requires_approval" },
13
  metadata: { externalCaseId: "case_789" },
14
});
15
16
console.log(authorization.id);
17
console.log(authorization.status);
18
console.log(authorization.nextAction?.type);

1
let auth = authorization;
2
3
auth = await collate.authorizations.answers.patch(auth.id, {
4
  "If-Match": `"${auth.version}"`,
5
  answers: {
6
    item: [
7
      {
8
        linkId: "coverage.member_id",
9
        answer: [{ valueString: "W123456789" }],
10
      },
11
      {
12
        linkId: "request.diagnosis_code",
13
        answer: [{ valueString: "D57.1" }],
14
      },
15
    ],
16
  },
17
});

1
import { readFile } from "node:fs/promises";
2
3
const created = await collate.files.create({
4
  fileName: "clinical-note.pdf",
5
  contentType: "application/pdf",
6
  purpose: "authorization_attachment",
7
});
8
9
const bytes = await readFile("clinical-note.pdf");
10
const upload = await fetch(created.upload.url, {
11
  method: created.upload.method,
12
  headers: created.upload.headers,
13
  body: bytes,
14
});
15
16
if (!upload.ok) {
17
  throw new Error(`Upload failed: ${upload.status}`);
18
}
19
20
const file = await collate.files.complete(created.file.id);
21
22
auth = await collate.authorizations.attachments.create(auth.id, {
23
  "If-Match": `"${auth.version}"`,
24
  fileId: file.id,
25
  documentTypes: ["clinical_notes"],
26
});

1
const confirmBody =
2
  auth.nextAction?.type === "approve_submission"
3
    ? { acceptedReviewSnapshotId: auth.submission.reviewSnapshot?.id }
4
    : null;
5
6
auth = await collate.authorizations.confirm(auth.id, {
7
  "If-Match": `"${auth.version}"`,
8
  body: confirmBody,
9
});

1
const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms));
2
3
while (auth.status === "processing" || auth.status === "waiting_on_payer") {
4
  await sleep(auth.status === "processing" ? 5_000 : 30_000);
5
  auth = await collate.authorizations.retrieve(auth.id);
6
}

1
import { CollateClient, CollateError } from "@collate/sdk";
2
3
try {
4
  const auth = await collate.authorizations.retrieve("auth_123");
5
  console.log(auth.status);
6
} catch (error) {
7
  if (error instanceof CollateError) {
8
    console.error(error.statusCode);
9
    console.error(error.body);
10
  }
11
  throw error;
12
}

1
// app/api/authorizations/route.ts
2
import { CollateClient } from "@collate/sdk";
3
import { NextResponse } from "next/server";
4
5
const collate = new CollateClient({
6
  apiKey: process.env.COLLATE_API_KEY,
7
  environment: process.env.COLLATE_BASE_URL ?? "https://api.sandbox.trycollate.ai",
8
});
9
10
export async function POST(request: Request) {
11
  const body = await request.json();
12
13
  const authorization = await collate.authorizations.create({
14
    "Idempotency-Key": body.externalCaseId,
15
    providerNpi: body.providerNpi,
16
    request: body.request,
17
    policy: { finalSubmission: "requires_approval" },
18
    metadata: { externalCaseId: body.externalCaseId },
19
  });
20
21
  return NextResponse.json({ id: authorization.id, status: authorization.status });
22
}