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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

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"
}