Skip to main content

Reports Schema Notes

This API does not take a request body and returns ReportMessageSchema items.

Request Parameters

FieldLocationRequiredTypeFormat / ConstraintsNotes
X-API-KEYHeaderYesstringNot specified in schemaRequired for supplier authorization.
mpidPathYesstringNot specifiedSupplier MPID.
received_startQueryNostring(datetime)ISO 8601 datetimeStart of the received datetime range.
received_endQueryNostring(datetime)ISO 8601 datetimeEnd of the received datetime range.

Additional validation:

  • If both received_start and received_end are present, received_start must be before or equal to received_end.

Response Schema (ReportMessageSchema)

FieldRequiredTypeFormat / ConstraintsNotes
idYesstringUUIDMarket system message ID.
inbound_outboundYesstring(enum)Direction valueTypically inbound or outbound.
statusYesstring(enum)Message status valueMessage processing state.
createdNostring(datetime) or nullISO 8601 datetimeMessage creation timestamp.
updatedNostring(datetime) or nullISO 8601 datetimeLast update timestamp.
interface_idNostring or nullNot specifiedInterface identifier associated with the message.
schema_versionNostring or nullNot specifiedMessage schema version.
event_codeNostring or nullNot specifiedREP message code, for example REP-002.
sender_dip_idNostring or nullNot specifiedSender DIP ID.
sender_role_idNostring or nullNot specifiedSender role code.
decoded_messageNoobject or nullFree-form JSON objectDecoded report payload.