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

# Transfer Status

> Check the status of a previously initiated transfer

Use this endpoint to **check the final status of a transfer** you created with either **Initiate Transfer** or **Bulk Transfer**.

## Endpoint

<Badge variant="success">**POST**</Badge> `/pms/api/external/request/wallet/transfer-status/`

## Request Body

<ParamField body="reference" type="string">
  Transfer reference you passed when initiating the transfer
</ParamField>

<ParamField body="session_id" type="string">
  Session ID returned in the initial transfer response
</ParamField>

### Example request

```json theme={null}
{
  "reference": "PAYOUT_2026_0001",
  "session_id": "SESSION_123456789"
}
```

### Example cURL

```bash theme={null}
curl -X POST "https://api.payvessel.com/pms/api/external/request/wallet/transfer-status/" \
  -H "api-key: YOUR_API_KEY" \
  -H "api-secret: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "PAYOUT_2026_0001",
    "session_id": "SESSION_123456789"
  }'
```

## Response

```json theme={null}
{
  "status": true,
  "message": "Transfer status retrieved",
  "data": {
    "reference": "PAYOUT_2026_0001",
    "session_id": "SESSION_123456789",
    "amount": "15000.00",
    "status": "success",
    "destination_account_number": "0123456789",
    "destination_bank_code": "999991",
    "destination_account_name": "John Doe",
    "completed_at": "2026-03-11T13:04:35.988Z"
  }
}
```

The `status` field in `data` tells you whether the transfer is `pending`, `success`, or `failed`.

Use this endpoint together with **Initiate Transfer**, **Bulk Transfer**, and wallet transaction history for full payout reconciliation.


## OpenAPI

````yaml POST /pms/api/external/request/wallet/transfer-status/
openapi: 3.1.0
info:
  title: PayVessel API
  description: >-
    PayVessel API for accepting payments, sending money, verifying identities,
    and managing wallets
  version: 1.0.0
servers:
  - url: https://api.payvessel.com
  - url: https://sandbox.payvessel.com
security:
  - {}
paths:
  /pms/api/external/request/wallet/transfer-status/:
    post:
      tags:
        - Transfers
      summary: Transfer Status
      description: Check the status of a previously initiated transfer
      parameters:
        - name: api-key
          in: header
          description: Your Payvessel public API key
          required: true
          schema:
            type: string
        - name: api-secret
          in: header
          description: Your Payvessel secret
          required: true
          schema:
            type: string
        - name: Content-Type
          in: header
          description: Request content type
          required: true
          schema:
            type: string
            enum:
              - application/json
          example: application/json
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransferStatusRequest'
            example:
              reference: PAYOUT_2026_0001
              session_id: SESSION_123456789
      responses:
        '200':
          description: Transfer status retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransferStatusResponse'
components:
  schemas:
    TransferStatusRequest:
      type: object
      required:
        - reference
        - session_id
      properties:
        reference:
          type: string
          description: Transfer reference
        session_id:
          type: string
          description: Session ID from initiation
    TransferStatusResponse:
      type: object
      properties:
        status:
          type: boolean
          description: Request status
        message:
          type: string
          description: Response message
        data:
          type: object
          description: Transfer status data

````