How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Stedi Destinations API

The Destinations API from Stedi — 4 operation(s) for destinations.

Stedi Destinations API is one of 25 APIs that Stedi publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Destinations. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 7 operations across 4 paths, and defines 22 schemas. It is described by OpenAPI 3.2.0, at version 2026-02-01.

Requests are made against a single base URL, https://events.us.stedi.com/2026-02-01.

7 operations 4 paths 22 schemas 1 DELETE3 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026-02-01
Base URL
https://healthcare.us.stedi.com/2024-04-01
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Stedi Destinations API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (httpApiKeyAuth). By default, every request must be authenticated.

  • httpApiKeyAuth — A [Stedi API Key](https://portal.stedi.com/app/settings/api-keys) for authentication.

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 3 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Destinations 7
GET
/destinations
Lists all destinations configured for your account. Results are paginated.
EventDestinationsListDestinations 4 params → 200400401403429500
POST
/destinations
Creates an event destination. Returns destination details and a signing secret for verifying event payloads.
EventDestinationsCreateDestination 1 param body → 201400401403409413429500
DELETE
/destinations/{destinationId}
Deletes an existing destination. This action is irreversible. Deleting a destination that is already deleted succeeds with the same response (idempotent).
EventDestinationsDeleteDestination 2 params → 204400401403404409429500
GET
/destinations/{destinationId}
Retrieves details for an existing event destination.
EventDestinationsGetDestination 1 param → 200400401403404429500
POST
/destinations/{destinationId}
Updates an existing destination configuration.
EventDestinationsUpdateDestination 2 params body → 200400401403404409413429
GET
/destinations/{destinationId}/secret
Retrieves the current signing secret for a destination. Use this secret to verify the authenticity of event payloads.
EventDestinationsGetDestinationSecret 1 param → 200400401403404429500
POST
/destinations/{destinationId}/secret/rotate
Rotates the signing secret for a destination. The previous secret remains valid for the period specified by previousSecretExpiryHours (or 0 for immediate invalidation) to allow for a graceful transit…
EventDestinationsRotateDestinationSecret 2 params body → 200400401403404409429500

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are EventDestinationsCreateDestinationResponseContent (11 properties), EventDestinationsUpdateDestinationResponseContent (10 properties), EventDestinationsGetDestinationResponseContent (10 properties), DestinationSummary (10 properties). Each schema is shown below with its type and property counts.

EventDestinationsGetDestinationResponseContent
object
Output containing the destination details.
10 properties 8 required
AuthenticationFailedExceptionResponseContent
object
The request credentials are missing or not valid.
1 property 1 required
DestinationStatus
string
The destination's current status. Stedi only sends event payloads to ENABLED destinations.
DestinationInputStatus
string
The desired status of a destination, as set by the user.
ForbiddenExceptionResponseContent
object
The caller is authenticated but lacks permission for this resource or action.
1 property 1 required
InvalidRequestExceptionResponseContent
object
The request is not valid. Fix the request before retrying.
2 properties 1 required
ConflictExceptionResponseContent
object
The request conflicts with the current state of the resource.
1 property 1 required
EventDestinationsRotateDestinationSecretRequestContent
object
Input for rotating a destination's signing secret.
1 property
EventDestinationsGetDestinationSecretResponseContent
object
Output containing the destination's signing secret.
2 properties 1 required
EventDestinationsLimitExceededExceptionResponseContent
object
The account has reached its maximum number of event destinations. Delete an existing destination or request a limit increase before creating another. Not retry…
1 property 1 required
InternalServerExceptionResponseContent
object
The service failed unexpectedly. Retry with backoff.
1 property 1 required
EventDestinationsListDestinationsResponseContent
object
Output containing the list of destinations.
2 properties 1 required
ContentTooLargeExceptionResponseContent
object
The request payload is larger than the service accepts. Send less in one request.
1 property 1 required
EventDestinationsUpdateDestinationResponseContent
object
Output containing the updated destination details.
10 properties 8 required
NotFoundExceptionResponseContent
object
The requested resource does not exist.
1 property 1 required
EventDestinationsCreateDestinationResponseContent
object
Output containing the created destination details and signing secret.
11 properties 9 required
DestinationSummary
object
A summary representation of a destination, returned in list responses.
10 properties 8 required
EventDestinationsCreateDestinationRequestContent
object
Input for creating a new destination.
6 properties 3 required
EventDestinationsRotateDestinationSecretResponseContent
object
Output containing the new signing secret.
2 properties 1 required
TooManyRequestsExceptionResponseContent
object
The caller has exceeded a rate limit. Retry with backoff.
1 property 1 required
EventDestinationsUpdateDestinationRequestContent
object
Input for updating a destination.
6 properties
ValidationFailure
object
A single way in which the request failed validation.
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

stedi-destinations-api-openapi.yml Raw ↑

Other APIs Stedi publishes across the network.

Stedi Claim acknowledgments API
Stedi Claim Attachments API
Stedi Claim submission API
Stedi Coordination of benefits API
Stedi Documents API
Stedi Enrollments API
Stedi Events API
Stedi Executions API
Stedi Fragments API
Stedi Insurance discovery API
Stedi Partnerships API
Stedi Payer API
Where this information came from

This is an independent, third-party profile of Stedi Destinations API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.