CMS-1500 PDF: Business Identifier

Retrieve a Stedi generatedCMS-1500 Claim Form PDF for a submitted 837P (professional) claim by business identifier

GET /export/pdf

This endpoint uses a business identifier to retrieve autogenerated CMS-1500 Claim Form PDFs for submitted 837P professional claims.

1. Call this endpoint with the businessId query parameter set to the claim's correlation ID. The correlation ID is returned as the claimReference.correlationId in the synchronous response Stedi returns when you submit a professional claim.
2. The endpoint returns an array of PDFs for all claims with the specified businessId value. PDFs are returned as a base64 encoded string.

To view a PDF, decode the base64 string and save it to a file with a .pdf extension.

If you plan to send these PDFs to payers or retain them for your records, we strongly recommend visiting CMS-1500 Claim Form PDF for information about how to structure claim submissions for optimal generation, the correct printer settings for generated PDFs, and general best practices.

Authorizations

Authorization · string · required · header

A Stedi API Key for authentication.

Query Parameters

businessId · string

The business identifier for the claim PDF you want to retrieve. This value is returned as the claimReference.correlationId in the synchronous response Stedi returns when you submit a professional claim.

background · boolean

If false, the generated PDF will only contain the form data on a white background, suitable for printing on pre-printed forms. The default is true.

Response

application/json

ExportPDF 200 response

errors · array<object>

Errors that prevented Stedi from returning one or more PDFs for the specified businessId. This array may be empty if there were no errors.

errors[]. error · string

A message indicating the type of error that occurred.

errors[]. transactionId · string

A unique identifier for the claim with one or more PDF errors.

pdfs · array<object>

Data for PDF files Stedi generated for the specified businessId. This array may be empty if there are no PDFs available for the specified businessId. It may also contain multiple PDFs if there is more than one claim with the same businessId value.

pdfs[]. data · string

A base64 encoded string of the CMS-1500 Claim Form PDF. To render the PDF, you must decode the base64 string and save it to a file with a .pdf extension.

pdfs[]. transactionId · string

A unique identifier for the processed claim associated with the specified businessId.

This ID is included in the transaction processed event for each claim, which you can receive automatically through Stedi webhooks. You can also retrieve this ID through the Poll Transactions endpoint or from the transaction's details page within Stedi.

cURL

curl --request GET \
  --url "https://healthcare.us.stedi.com/2024-04-01/export/pdf?businessId=a10b1111-7233-484c-8dee-b240c590c767" \
  --header "Authorization: <api_key>"

JavaScript

fetch("https://healthcare.us.stedi.com/2024-04-01/export/pdf?businessId=a10b1111-7233-484c-8dee-b240c590c767", {
  headers: {
    "Authorization": "<api_key>"
  }
})

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://healthcare.us.stedi.com/2024-04-01/export/pdf?businessId=a10b1111-7233-484c-8dee-b240c590c767"

  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("Authorization", "<api_key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}

Python

import requests

url = "https://healthcare.us.stedi.com/2024-04-01/export/pdf?businessId=a10b1111-7233-484c-8dee-b240c590c767"

response = requests.request("GET", url, headers = {
  "Authorization": "<api_key>"
})

print(response.text)

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;

HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://healthcare.us.stedi.com/2024-04-01/export/pdf?businessId=a10b1111-7233-484c-8dee-b240c590c767"))
  .header("Authorization", "<api_key>")
  .GET()
  .build();

try {
  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
  System.out.println("Status code: " + response.statusCode());
  System.out.println("Response body: " + response.body());
} catch (Exception e) {
  e.printStackTrace();
}

200

{
  "errors": [
    {
      "error": "No artifacts found for transaction",
      "transactionId": "a10b3344-7288-484j-8dbb-b240c123c767"
    }
  ],
  "pdfs": [
    {
      "data": "JVBERi0xLjcKJYGBgYEKCjcgMCBvYmoKPDwKL0ZpbHRlciAvRmxhdGVEZWNvZGUKL0xlbmd0aCAxMAo ...",
      "transactionId": "a10b1111-7233-484c-8dee-b240c590c767"
    }
  ]
}

400

{
  "code": "string",
  "details": "string",
  "message": "string"
}

403

{
  "code": "string",
  "details": "string",
  "message": "string"
}

404

{
  "code": "string",
  "details": "string",
  "message": "string"
}

429

{
  "code": "string",
  "message": "string"
}

500

{
  "code": "string",
  "message": "string"
}

503

{
  "code": "string",
  "message": "string"
}

504

{
  "code": "string",
  "message": "string"
}