---
title: "Get Collection record by reference"
method: GET
path: "/collections/reference/{reference}"
---

# Get Collection record by reference

`GET /collections/reference/{reference}`

## Request

- Base URL: `https://sandboxapi.fincra.com`
- URL: `https://sandboxapi.fincra.com/collections/reference/{reference}`
- Auth: API key in header `api-key`
- TypeScript: <https://skmtc.dev/fincra/apis/awesome-new-api/docs/collections/reference/:reference/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint returns details of a payment into your Fincra position. You can use this endpoint to verify the status and details of a payment after receiving the collection.successful webhook.

## Path parameters

- `reference` string, required

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `id` integer
    - `_id` string
    - `sourceAmount` integer
    - `destinationAmount` integer
    - `sourceAmountSettled` integer
    - `destinationAmountSettled` integer
    - `sourceCurrency` string
    - `destinationCurrency` string
    - `sourceFee` integer
    - `destinationFee` integer
    - `payeeName` string
    - `payeeAccountNumber` string
    - `status` string
    - `requiresApproval` integer
    - `approvalStatus` string
    - `reference` string
    - `isSubAccount` integer
    - `description` string
    - `paymentMethod` string
    - `merchantReference` string
    - `settlementDestination` string
    - `message` unknown
    - `payer` object
      - `name` string
      - `account_number` string
      - `bank_code` string
      - `bank_name` string
    - `virtualAccountId` string
    - `initiatedAt` string
    - `settledAt` unknown
    - `createdAt` string
    - `updatedAt` string
    - `vat` integer
    - `stampDuty` integer
    - `refundInfo` unknown
    - `isReversed` integer
    - `businessId` integer
    - `mongoBusinessId` unknown
    - `metadata` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `526b1509a02d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fincra/apis/awesome-new-api/changes/collections/reference/:reference/get.md)

---

[API](https://skmtc.dev/fincra/apis/awesome-new-api.md) - [All operations](https://skmtc.dev/fincra/apis/awesome-new-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fincra/apis/awesome-new-api/revisions/526b1509a02d?raw)