---
updatedAt: 2026-03-05T09:18:09.000Z
agentTools:
  projectIndex: https://neutronpay.readme.io/llms.txt
---

# Get transaction status

Retrieve specified transaction

Retrieve the full details and current status of a specific transaction.

### Example Request

```bash
curl https://api.neutron.me/api/v2/transaction/5e25d2f4-9bca-4b7a-a1ad-2cf056100cb6 \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

### Example Response

```json
{
  "txnId": "5e25d2f4-9bca-4b7a-a1ad-2cf056100cb6",
  "accountId": "ne01-abc123def456",
  "extRefId": "order-12345",
  "txnState": "completed",
  "sourceReq": {
    "ccy": "BTC",
    "method": "lightning",
    "amtRequested": 0.0001,
    "amtSettled": 0.0001,
    "neutronpayFees": 0,
    "networkFees": 0,
    "reqStatus": "2",
    "createAt": 1770342000000,
    "updatedAt": 1770342177000
  },
  "destReq": {
    "ccy": "BTC",
    "method": "neutronpay",
    "amtRequested": 0.0001,
    "amtSettled": 0.0001,
    "reqStatus": "2"
  },
  "fxRate": 1,
  "createdAt": 1770342000000
}
```

### Key Response Fields

| Field            | Description                                                                         |
| ---------------- | ----------------------------------------------------------------------------------- |
| `txnState`       | Current state — see [Transaction Status Types](/reference/transaction-status-types) |
| `amtRequested`   | Amount originally requested                                                         |
| `amtSettled`     | Actual amount settled (populated after completion)                                  |
| `neutronpayFees` | Neutron service fee charged                                                         |
| `networkFees`    | Network/mining fee charged                                                          |
| `reqStatus`      | Request status: `"0"` = pending, `"2"` = completed                                  |
| `fxRate`         | Exchange rate applied (1 for same-currency)                                         |
| `extRefId`       | Your reference ID (if provided at creation)                                         |

### Polling for Status

If you're not using [webhooks](/reference/purpose), you can poll this endpoint to track transaction progress:

```javascript
async function waitForCompletion(txnId, token) {
  const finalStates = ['completed', 'failed', 'expired', 'rejected', 'error', 'usercanceled'];
  
  while (true) {
    const res = await fetch(`https://api.neutron.me/api/v2/transaction/${txnId}`, {
      headers: { 'Authorization': `Bearer ${token}` }
    });
    const txn = await res.json();
    
    if (finalStates.includes(txn.txnState)) {
      return txn;
    }
    
    await new Promise(r => setTimeout(r, 3000)); // Poll every 3 seconds
  }
}
```

> 📘 **Webhooks are recommended** over polling for production. See the [Webhook Guide](/reference/purpose) for setup.

### Related

* [List transactions](/reference/listtransactions) — Query multiple transactions
* [Transaction Status Types](/reference/transaction-status-types) — All states explained
* [Webhook Guide](/reference/purpose) — Real-time status notifications

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Neutronpay API",
    "version": "2.2.6",
    "description": "Neutron API Reference"
  },
  "servers": [
    {
      "url": "https://api.neutron.me",
      "description": "Development environment"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "JWT Authorization header using the Bearer scheme. Example: 'Authorization: Bearer {token}'"
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Transactions",
      "description": "Transaction management endpoints"
    }
  ],
  "paths": {
    "/api/v2/transaction/{transactionId}": {
      "get": {
        "summary": "Get transaction status",
        "description": "Retrieve specified transaction",
        "tags": [
          "Transactions"
        ],
        "parameters": [
          {
            "name": "transactionId",
            "in": "path",
            "required": true,
            "description": "The unique identifier of the transaction",
            "schema": {
              "deprecated": false,
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "txnId": {
                      "type": "string",
                      "description": "Unique identifier of the transaction"
                    },
                    "accountId": {
                      "type": "string",
                      "description": "Unique identifier of the account"
                    },
                    "accountDisplayName": {
                      "type": "string",
                      "description": "Display name of the account"
                    },
                    "extRefId": {
                      "type": "string",
                      "description": "External reference ID"
                    },
                    "sourceReq": {
                      "type": "object",
                      "properties": {
                        "accountId": {
                          "type": "string"
                        },
                        "ccy": {
                          "type": "string"
                        },
                        "method": {
                          "type": "string"
                        },
                        "amtRequested": {
                          "type": "number"
                        },
                        "amtSettled": {
                          "type": "number"
                        },
                        "neutronpayFees": {
                          "type": "number"
                        },
                        "baseNeutronpayFees": {
                          "type": "number"
                        },
                        "networkFees": {
                          "type": "number"
                        },
                        "baseNetworkFees": {
                          "type": "number"
                        },
                        "reqStatus": {
                          "type": "string"
                        },
                        "kyc": {
                          "type": "object"
                        },
                        "expiresAt": {
                          "type": "integer"
                        },
                        "createAt": {
                          "type": "integer"
                        },
                        "updatedAt": {
                          "type": "integer"
                        }
                      }
                    },
                    "destReq": {
                      "type": "object",
                      "properties": {
                        "accountId": {
                          "type": "string"
                        },
                        "ccy": {
                          "type": "string"
                        },
                        "method": {
                          "type": "string"
                        },
                        "amtRequested": {
                          "type": "number"
                        },
                        "amtSettled": {
                          "type": "number"
                        },
                        "neutronpayFees": {
                          "type": "number"
                        },
                        "baseNeutronpayFees": {
                          "type": "number"
                        },
                        "networkFees": {
                          "type": "number"
                        },
                        "baseNetworkFees": {
                          "type": "number"
                        },
                        "reqStatus": {
                          "type": "string"
                        },
                        "kyc": {
                          "type": "object"
                        },
                        "reqDetails": {
                          "type": "object",
                          "properties": {
                            "address": {
                              "type": "string"
                            }
                          }
                        },
                        "expiresAt": {
                          "type": "integer"
                        },
                        "createAt": {
                          "type": "integer"
                        },
                        "updatedAt": {
                          "type": "integer"
                        }
                      }
                    },
                    "fxRate": {
                      "type": "number"
                    },
                    "txnState": {
                      "type": "string"
                    },
                    "createAt": {
                      "type": "integer"
                    },
                    "expiresAt": {
                      "type": "integer"
                    },
                    "updatedAt": {
                      "type": "integer"
                    },
                    "txnType": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "Success": {
                    "summary": "Success",
                    "value": {
                      "txnId": "58493016-d0eb-4715-8a9d-596f1b1d07f8",
                      "accountId": "ne01-e3b08bc71e244707a5fc023a8c009daf",
                      "accountDisplayName": "WALLET",
                      "extRefId": "58493016-d0eb-4715-8a9d-596f1b1d07f8",
                      "sourceReq": {
                        "accountId": "ne01-e3b08bc71e244707a5fc023a8c009daf",
                        "ccy": "BTC",
                        "method": "neutronpay",
                        "amtRequested": 0.001,
                        "amtSettled": 0,
                        "neutronpayFees": 0,
                        "baseNeutronpayFees": 0,
                        "networkFees": 0,
                        "baseNetworkFees": 0,
                        "reqStatus": "A",
                        "kyc": {
                          "type": "individual",
                          "details": {
                            "legalFullName": "John Doe",
                            "countryCode": "CA"
                          }
                        },
                        "expiresAt": 1748180836129,
                        "createAt": 1748180535539,
                        "updatedAt": 1748180535539
                      },
                      "destReq": {
                        "accountId": "ne01-e3b08bc71e244707a5fc023a8c009daf",
                        "ccy": "BTC",
                        "method": "on-chain",
                        "amtRequested": 0.001,
                        "amtSettled": 0,
                        "neutronpayFees": 0,
                        "baseNeutronpayFees": 0,
                        "networkFees": 0,
                        "baseNetworkFees": 0,
                        "reqStatus": "A",
                        "kyc": {
                          "type": "individual",
                          "details": {
                            "legalFullName": "John Doe",
                            "countryCode": "CA"
                          }
                        },
                        "reqDetails": {
                          "address": "2Mwq9GmtPWxHaaDqhCYQ8dcmfaUr8nhBtN7"
                        },
                        "expiresAt": 1748180836129,
                        "createAt": 1748180535539,
                        "updatedAt": 1748180535539
                      },
                      "fxRate": 1,
                      "txnState": "usercanceled",
                      "createAt": 1748180535539,
                      "expiresAt": 1748180836129,
                      "updatedAt": 1748180709155,
                      "txnType": "payout"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Invalid or missing authentication credentials"
          },
          "404": {
            "description": "Not Found - The requested transaction does not exist"
          }
        },
        "operationId": "getTransactionStatus"
      }
    }
  },
  "x-readme": {}
}
```