# CRUD: Retrieve a refund

Endpoint: GET /v1/object/refund/{id}
Version: 2025-12-17

## Header parameters:

  - `Accept-Encoding` (string)
    Include the Accept-Encoding: gzip header to compress responses as a gzipped file. It can significantly reduce the bandwidth required for a response. 

If specified, Zuora automatically compresses responses that contain over 1000 bytes of data, and the response contains a Content-Encoding header with the compression algorithm so that your client can decompress it.

  - `Content-Encoding` (string)
    Include the Content-Encoding: gzip header to compress a request. With this header specified, you should upload a gzipped file for the request payload instead of sending the JSON payload.

  - `Authorization` (string)
    The value is in the Bearer {token} format where {token} is a valid OAuth token generated by calling Create an OAuth token.

  - `Zuora-Entity-Ids` (string)
    An entity ID. If you have Zuora Multi-entity enabled and the OAuth token is valid for more than one entity, you must use this header to specify which entity to perform the operation in. If the OAuth token is only valid for a single entity, or you do not have Zuora Multi-entity enabled, you do not need to set this header.

  - `Zuora-Track-Id` (string)
    A custom identifier for tracing the API call. If you set a value for this header, Zuora returns the same value in the response headers. This header enables you to associate your system process identifiers with Zuora API calls, to assist with troubleshooting in the event of an issue.

