> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payx.company/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Transaction Status

> Retrieve the latest status of a charge or payout transaction

### Authentication

This endpoint requires your v2 secret API key:

* Header: `x-api-key: px_live_v2_...` or `Authorization: Bearer px_live_v2_...`

### Path Parameters

<ParamField path="transactionId" type="string" required>
  The unique transaction identifier returned when creating a charge or payout.
</ParamField>

***

### Response

<ResponseField name="transactionId" type="string">
  The unique transaction ID.
</ResponseField>

<ResponseField name="status" type="string">
  Current transaction status: `PENDING`, `SUCCESSFUL`, or `FAILED`.
</ResponseField>

<ResponseField name="amount" type="number">
  The transaction amount.
</ResponseField>

<ResponseField name="currency" type="string">
  Currency code (e.g. `GHS`).
</ResponseField>

<ResponseField name="reference" type="string">
  Your custom merchant reference or internal reference.
</ResponseField>

***

<RequestExample>
  ```bash curl theme={null}
  curl -X GET https://payx.company/api/v1/status/sample_tx_12345678 \
    -H "x-api-key: px_live_v2_YOUR_SECRET_KEY"
  ```

  ```javascript Node.js theme={null}
  const { PayX } = require('payx-node');
  const payx = new PayX({ apiKey: process.env.PAYX_SECRET_KEY });

  const res = await payx.charge.getStatus('sample_tx_12345678');
  console.log('Status:', res.status);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "transactionId": "sample_tx_12345678",
    "status": "SUCCESSFUL",
    "amount": 10.00,
    "currency": "GHS",
    "reference": "ORD-1001"
  }
  ```
</ResponseExample>