Skip to main content
Return the current status of a transaction, a per-operation breakdown, and a summary of how many operations are completed vs pending. Route: POST /api/external/v1/transactions/{id}/status

​
Headers

HeaderRequiredDescription
Content-TypeYesMust be application/json
x-magna-api-tokenYesYour Magna API token

​
Path parameters

ParameterTypeDescription
idstring (uuid)The transaction ID
No request body is required.

​
Request example

curl -X POST 'https://app.magna.so/api/external/v1/transactions/{transaction_id}/status?id={transaction_id}' \
-H 'Content-Type: application/json' \
-H 'x-magna-api-token: YOUR_API_KEY'

​
Response example

{
  "transactionId": "t1...uuid",
  "status": "COMPLETED",
  "groupId": "g1...uuid",
  "contractId": "c1...uuid",
  "hash": "0x...",
  "submittedAt": "2024-04-15T21:26:21.000Z",
  "completedAt": "2024-04-15T21:30:00.000Z",
  "operations": [
    {
      "id": "op1...uuid",
      "type": "START_DISTRIBUTION",
      "status": "COMPLETED",
      "allocationId": "a1...uuid",
      "synchronizedAt": "2024-04-15T21:30:00.000Z"
    }
  ],
  "operationsSummary": { "total": 1, "completed": 1, "pending": 0 },
  "isCompleted": true,
  "isIndexing": false
}