The value of this field must use the US-ASCII character set and must not include any of the following characters: colon (:), semicolon (;), double quote ("), and quote (').

## Query parameters:

  - `fields` (string)
    Object fields to return

## Path parameters:

  - `id` (string, required)
    Object id

## Response 200 fields (application/json):

  - `AccountId` (string)
    The ID of the account associated with this refund. Specify a value for this field only if you're creating an electronic non-referenced refund. Don't specify a value for any other type of refund; Zuora associates the refund automatically with the account from the associated payment.
Character limit: 32 Values: a valid account ID

  - `AccountingCode` (string)
    The accounting code for the payment or invoice line item that the refund applies to. If there is no accounting code, then this value is null. Accounting codes group transactions that contain similar accounting attributes.
Character limit: 50 Values: automatically generated

  - `Amount` (number)
    The amount of the refund. The amount can't exceed the amount of the associated payment. If the original payment was applied to a single invoice, you can create a partial refund by specifying an amount in this field or through the UI. If the payment was applied to multiple invoices, you can create a partial refund by using the RefundInvoicePaymentData field of this operation or through the UI.
Character limit: 16 Values: a valid currency amount

  - `CancelledOn` (string)
    The date the refund was cancelled.
Values: automatically generated

  - `Comment` (string)
    Use this field to record comments about the refund.
Character limit: 255 Values: a string of 255 characters or fewer

  - `CreatedById` (string)
    The ID of the Zuora user who created the Refund object.
Character limit: 32 Values: automatically generated

  - `CreatedDate` (string)
    The date when the Refund object was created.
Character limit: 29 Values: automatically generated

  - `Gateway` (string)
    The gateway that processed the original payment. Zuora uses this same gateway for the corresponding refund. If this payment gateway is no longer active, then the electronic refund fails. A gateway is an online service provider that connects an online shopping cart to a payment processor.
Values: automatically inherited from the Payment object

  - `GatewayResponse` (string)
    The message returned from the payment gateway for the refund. This message is gateway-dependent.
Character limit: 500 Values: automatically generated

  - `GatewayResponseCode` (string)
    The code returned from the payment gateway for the payment. This code is gateway-dependent.
Character limit: 20 SystemValues: automatically generated

  - `GatewayState` (string)
    The status of the payment in the gateway.
Character limit: 19 Values: automatically generated

  - `Id` (string)
    Object identifier.

  - `MarkedForSubmissionOn` (string)
    The date when a payment was marked and waiting for batch submission to the payment process. Character limit: 29 Values: automatically generated

  - `MethodType` (string)
    Indicates how an external refund was issued to a customer. This field is required for an external refund. You can issue an external refund on an electronic payment. Character limit: 30 Values:

- ACH
- Cash
- Check
- CreditCard
- Other
- PayPal
- WireTransfer
- DebitCard
- CreditCardReferenceTransaction

  - `PaymentMethodId` (string)
    The unique ID of the payment method that the customer used to make the payment. Specify a value for this field only if you're creating an electronic non-referenced refund.
Character limit: 32 Values: a valid payment method ID

  - `PaymentMethodSnapshotId` (string)
    The unique ID of the payment method snapshot which is a copy of the particular Payment Method used in a transaction.
Character limit: 32 Values: a valid payment method snapshot ID

  - `ReasonCode` (string)
    A code identifying the reason for the transaction. Must be an existing reason code or empty. If you do not specify a value, Zuora uses the default reason code.
Character limit: 32 Values: a valid reason code

  - `ReferenceID` (string)
    The transaction ID returned by the payment gateway for an electronic refund. Use this field to reconcile refunds between your gateway and Zuora Payments.
Character limit: 60 Values: a string of 60 characters or fewer

  - `RefundDate` (string)
    The date of the refund, in yyyy-mm-dd format. The date of the refund cannot be before the payment date. Specify this field only for external refunds. Zuora automatically generates this field for electronic refunds.
Character limit: 29

  - `RefundNumber` (string)
    The unique identifier of the refund.
Character limit: 50 Values: automatically generated

  - `RefundTransactionTime` (string)
    The date and time when the refund was issued.
Character limit: 29 Values: automatically generated

  - `SecondRefundReferenceId` (string)
    The transaction ID returned by the payment gateway if there is an additional transaction for the payment. Use this field to reconcile payments between your gateway and Zuora Payments.
Character limit: 60 Values: a string of 60 characters or fewer

  - `SettledOn` (string)
    The date when the payment was settled in the payment processor. This field is used by the Spectrum gateway only and not applicable to other gateways.
Character limit: 29 Values: automatically generated

  - `SoftDescriptor` (string)
    A payment gateway-specific field that maps Zuora to other gateways . Character limit: 35 Values:

- 3-byte company identifier "*" 18-byte descriptor
- 7-byte company identifier "*" 14-byte descriptor
- 12-byte company identifier "*" 9-byte descriptor

  - `SoftDescriptorPhone` (string)
    A payment gateway-specific field that maps Zuora to other gateways . Character limit: 20 Values:

- Customer service phone number formatted as: NNN-NNN-NNNN or NNN-AAAAAAA
- URL (non-e-Commerce): Transactions sent with a URL do not qualify for the best interchange rate
- Email address

  - `SourceType` (string)
    Specifies whether the refund is a refund payment or a credit balance. This field is required when creating an non-referenced refund. If you creating an non-referenced refund, then set this value to CreditBalance.
Character limit: 13 Values:

- Payment
- CreditBalance

  - `Status` (string)
    The status of the refund.
Character limit: 10 Values: automatically generated:

- Canceled
- Error
- Processed
- Processing

  - `SubmittedOn` (string)
    The date when the payment was submitted.
Character limit: 29 Values: automatically generated

  - `TransferredToAccounting` (string)
    Specifies whether or not the object has been transferred to an external accounting system. Use this field for integrations with accounting systems such as NetSuite.
Character limit: 10 Values: automatically generated:

- Processing
- Yes
- Error
- Ignore

  - `Type` (string)
    Specifies if the refund is electronic or external.
Character limit: 10 Values:

- Electronic
- External

  - `UpdatedById` (string)
    The ID of the last user to update the object.
Character limit: 32 Values: automatically generated

  - `UpdatedDate` (string)
    The date when the object was last updated.
Character limit: 29 Values: automatically generated

  - `IntegrationId__NS` (string)
    ID of the corresponding object in NetSuite. Only available if you have installed the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).

  - `IntegrationStatus__NS` (string)
    Status of the refund's synchronization with NetSuite. Only available if you have installed the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).

  - `Origin__NS` (string)
    Origin of the corresponding object in NetSuite. Only available if you have installed the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).

  - `SyncDate__NS` (string)
    Date when the refund was synchronized with NetSuite. Only available if you have installed the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).

  - `SynctoNetSuite__NS` (string)
    Specifies whether the refund should be synchronized with NetSuite. Only available if you have installed the [Zuora Connector for NetSuite](https://www.zuora.com/connect/app/?appId=265).

## Response 401 fields (application/json):

  - `message` (string)
    Error message.

If the error message is "Authentication error", ensure that the Authorization request header contains valid authentication credentials, then retry the request. See [Authentication](https://developer.zuora.com/rest-api/general-concepts/authentication/) for more information.

If the error message is "Failed to get user info", retry the request.

## Response 404 fields (application/json):

  - `done` (boolean)

  - `records` (array)

  - `size` (integer)