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

# Check Transaction Status

> Returns the current processing status of a single transaction by its PCN.

Returns the current processing status of a booked transfer. Pass the PCN (Platform Control Number) returned from `create-transaction` as the path parameter.

## Request Headers

<ParamField header="X-Auth-Token" type="string" required>
  JWT Access Token of the authenticated user.
</ParamField>

<ParamField header="platform" type="string" required default="fincode">
  Platform identifier. Use `fincode`.
</ParamField>

<ParamField header="uuid" type="string" required default="200">
  Unique request identifier.
</ParamField>

<ParamField header="ipAddress" type="string" required>
  IP address of the client making the request.
</ParamField>

## Path Parameters

<ParamField path="transaction_identification_number" type="string" required>
  The PCN of the booked transfer, as returned in the `pcn` field of the `create-transaction` response.
</ParamField>

## Response

<ResponseField name="error" type="object">
  <Expandable title="error fields">
    <ResponseField name="errorCategory" type="string">
      The transaction status name (e.g. `PENDING`, `PROCESSED`, `FAILED`, `CANCELLED`).
    </ResponseField>

    <ResponseField name="errorCode" type="string">
      `0` when the transaction is found, `-1` when not found.
    </ResponseField>

    <ResponseField name="errorDescription" type="string">
      Human-readable label for the current status.
    </ResponseField>
  </Expandable>
</ResponseField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET 'https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/checktransactionstatus/TR656516344451' \
  --header 'X-Auth-Token: YOUR_TOKEN' \
  --header 'platform: fincode' \
  --header 'uuid: 200' \
  --header 'ipAddress: 192.168.1.100'
  ```

  ```javascript Node.js theme={null}
  const axios = require('axios');

  const pcn = 'TR656516344451';

  const response = await axios.get(
    `https://{your-domain}.fincode.software/api/v6/services/transactionmanagement/checktransactionstatus/${pcn}`,
    {
      headers: {
        'X-Auth-Token': 'YOUR_TOKEN',
        'platform': 'fincode',
        'uuid': '200',
        'ipAddress': '192.168.1.100'
      }
    }
  );
  ```
</CodeGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.