---
title: "Refund details for OrderID"
method: GET
path: "/api/v1/refund/by/orderId/{orderId}"
tags: ["Additional API functionality"]
---

# Refund details for OrderID

`GET /api/v1/refund/by/orderId/{orderId}`

## Request

- Base URL: `https://sandbox.przelewy24.pl`
- URL: `https://sandbox.przelewy24.pl/api/v1/refund/by/orderId/{orderId}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation/docs/api/v1/refund/by/orderId/:orderId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns refund details based on the transaction ID.

## Path parameters

- `orderId` integer, required

## Response `200`

OK - the request was processed successfully. The `data` parameter contains the refund data.

- TransactionRefundsInfoResponse
  - `data` TransactionWithRefundsResponse
    - `orderId` integer
    - `sessionId` string
    - `amount` integer
    - `currency` string
    - `refunds` RefundsCollection[]
      - `batchId` integer
      - `requestId` string
      - `date` string
      - `login` string
      - `description` string
      - `status` integer: Refund status:<br>`1` - completed;<br>`2` - pending execution;<br>`3` - awaiting P24 approval;<br>`4` - rejected.
      - `amount` integer
  - `responseCode` number

## Other responses

- `401`: Unauthorized
- `404`: Not Found - no refund was found for the specified `orderId`.
- `500`: Internal Server Error

## Changes

- **2026-09-03** `5861a691aa36`: 3 breaking, 1 info
  - the response's body type changed from no type to `object` for status `200`
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `404`
  - api operation id `getRefundByOrderId` was added

[Operation history](https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation/changes/api/v1/refund/by/orderId/:orderId/get.md)

---

[API](https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation.md) - [All operations](https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/przelewy24/apis/przelewy24-rest-api-documentation/revisions/5861a691aa36?raw)