The Transactions API from Stedi — 11 operation(s) for transactions.
components:
schemas:
AccessDeniedExceptionResponseContent:
description: The server response for authorization failure.
properties:
code:
type: string
message:
type: string
required:
- message
type: object
Artifact:
properties:
artifactType:
$ref: '#/components/schemas/ArtifactType'
model:
$ref: '#/components/schemas/ArtifactModel'
sizeBytes:
description: The size of the artifact in bytes.
type: number
url:
description: A URL to download the artifact.
type: string
usage:
$ref: '#/components/schemas/ArtifactUsage'
required:
- artifactType
- model
- sizeBytes
- url
- usage
type: object
ArtifactModel:
description: The model of the artifact, which indicates the type of process or operation it represents. For
example, an execution artifact represents a file that was processed, a fragment artifact represents a part
of a larger transaction, and a fault artifact represents an error that occurred during processing.
enum:
- execution
- fragment
- transaction
- fault
type: string
ArtifactType:
description: The format of the artifact.
enum:
- text/csv
- application/edifact
- application/filepart
- application/json
- application/pdf
- text/psv
- text/tsv
- application/edi-x12
- application/xml
- application/zip
- image/jpeg
- image/png
- image/tiff
- text/plain
- unknown
type: string
ArtifactUsage:
description: 'The type of data the artifact contains. For example, an input artifact represents the original
data Stedi received before processing, while an output artifact represents the processed data.
For example, for an inbound 835 ERA from a payer, the input artifact would be the original X12 EDI, and
the output artifact would be the JSON representation of the ERA.'
enum:
- attachment
- input
- metadata
- output
type: string
BadRequestExceptionResponseContent:
description: The server cannot process the request due to an apparent client error.
properties:
code:
type: string
message:
type: string
required:
- message
type: object
BusinessIdentifier:
properties:
element:
description: The element where the business identifier was found. For example, `BHT03` for 837 claims.
type: string
elementId:
description: The identifier of the element containing the business identifier in the EDI specification.
type: string
name:
description: The friendly name of the business identifier. For example, `Originator Application Transaction
Identifier`.
type: string
value:
description: The value of the business identifier.
type: string
required:
- element
- elementId
- name
- value
type: object
Direction:
description: The direction of the transaction. Inbound transactions are those you receive from a payer, provider,
or other trading partner. Outbound transactions are those you send to a payer, provider, or other trading
partner.
enum:
- INBOUND
- OUTBOUND
- UNKNOWN
type: string
ExceptionCause:
properties:
message:
type: string
name:
type: string
stack:
type: string
type: object
GatewayTimeoutExceptionResponseContent:
description: The server was acting as a gateway or proxy and did not receive a timely response from the upstream
server.
properties:
code:
type: string
message:
type: string
required:
- message
type: object
GetTransactionAttachmentDocumentResponseContent:
properties:
documentDownloadUrl:
description: A URL to download the document. This URL is available for 60 minutes.
type: string
type: object
GetTransactionAttachmentDocumentUrlResponseContent:
properties:
documentDownloadUrl:
description: A URL to download the document. This URL is available for 60 minutes.
type: string
type: object
GetTransactionFragmentOutputDocumentResponseContent:
properties:
documentDownloadUrl:
description: A URL to download the document. This URL is available for 60 minutes.
type: string
type: object
GetTransactionFragmentOutputDocumentUrlResponseContent:
properties:
documentDownloadUrl:
description: A URL to download the document. This URL is available for 60 minutes.
type: string
type: object
GetTransactionFragmentResponseContent:
properties:
artifacts:
description: A list of artifacts related to the transaction containing the fragment.
items:
$ref: '#/components/schemas/Artifact'
type: array
direction:
$ref: '#/components/schemas/Direction'
fileExecutionId:
description: A unique identifier for the processed file containing this fragment. This ID is included
in the file processed event. You can also retrieve it manually from the file's details page in the Stedi
portal.
type: string
fragmentIndex:
description: The identifier for the fragment within a processed transaction.
type: number
fragments:
$ref: '#/components/schemas/TransactionFragmentsSummary'
mode:
$ref: '#/components/schemas/Mode'
partnership:
$ref: '#/components/schemas/Partnership'
processedAt:
description: The date and time when Stedi processed the transaction containing the fragment, in ISO 8601
format. For example, `2023-08-28T00:00:00Z`.
format: date-time
type: string
transactionId:
description: A unique identifier for the processed transaction containing this fragment. This ID is included
in the transaction processed event. You can also retrieve it manually from the transaction's details
page within the Stedi portal.
type: string
transactionUrl:
description: The URL to review the transaction within the Stedi portal.
type: string
x12:
$ref: '#/components/schemas/X12TransactionSummary'
required:
- artifacts
- direction
- fileExecutionId
- fragmentIndex
- fragments
- mode
- partnership
- processedAt
- transactionId
- transactionUrl
type: object
GetTransactionInputDocumentResponseContent:
properties:
documentDownloadUrl:
description: A URL to download the document. This URL is available for 60 minutes.
type: string
type: object
GetTransactionInputDocumentUrlResponseContent:
properties:
documentDownloadUrl:
description: A URL to download the document. This URL is available for 60 minutes.
type: string
type: object
GetTransactionOutputDocumentResponseContent:
properties:
documentDownloadUrl:
description: A URL to download the document. This URL is available for 60 minutes.
type: string
type: object
GetTransactionOutputDocumentUrlResponseContent:
properties:
documentDownloadUrl:
description: A URL to download the document. This URL is available for 60 minutes.
type: string
type: object
GetTransactionResponseContent:
properties:
artifacts:
description: A list of artifacts related to the transaction.
items:
$ref: '#/components/schemas/Artifact'
type: array
businessIdentifiers:
description: Any business identifiers extracted from the transaction.
items:
$ref: '#/components/schemas/BusinessIdentifier'
type: array
direction:
$ref: '#/components/schemas/Direction'
fileExecutionId:
description: A unique identifier for the processed file within Stedi. This ID is included in the transaction
processed event. You can also retrieve it manually from the file's details page in the Stedi portal.
type: string
fragments:
$ref: '#/components/schemas/TransactionFragmentsSummary'
mode:
$ref: '#/components/schemas/Mode'
partnership:
$ref: '#/components/schemas/Partnership'
processedAt:
description: The date and time when Stedi processed the transaction, in ISO 8601 format. For example,
`2023-08-28T00:00:00Z`.
format: date-time
type: string
status:
$ref: '#/components/schemas/TransactionStatus'
transactionId:
description: A unique identifier for the processed transaction within Stedi. This ID is included in the
transaction processed event. You can also retrieve it manually from the transaction's details page within
the Stedi portal.
type: string
translationErrors:
description: Details about errors that prevented Stedi from processing the transaction.
items:
$ref: '#/components/schemas/TranslationError'
type: array
x12:
$ref: '#/components/schemas/X12TransactionSummary'
required:
- artifacts
- direction
- fileExecutionId
- mode
- partnership
- processedAt
- status
- transactionId
type: object
Index:
properties:
column:
description: The column number in the document where the problem occurred.
type: number
line:
description: The line number in the document where the problem occurred.
type: number
required:
- column
- line
type: object
ListTransactionsResponseContent:
description: Common output structure for list operations with pagination support.
properties:
items:
items:
$ref: '#/components/schemas/TransactionSummary'
type: array
nextPageToken:
description: Token that you can supply in subsequent requests to retrieve the next page of results. If
not returned, there are no more results.
maxLength: 1024
minLength: 1
type: string
required:
- items
type: object
Mark:
description: The location in the document where the problem occurred. May be a single index or a range.
properties:
end:
$ref: '#/components/schemas/Index'
start:
$ref: '#/components/schemas/Index'
required:
- start
type: object
Mode:
description: Indicates whether the transaction contains test or production data. Stedi determines this from
the value in [`ISA15` Usage Indicator Code](https://www.stedi.com/edi/x12/segment/ISA#ISA-15).
enum:
- test
- production
- other
type: string
Partnership:
description: 'Information about the associated partnership.
A partnership describes all aspects of the EDI relationship between two profiles in your Stedi account,
such as which transaction sets they will exchange and other important information for processing EDI files.
If you''re sending or receiving transactions through the Stedi clearinghouse, Stedi configures the necessary
partnership for you automatically when you set up your account.'
properties:
partnershipId:
description: 'The unique identifier for the partnership within the Stedi platform.
A partnership describes all aspects of the EDI relationship between two profiles in your Stedi account,
such as which transaction sets they will exchange and other important information for processing EDI
files. If you''re sending or receiving transactions through the Stedi clearinghouse, Stedi configures
the necessary partnerships for you automatically when you set up your account.'
maxLength: 81
minLength: 1
pattern: ^([a-zA-Z0-9._-]+)$
type: string
partnershipType:
$ref: '#/components/schemas/PartnershipType'
receiver:
$ref: '#/components/schemas/PartnershipReceiver'
sender:
$ref: '#/components/schemas/PartnershipSender'
required:
- partnershipId
- partnershipType
- receiver
- sender
type: object
PartnershipReceiver:
description: The entity that is receiving the transaction.
properties:
profileId:
description: A unique identifier for the profile within the Stedi platform.
maxLength: 40
minLength: 1
pattern: ^([a-zA-Z0-9._-]+)$
type: string
required:
- profileId
type: object
PartnershipSender:
description: The entity that initiated the transaction.
properties:
profileId:
description: A unique identifier for the profile within the Stedi platform.
maxLength: 40
minLength: 1
pattern: ^([a-zA-Z0-9._-]+)$
type: string
required:
- profileId
type: object
PartnershipType:
description: The type of partnership, which determines the EDI standard used for exchanging transactions.
enum:
- x12
- edifact
type: string
ResourceNotFoundExceptionResponseContent:
description: The server response when the specified resource cannot be found after an API request passes authentication
and authorization.
properties:
code:
type: string
message:
type: string
required:
- message
type: object
ResourceUnderChangeExceptionResponseContent:
properties:
message:
type: string
required:
- message
type: object
ServiceExceptionResponseContent:
properties:
exceptionCause:
$ref: '#/components/schemas/ExceptionCause'
message:
type: string
required:
- message
type: object
ServiceUnavailableExceptionResponseContent:
description: The server cannot handle the request due to technical reasons.
properties:
code:
type: string
message:
type: string
required:
- message
type: object
ThrottlingExceptionResponseContent:
description: The server response when usage plan or account-level throttling limits exceeded.
properties:
code:
type: string
message:
type: string
required:
- message
type: object
TransactionFragmentsSummary:
description: Details about fragments included in the transaction, if applicable. Fragments break large transactions
into smaller parts for easier processing and management.
properties:
batchSize:
description: The maximum size of each fragment in kilobytes (KB). Stedi uses this to automatically split
large inbound transactions into fragments.
type: number
fragmentCount:
description: The total number of fragments in the transaction.
type: number
keyName:
description: The JSON schema key name for the segment in the Stedi guide used to split the transaction
into fragments. For example, in an 834 Health Care Benefit Enrollment and Maintenance, this would be
`member_level_detail_INS_loop`.
type: string
required:
- batchSize
- fragmentCount
- keyName
type: object
TransactionStatus:
description: A status indicating whether Stedi was able to successfully process the transaction.
enum:
- failed
- succeeded
type: string
TransactionSummary:
description: The processed transactions that match the request criteria. The `items` array is empty if there
are no matching transactions.
properties:
artifacts:
description: A list of artifacts related to the transaction.
items:
$ref: '#/components/schemas/Artifact'
type: array
businessIdentifiers:
description: Any business identifiers extracted from the transaction.
items:
$ref: '#/components/schemas/BusinessIdentifier'
type: array
direction:
$ref: '#/components/schemas/Direction'
fileExecutionId:
description: A unique identifier for the processed file within Stedi. This ID is included in the transaction
processed event. You can also retrieve it manually from the file's details page in the Stedi portal.
type: string
fragments:
$ref: '#/components/schemas/TransactionFragmentsSummary'
mode:
$ref: '#/components/schemas/Mode'
partnership:
$ref: '#/components/schemas/Partnership'
processedAt:
description: The date and time when Stedi processed the transaction, in ISO 8601 format. For example,
`2023-08-28T00:00:00Z`.
format: date-time
type: string
status:
$ref: '#/components/schemas/TransactionStatus'
transactionId:
description: A unique identifier for the processed transaction within Stedi. This ID is included in the
transaction processed event. You can also retrieve it manually from the transaction's details page within
the Stedi portal.
type: string
translationErrors:
description: Details about errors that prevented Stedi from processing the transaction.
items:
$ref: '#/components/schemas/TranslationError'
type: array
x12:
$ref: '#/components/schemas/X12TransactionSummary'
required:
- artifacts
- direction
- fileExecutionId
- mode
- partnership
- processedAt
- status
- transactionId
type: object
TranslationError:
properties:
context:
$ref: '#/components/schemas/TranslationErrorContext'
mark:
$ref: '#/components/schemas/Mark'
message:
description: A message describing the error that occurred during translation.
type: string
required:
- message
type: object
TranslationErrorContext:
properties:
code:
description: The error code.
type: string
schemaPath:
description: The name of the JSON property where the error occurred.
type: string
type: object
UnauthorizedExceptionResponseContent:
description: The server response when the authorizer failed to authenticate the caller.
properties:
code:
type: string
message:
type: string
required:
- message
type: object
UnprocessableEntityExceptionResponseContent:
description: The request parameters do not match a previous request with the same idempotency key.
properties:
code:
type: string
message:
type: string
required:
- message
type: object
X12TransactionMetadata:
description: Metadata about the X12 EDI transaction, including information from the interchange, functional
group, and transaction headers as well as the sender and receiver IDs.
properties:
functionalGroup:
$ref: '#/components/schemas/X12TransactionMetadataFunctionalGroup'
interchange:
$ref: '#/components/schemas/X12TransactionMetadataInterchange'
receiver:
$ref: '#/components/schemas/X12TransactionMetadataProfile'
sender:
$ref: '#/components/schemas/X12TransactionMetadataProfile'
transaction:
$ref: '#/components/schemas/X12TransactionMetadataTransaction'
required:
- functionalGroup
- interchange
- receiver
- sender
- transaction
type: object
X12TransactionMetadataFunctionalGroup:
description: Data from the Functional Group Header of the X12 EDI file.
properties:
controlNumber:
description: The Group Control Number ([`GS06`](https://www.stedi.com/edi/x12/segment/GS#GS-06)).
maximum: 999999999
minimum: 0
type: number
date:
description: The date in the Functional Group Header ([`GS04`](https://www.stedi.com/edi/x12/segment/GS#GS-04)),
formatted as `YYYY-MM-DD`. For example, `2023-08-28`.
type: string
functionalIdentifierCode:
description: The Functional Identifier Code ([`GS01`](https://www.stedi.com/edi/x12/segment/GS#GS-01)),
which indicates the type of transaction. For example, `HC` for an 837 Healthcare Claim.
type: string
release:
description: The Version/Release/Industry Identifier Code ([`GS08`](https://www.stedi.com/edi/x12/segment/GS#GS-08)),
which indicates the version of the X12 standard used. For example, `005010X222A1`.
type: string
time:
description: The Time ([`GS05`](https://www.stedi.com/edi/x12/segment/GS#GS-05)), formatted as `HH:MM:SS`.
For example, `21:29:57`.
type: string
required:
- controlNumber
- date
- functionalIdentifierCode
- release
- time
type: object
X12TransactionMetadataInterchange:
description: Data from the Interchange Control Header of the X12 EDI file.
properties:
acknowledgmentRequestedCode:
description: The value of [`ISA14`](https://www.stedi.com/edi/x12/segment/ISA#ISA-14) in the Interchange
Control Header, which indicates whether the sender is requesting a [`TA1` Interchange Acknowledgment](https://www.stedi.com/edi/x12/segment/TA1).
type: string
controlNumber:
description: The control number in the Interchange Control Header.
maximum: 999999999
minimum: 0
type: number
required:
- acknowledgmentRequestedCode
- controlNumber
type: object
X12TransactionMetadataProfile:
description: The Application Code and ISA ID for the profile.
properties:
applicationCode:
description: The Application Code for the profile, which is used to identify the entity in the `GS` header
of an EDI file.
type: string
isa:
$ref: '#/components/schemas/X12TransactionMetadataProfileISA'
required:
- applicationCode
- isa
type: object
X12TransactionMetadataProfileISA:
description: The Interchange ID and qualifier.
properties:
id:
description: The Interchange ID, which is the unique identifier for the entity in the EDI file.
type: string
qualifier:
description: The Interchange Sender ID Qualifier, which indicates the type of identifier. For example,
`ZZ` for a mutually defined identifier.
type: string
required:
- id
- qualifier
type: object
X12TransactionMetadataTransaction:
description: Data from the Transaction Set Header of the X12 EDI file.
properties:
controlNumber:
description: The Transaction Set Control Number ([`ST02`](https://www.stedi.com/edi/x12/segment/ST#ST-02)).
type: string
transactionSetIdentifier:
description: The Transaction Set Identifier Code ([`ST01`](https://www.stedi.com/edi/x12/segment/ST#ST-01)),
which indicates the type of transaction. For example, `837` for an 837 Healthcare Claim.
type: string
required:
- controlNumber
- transactionSetIdentifier
type: object
X12TransactionSetIdentifierCode:
description: 'Any valid 3-digit X12 Transaction Set Identifier Code, as defined in the X12 standard. See:
<https://www.stedi.com/edi/x12/element/143>.'
enum:
- '100'
- '101'
- '102'
- '103'
- '104'
- '105'
- '106'
- '107'
- '108'
- '109'
- '110'
- '111'
- '112'
- '113'
- '120'
- '121'
- '124'
- '125'
- '126'
- '127'
- '128'
- '129'
- '130'
- '131'
- '132'
- '133'
- '135'
- '138'
- '139'
- '140'
- '141'
- '142'
- '143'
- '144'
- '146'
- '147'
- '148'
- '149'
- '150'
- '151'
- '152'
- '153'
- '154'
- '155'
- '157'
- '158'
- '159'
- '160'
- '161'
- '163'
- '170'
- '175'
- '176'
- '179'
- '180'
- '185'
- '186'
- '187'
- '188'
- '189'
- '190'
- '191'
- '194'
- '195'
- '196'
- '197'
- '198'
- '199'
- '200'
- '201'
- '202'
- '203'
- '204'
- '205'
- '206'
- '210'
- '211'
- '212'
- '213'
- '214'
- '215'
- '216'
- '217'
- '219'
- '220'
- '222'
- '223'
- '224'
- '225'
- '227'
- '228'
- '240'
- '242'
- '244'
- '245'
- '248'
- '249'
- '250'
- '251'
- '252'
- '255'
- '256'
- '259'
- '260'
- '261'
- '262'
- '263'
- '264'
- '265'
- '266'
- '267'
- '268'
- '269'
- '270'
- '271'
- '272'
- '273'
- '274'
- '275'
- '276'
- '277'
- '278'
- '280'
- '283'
- '284'
- '285'
- '286'
- '288'
- '290'
- '300'
- '301'
- '303'
- '304'
- '309'
- '310'
- '311'
- '312'
- '313'
- '315'
- '317'
- '319'
- '322'
- '323'
- '324'
- '325'
- '326'
- '350'
- '352'
- '353'
- '354'
- '355'
- '356'
- '357'
- '358'
- '359'
- '361'
- '362'
- '404'
- '410'
- '412'
- '414'
- '417'
- '418'
- '419'
- '420'
- '421'
- '422'
- '423'
- '424'
- '425'
- '426'
- '429'
- '431'
- '432'
- '433'
- '434'
- '435'
- '436'
- '437'
- '440'
- '451'
- '452'
- '453'
- '455'
- '456'
- '460'
- '463'
- '466'
- '468'
- '470'
- '475'
- '485'
- '486'
- '490'
- '492'
- '494'
- '500'
- '501'
- '503'
- '504'
- '511'
- '517'
- '521'
- '527'
- '536'
- '540'
- '561'
- '567'
- '568'
- '601'
- '603'
- '620'
- '625'
- '650'
- '715'
- '753'
- '754'
- '805'
- '806'
- '810'
- '811'
- '812'
- '813'
- '814'
- '815'
- '816'
- '818'
- '819'
- '820'
- '821'
- '822'
- '823'
- '824'
- '826'
- '827'
- '828'
- '829'
- '830'
- '831'
- '832'
- '833'
- '834'
- '835'
- '836'
- '837'
- '838'
- '839'
- '840'
- '841'
- '842'
- '843'
- '844'
- '845'
- '846'
- '847'
- '848'
- '849'
- '850'
- '851'
- '852'
- '853'
- '854'
- '855'
- '856'
- '857'
- '858'
- '859'
- '860'
- '861'
- '862'
- '863'
- '864'
- '865'
- '866'
- '867'
- '868'
- '869'
- '870'
- '871'
- '872'
- '873'
- '874'
- '875'
- '876'
- '877'
- '878'
- '879'
- '880'
- '881'
- '882'
- '883'
- '884'
- '885'
- '886'
- '887'
- '888'
- '889'
- '890'
- '891'
- '892'
- '893'
- '894'
- '895'
- '896'
- '897'
- '920'
- '924'
- '925'
- '926'
- '928'
- '940'
- '943'
- '944'
- '945'
- '947'
- '980'
- '990'
- '993'
- '996'
- '997'
- '998'
- '999'
type: string
X12TransactionSetting:
description: The IDs for the guide and transaction setting Stedi used to process the transaction.
properties:
guideId:
description: 'The unique identifier for the Stedi guide used to process the transaction.
Stedi guides are machine-readable specifications for X12 EDI transactions. They describe how to structure
and validate EDI files for each transaction type.'
type: string
transactionSettingId:
description: 'The unique identifier for the transaction setting Stedi used to process the transaction.
Transaction settings configure how Stedi processes specific transaction types, such as which Stedi guide
to use and other processing options. If you''re using the Stedi clearinghouse, Stedi automatically configures
the required transaction settings for you when you set up your account.'
type: string
type: object
X12TransactionSummary:
description: Details about the X12 EDI transaction.
properties:
metadata:
$ref: '#/components/schemas/X12TransactionMetadata'
transactionSetting:
$ref: '#/components/schemas/X12TransactionSetting'
required:
- metadata
type: object
securitySchemes:
httpApiKeyAuth:
description: A [Stedi API Key](https://www.stedi.com/app/settings/api-keys) for authentication.
in: header
name: Authorization
type: apiKey
info:
contact:
email: healthcare@stedi.com
license:
name: Proprietary
url: https://stedi.com
title: Stedi Healthcare Claims Claim acknowledgments Transactions API
version: '2025-03-07'
openapi: 3.0.3
paths:
/transactions:
get:
description: Fetch a list of transactions, sorted by the date they were created from newest to oldest.
operationId: ListTransactions
parameters:
- description: The maximum number of elements to return in a page. You can set this to a maximum of 500 elements.
If not specified, the default is 100.
examples:
ListTransactions_example1:
description: ''
summary: List transactions
value: 200
in: query
name: pageSize
schema:
description: The maximum number of elements to return in a page. You can set this to a maximum of 500
elements. If not specified, the default is 100.
maximum: 500
minimum: 1
type: number
- description: A token returned by a previous call to this operation in the `nextPageToken`. If not specified,
Stedi returns the first page of results.
in: query
name: pageToken
schema:
description: A token returned by a previous call to this operation in the `nextPageToken`. If not specified,
Stedi returns the first page of results.
maxLength: 1024
minLength: 1
type: string
- description: List only transactions containing a business identifier with the given value.
in: query
name: businessIdentifier
schema:
description: List only transactions containing a business identifier with the given value.
type: string
- description: 'List only a given type of transaction. Accepts any valid 3-digit X12 Transaction Set Identifier
Code, as defined in the X12 standard. See: <https://www.stedi.com/edi/x12/element/143>.
# --- truncated at 32 KB (88 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stedi/refs/heads/main/openapi/stedi-transactions-api-openapi.yml