Skip to main content
GET
/
schedule-management
/
v1
/
schedules
/
{uid}
/
versions
List Schedule Versions
curl --request GET \
  --url https://api.engrate.io/schedule-management/v1/schedules/{uid}/versions \
  --header 'Authorization: <api-key>'
[
  {
    "acceptance_level": "cnf",
    "created_ts": "2026-03-25T14:00:00+00:00",
    "is_active": true,
    "last_modified_ts": "2026-03-25T14:05:00+00:00",
    "message_id": "MSG-20260325-001",
    "nrr_received": true,
    "org_uid": "9b2e4d8f-1c3a-4f5e-8d7b-6a9e0f2c1b3d",
    "schedule_uid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "spec": {
      "market": "DE",
      "receiver_id": "10XDE-VE-TRANSMK",
      "sender_id": "11XDE-SENDER---A",
      "series": [],
      "tso": "50HERTZ_DE_TSO"
    },
    "status": "accepted",
    "transmission_report_id": "TR-20260325-001",
    "uid": "c8d7e6f5-4a3b-4c2d-9e1f-0a8b7c6d5e4f",
    "version": 1
  }
]

Authorizations

​
Authorization
string
header
required

Path Parameters

​
uid
string<uuid>
required

Schedule unique identifier.

Response

Successful Response

​
acceptance_level
string
required

Highest acceptance level reached: empty string, ack, or cnf.

Examples:

"cnf"

"ack"

""

​
created_ts
string
required

ISO 8601 datetime when this version was created.

Example:

"2026-03-25T14:00:00+00:00"

​
last_modified_ts
string
required

ISO 8601 datetime of the most recent status change.

Example:

"2026-03-25T14:05:00+00:00"

​
org_uid
string
required

Organization that owns this version.

Example:

"9b2e4d8f-1c3a-4f5e-8d7b-6a9e0f2c1b3d"

​
schedule_uid
string
required

Parent Schedule identifier.

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

​
spec
ScheduleVersionSpec · object
required

Full submission specification including market routing and series references.

​
status
string
required

Processing status: ingested, submitted, accepted, rejected, cnf_partial, or icnf.

Examples:

"accepted"

"submitted"

"rejected"

​
uid
string
required

Unique identifier for this version.

Example:

"c8d7e6f5-4a3b-4c2d-9e1f-0a8b7c6d5e4f"

​
version
integer
required

Sequential version number (1-based). Increments with each re-submission.

Examples:

1

2

3

​
is_active
boolean
default:true

Whether this version is the active one according to the authoritative TSO message ID. Older versions become inactive when a new version is accepted.

​
message_id
string | null

TSO document identification assigned to this version's message.

Example:

"MSG-20260325-001"

​
nrr_received
boolean | null

Whether a Non-Repudiation of Receipt (NRR) delivery confirmation has been received from the TSO.

​
transmission_report_id
string | null

Mako365/AS4 transmission report identifier for delivery tracking.

Example:

"TR-20260325-001"

​
warnings
WarningItem · object[] | null

TSO warnings from the ACK response, if any.