---
title: "View recoveries"
method: GET
path: "/recovery/v3"
tags: ["Decline Recovery"]
---

# View recoveries

`GET /recovery/v3`

Returns declined transactions within the given date range along with the [decline recovery](https://docs.nexiopay.com/docs/constant-transaction-values#recovery-status-recoverystatus) status of each.

For additional information about this endpoint, see the [Retrieving transaction list from decline recovery](https://docs.nexiopay.com/docs/retrieving-transaction-list-from-decline-recovery) tutorial.

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you must use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments).


<div style="display:none;">

## Request parameters
- endDate
- limit
- offset
- startDate
- recoveryStatus

## Response parameters
- offset
- limit
- rows
- rows.id
- rows.retryDate
- rows.transactionDate
- rows.originalAmount
- rows.originalDeclinePaymentId
- rows.orderNumber
- rows.recoveryStatus
- rows.retryCount
- rows.merchantId
- rows.userName
- rows.isEnabledForRecovery
- rows.declineMessage
- rows.updatedAt
- hasMore

</div>

## Query parameters

- `limit` integer
- `offset` integer
- `startDate` string
- `endDate` string
- `recoveryStatus` RecoveryStatus — unresolved $ref

## Response `200`

Success

- object
  - `offset` integer — The number of rows by which the data is offset.
  - `limit` integer — The limit of the number of rows.
  - `rows` object[] — An array of transactions with [decline recovery](https://docs.nexiopay.com/docs/retrieving-transaction-list-from-decline-recovery) information included
    - `id` Id — unresolved $ref
    - `merchantId` string — The merchant ID.
    - `retryDate` string, date-time — The date and time at which the transaction will be retried.
    - `recoveryStatus` RecoveryStatus — unresolved $ref
    - `retryCount` integer — The number of times the transaction has been retried. (The transaction will be retried up to 11 times within a 30 day period).
    - `orderNumber` OrderNumber — unresolved $ref
    - `transactionDate` string, date-time — The transaction date of the original transaction.
    - `userName` string — The API username under which the transaction was run.
    - `isEnabledForRecovery` boolean — Will be `true` if [decline recovery](https://docs.nexiopay.com/docs/retrieving-transaction-list-from-decline-recovery) has been enabled for this transaction.
    - `originalAmount` number — The original transaction amount.
    - `originalDeclinePaymentId` string — The payment ID of the original (declined) transaction.
    - `declineMessage` string — Message from the gateway provider about the decline.
    - `updatedAt` string, date-time — The date and time at which the transaction record was most recently updated in Nexio.
  - `hasMore` boolean — Will be `true` if there are more records not included in the current response.

## Other responses

- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.

---

[API](https://skmtc.dev/nexiopay/apis/payments-api-reference.md) · [All operations](https://skmtc.dev/nexiopay/apis/payments-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nexiopay/payments-api-reference/revisions/b414b73979e5/schema)