Skip to main content
GET
/
v1
/
unreferenced-refunds
/
{unreferenced_refund_id}
curl --request GET \
  --url 'https://api.y.uno/v1/unreferenced-refunds/urf_01HX31R6QK7E2F4G5H6J7K8M9N?include_raw_responses=true' \
  --header 'public-api-key: YOUR_PUBLIC_API_KEY' \
  --header 'private-secret-key: YOUR_PRIVATE_SECRET_KEY' \
  --header 'Accept: application/json'

{
  "id": "urf_01HX31R6QK7E2F4G5H6J7K8M9N",
  "account_id": "9f6e0a4c-1d2b-4e3f-8a9b-1c2d3e4f5a6b",
  "merchant_order_id": "REFUND-2026-05-14-001",
  "country": "US",
  "amount": { "value": 25.00, "currency": "USD" },
  "status": "SUCCEEDED",
  "sub_status": "SUCCEEDED",
  "payment_method": {
    "vaulted_token": "vt_01HX2Y3ZP4Q5R6S7T8U9V0W1X2",
    "detail": {
      "card": {
        "card_data": { "brand": "VISA", "last_four": "1111", "type": "CREDIT" }
      }
    }
  },
  "customer_payer": {
    "id": "cus_01HX2K9PQR3S4T5U6V7W8X9Y0Z"
  },
  "provider": {
    "name": "STRIPE",
    "type": "PSP",
    "reference": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
    "category": "APPROVED",
    "raw_response_code": "succeeded",
    "raw_response_message": "Refund settled"
  },
  "created_at": "2026-05-14T11:47:13.482Z",
  "updated_at": "2026-05-14T11:47:18.030Z"
}
This request enables you to retrieve details of an unreferenced refund based on its id, which needs to be provided in the request path.
​
public-api-key
string
required
The unique public API key for your account.
​
private-secret-key
string
required
The unique private secret key for your account.
​
unreferenced_refund_id
string
required
Yuno-generated unique identifier of the unreferenced refund. Prefix urf_.
​
include_raw_responses
boolean
default:"false"
When true, the provider object in the response payload will include raw_response_code and raw_response_message.
​
include_transaction_responses
boolean
default:"false"
When true, returns the full list of attempts and intermediate network responses if the refund triggered multiple internal retries.
curl --request GET \
  --url 'https://api.y.uno/v1/unreferenced-refunds/urf_01HX31R6QK7E2F4G5H6J7K8M9N?include_raw_responses=true' \
  --header 'public-api-key: YOUR_PUBLIC_API_KEY' \
  --header 'private-secret-key: YOUR_PRIVATE_SECRET_KEY' \
  --header 'Accept: application/json'

{
  "id": "urf_01HX31R6QK7E2F4G5H6J7K8M9N",
  "account_id": "9f6e0a4c-1d2b-4e3f-8a9b-1c2d3e4f5a6b",
  "merchant_order_id": "REFUND-2026-05-14-001",
  "country": "US",
  "amount": { "value": 25.00, "currency": "USD" },
  "status": "SUCCEEDED",
  "sub_status": "SUCCEEDED",
  "payment_method": {
    "vaulted_token": "vt_01HX2Y3ZP4Q5R6S7T8U9V0W1X2",
    "detail": {
      "card": {
        "card_data": { "brand": "VISA", "last_four": "1111", "type": "CREDIT" }
      }
    }
  },
  "customer_payer": {
    "id": "cus_01HX2K9PQR3S4T5U6V7W8X9Y0Z"
  },
  "provider": {
    "name": "STRIPE",
    "type": "PSP",
    "reference": "re_3OqQz92eZvKYlo2C0g6XK1Yj",
    "category": "APPROVED",
    "raw_response_code": "succeeded",
    "raw_response_message": "Refund settled"
  },
  "created_at": "2026-05-14T11:47:13.482Z",
  "updated_at": "2026-05-14T11:47:18.030Z"
}