> ## 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.

# Fetch Transaction Details

> Returns the full details of a single transaction by its PCN, including the bank details selected when it was created.

Returns the full details of a booked transfer, including its status, amounts, sender, beneficiary and the bank details selected when the transaction was created. Pass the PCN (Platform Control Number) returned from `create-transaction` and `TRANSACTION` as the payable type.

Use this endpoint when you need more than the status. To check the status only, use [Check Transaction Status](https://docs.fincode.technology/api/transactions/check-transaction-status.md).

## Request Headers

**X-Auth-Token** `string` *required*

JWT Access Token of the authenticated user.

**platform** `string` *required* (default: fincode)

Platform identifier. Use `fincode`.

**uuid** `string` *required* (default: 200)

Unique request identifier.

## Path Parameters

**pcn** `string` *required*

The PCN of the booked transfer, as returned in the `objectReference` field of the `create-transaction` response.

**payable\_type** `string` *required*

The type of item to fetch. Use `TRANSACTION`.

## Response

**status** `string`

`SUCCESS` when the transaction is found, `FAILED` when the PCN is not valid.

**message** `string`

The reason for the failure, for example when the PCN is not valid.

**data** `object`

The transaction details.

**data fields**

**code** `string`

The PCN of the transaction.

**status** `string`

The transaction status name (e.g. `PENDING`, `PAID`, `FAILED`, `CANCELLED`).

**display\_status** `string`

Human-readable label for the current status.

**bankDetails** `boolean`

`true` when bank details were added to the transaction.

**bankName** `string`

The name of the bank selected when the transaction was created.

**accountHolderName** `string`

The name on the beneficiary's bank account.

**accountNumber** `string`

The beneficiary's account number.

**recipient\_bank\_details** `object`

All bank details saved on the transaction, keyed by field name (e.g. `BankName`, `AccountHolderName`, `AccountNumber`, `BankCode`, `AccountType`, `SortCode`, `IBAN`, `SWIFT`). Only the fields that were provided are included. This is `null` for cash pickup transactions.

**sender** `object`

The sender's `first_name`, `last_name`, `email`, `phone` and `code`.

**receiver** `object`

The beneficiary's `first_name`, `last_name`, `email`, `phone` and `code`.

**sending\_currency\_code** `string`

The currency the transfer was sent in.

**amount\_sent** `string`

The amount sent, formatted with the organisation's decimal format settings.

**receiving\_currency\_code** `string`

The currency the beneficiary receives.

**amount\_received** `string`

The amount the beneficiary receives.

**charges** `string`

The fee charged for the transfer.

**total\_amount\_paid** `string`

The total amount paid by the sender.

**deliveryMethod** `string`

The delivery method of the transfer (e.g. `ACCOUNTPAYMENT`, `CASHPICKUP`).

**date** `string`

The date the transaction was created.

**last\_update\_date** `string`

The date the transaction was last updated.

**compliant** `boolean`

Whether the transaction has passed compliance checks.

**customerComplianceCheckList** `array`

The compliance rules that failed or raised a warning for the transaction.

## Code Examples

```bash cURL theme={null}
curl -X GET 'https://{domain}.fincode.software/api/v6/services/transactionmanagement/fetch-payable-type/TR123456789012/TRANSACTION' \
--header 'X-Auth-Token: YOUR_TOKEN' \
--header 'platform: fincode' \
--header 'uuid: 200'
```

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

const pcn = 'TR123456789012';

const response = await axios.get(
  `https://{domain}.fincode.software/api/v6/services/transactionmanagement/fetch-payable-type/${pcn}/TRANSACTION`,
  {
    headers: {
      'X-Auth-Token': 'YOUR_TOKEN',
      'platform': 'fincode',
      'uuid': '200'
    }
  }
);
```

## Example Response

```json theme={null}
{
  "status": "SUCCESS",
  "data": {
    "code": "TR123456789012",
    "status": "PENDING",
    "bankDetails": true,
    "bankName": "Example Bank",
    "accountHolderName": "Jane Doe",
    "accountNumber": "0123456789",
    "recipient_bank_details": {
      "BankName": "Example Bank",
      "AccountHolderName": "Jane Doe",
      "AccountNumber": "0123456789",
      "BankCode": "000"
    },
    "sending_currency_code": "GBP",
    "amount_sent": "100.00",
    "receiving_currency_code": "NGN",
    "amount_received": "150,000.00"
  }
}
```

The example shows a subset of the fields. See the Response section for the full list.


## OpenAPI

````yaml GET /transactionmanagement/fetch-payable-type/{pcn}/{payable_type}
openapi: 3.0.0
info:
  title: FinCode API
  version: v6
servers:
  - url: https://{your-domain}.fincode.software/api/v6/services
    description: API v6
    variables:
      your-domain:
        default: remitjunction
        description: Enter your subdomain
  - url: https://{your-domain}.fincode.software/api/v1/services
    description: API v1
    variables:
      your-domain:
        default: finlend
        description: Enter your subdomain
  - url: https://api.stag.songhaiexchange.io
    description: Songhai Exchange API
security: []
paths:
  /transactionmanagement/fetch-payable-type/{pcn}/{payable_type}:
    get:
      summary: Fetch Transaction Details
      description: >-
        Returns the full details of a single transaction by its PCN, including
        the bank details selected when it was created
      operationId: fetchPayableType
      parameters:
        - $ref: '#/components/parameters/platformHeader'
        - $ref: '#/components/parameters/uuidHeader'
        - in: header
          name: X-Auth-Token
          schema:
            type: string
          required: true
        - in: path
          name: pcn
          schema:
            type: string
          required: true
        - in: path
          name: payable_type
          schema:
            type: string
            enum:
              - TRANSACTION
            default: TRANSACTION
          required: true
      responses:
        '200':
          description: Transaction details
components:
  parameters:
    platformHeader:
      in: header
      name: platform
      schema:
        type: string
        default: fincode
      required: true
    uuidHeader:
      in: header
      name: uuid
      schema:
        type: string
        default: '200'
      required: true

````

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