API product catalogExecution & Order Management (OMS)

Get order execution reports

Execution & Order Management (OMS)

GET

/orders/{orderId}/executions

Sandbox unsupportedgetOrderExecutions

Returns OMS execution reports for a partner master-account order, including receipt, fill, rejection, and cancellation reports.

Parameters

orderIdstringpathRequired

Example: ord_abc123xyz

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

orderIdstring

subAccountIdstring | null

executionsobject[]

executions[].executionReportIdstring

executions[].journalVersioninteger | null

executions[].immutableboolean

executions[].eventHashAlgorithmstring | null

executions[].eventHashstring | null

executions[].orderIdstring

executions[].clientOrderIdstring | null

executions[].accountTypeMASTER | SUBACCOUNT

executions[].subAccountIdstring | null

executions[].sideBUY | SELL

executions[].symbolstring

executions[].exchangestring | null

executions[].requestedQuantitynumber

executions[].filledQuantitynumber

executions[].remainingQuantitynumber

executions[].fillPricenumber | null

executions[].averageFillPricenumber | null

executions[].feeAmountnumber | null

executions[].netAmountnumber | null

executions[].currencystring

Example: "USD"

executions[].executionVenuestring | null

executions[].actorTypestring | null

executions[].actorIdstring | null

executions[].requestIdstring | null

executions[].sourcestring | null

executions[].correctsExecutionReportIdstring | null

executions[].syntheticboolean

True only for a read-time compatibility FILL derived from a legacy filled order that predates the immutable execution journal.

executions[].sourceEvidencestring | null

executions[].createdAtstring | null

executions[].occurredAtstring | null

executions[].recordedAtstring | null

countinteger

Response codes

200Execution reports for the order.

404Order not found.

Request reference

Sandbox unsupported

orderId Required · path

Use the API Reference for this production-only or streaming operation.

https://mystocks.africa/api/v1/partner/orders/%7BorderId%7D/executions

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "orderId": {
      "type": "string"
    },
    "subAccountId": {
      "type": [
        "string",
        "null"
      ]
    },
    "executions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "executionReportId": {
            "type": "string"
          },
          "journalVersion": {
            "type": [
              "integer",
              "null"
            ]
          },
          "immutable": {
            "type": "boolean"
          },
          "eventHashAlgorithm": {
            "type": [
              "string",
              "null"
            ]
          },
          "eventHash": {
            "type": [
              "string",
              "null"
            ]
          },
          "orderId": {
            "type": "string"
          },
          "clientOrderId": {
            "type": [
              "string",
              "null"
            ]
          },
          "accountType": {
            "type": "string",
            "enum": [
              "MASTER",
              "SUBACCOUNT"
            ]
          },
          "subAccountId": {
            "type": [
              "string",
              "null"
            ]
          },
          "reportType": {
            "type": "string",
            "enum": [
              "ORDER_RECEIVED",
              "FILL",
              "REJECT",
              "CANCEL",
              "REPLACE",
              "CORRECTION"
            ]
          },
          "orderStatus": {
            "type": "string",
            "enum": [
              "RECEIVED",
              "FILLED",
              "REJECTED",
              "CANCELLED",
              "REPLACED",
              "WORKING"
            ]
          },
          "side": {
            "type": "string",
            "enum": [
              "BUY",
              "SELL"
            ]
          },
          "symbol": {
            "type": "string"
          },
          "exchange": {
            "type": [
              "string",
              "null"
            ]
          },
          "requestedQuantity": {
            "type": "number"
          },
          "filledQuantity": {
            "type": "number"
          },
          "remainingQuantity": {
            "type": "number"
          },
          "fillPrice": {
            "type": [
              "number",
              "null"
            ]
          },
          "averageFillPrice": {
            "type": [
              "number",
              "null"
            ]
          },
          "feeAmount": {
            "type": [
              "number",
              "null"
            ]
          },
          "netAmount": {
            "type": [
              "number",
              "null"
            ]
          },
          "currency": {
            "type": "string",
            "example": "USD"
          },
          "executionVenue": {
            "type": [
              "string",
              "null"
            ]
          },
          "actorType": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "PARTNER_KEY",
              "ADMIN_USER",
              "SYSTEM_JOB",
              null
            ]
          },
          "actorId": {
            "type": [
              "string",
              "null"
            ]
          },
          "requestId": {
            "type": [
              "string",
              "null"
            ]
          },
          "source": {
            "type": [
              "string",
              "null"
            ]
          },
          "correctsExecutionReportId": {
            "type": [
              "string",
              "null"
            ]
          },
          "synthetic": {
            "type": "boolean",
            "description": "True only for a read-time compatibility FILL derived from a legacy filled order that predates the immutable execution journal."
          },
          "sourceEvidence": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "LEGACY_ORDER_STATE",
              null
            ]
          },
          "createdAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "occurredAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "recordedAt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        }
      }
    },
    "count": {
      "type": "integer"
    }
  }
}

curl -X GET 'https://mystocks.africa/api/v1/partner/orders/%7BorderId%7D/executions' \
  -H "Authorization: Bearer $MYSTOCKS_API_KEY"

PATCH /orders/{orderId}

GET /portfolio