eBay Post-Order APIVersion 2.7.1

• Home
• All Docs
• Support
• Knowledge Base
• Forums
• Resources

• Features Guide
• Usage Guide
• Making a Call
• API Reference
• Tutorials
• Release Notes

Get Inquiry

GET /post-order/v2/inquiry/{inquiryId}

Retrieves details about the specified inquiry and a summary of the activity to date with respect to the specified inquiry. The summary includes any actions taken by the buyer, the seller, the Inquiry service, or customer support representatives.

Input Output Samples Change History

Input

See also Samples.

Resource URI (production)

GET https://api.ebay.com/post-order/v2/inquiry/{inquiryId}

URI parameters

Parameter	Type	Required?	Meaning
inquiryId	string	Required	The unique ID of the inquiry for which details and history are to be retrieved. Note: This is the value that was returned by the POST /post-order/v2/inquiry/ call in an HTTP location code: /post-order/v2/inquiry/{INQUIRYID}, in which INQUIRYID identifies the newly created inquiry.

HTTP request headers

All requests made to eBay REST operations require you to provide the authorization HTTP header for authentication.
See HTTP request headers for details.

Authorization

This call uses standard authorization tokens. See Making a Call for details.

Payload model

This call has no request payload.

Input Output Samples Change History

Output

See also Samples.

Payload model

Note: For information about the error fields and how to work with them, see Error Handling.

The following lists all fields that could be included in the response.

{ /* InquiryDetailsResponse */
"claimAmount":
    { /* Amount */
    "convertedFromCurrency": string,
    "convertedFromValue": number,
    "currency": string,
    "exchangeRate": string,
    "value": number
    },
"creationReason": string,
"extTransactionId": string,
"initiator": string,
"inquiryClosureDate":
    { /* DateTime */
    "formattedValue": string,
    "value": datetime
    },
"inquiryDetails":
    { /* InquiryDetails */
    "appealDetails":
        { /* AppealDetails */
        "appealCloseReasonEnum": token,
        "appealDate":
            { /* DateTime */
            "formattedValue": string,
            "value": datetime
            },
        "appealReasonCode": string,
        "appealRefundAmount":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": number,
            "currency": string,
            "exchangeRate": string,
            "value": number
            },
        "appealStatus": token,
        "appealStatusEnum": string,
        "eligibleForAppeal": boolean
        },
    "creationDate":
        { /* DateTime */
        "formattedValue": string,
        "value": datetime
        },
    "escalationDate":
        { /* DateTime */
        "formattedValue": string,
        "value": datetime
        },
    "expirationDate":
        { /* DateTime */
        "formattedValue": string,
        "value": datetime
        },
    "lastBuyerRespDate":
        { /* DateTime */
        "formattedValue": string,
        "value": datetime
        },
    "refundAmounts":
        { /* RefundAmounts */
        "buyerFinalAcceptRefundAmt":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": number,
            "currency": string,
            "exchangeRate": string,
            "value": number
            },
        "buyerInitExpectRefundAmt":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": number,
            "currency": string,
            "exchangeRate": string,
            "value": number
            },
        "feeCreditAmount":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": number,
            "currency": string,
            "exchangeRate": string,
            "value": number
            },
        "internationalRefundAmount":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": number,
            "currency": string,
            "exchangeRate": string,
            "value": number
            },
        "refundAmount":
            { /* Amount */
            "convertedFromCurrency": string,
            "convertedFromValue": number,
            "currency": string,
            "exchangeRate": string,
            "value": number
            }
        },
    "refundChargeAmount":
        { /* Amount */
        "convertedFromCurrency": string,
        "convertedFromValue": number,
        "currency": string,
        "exchangeRate": string,
        "value": number
        },
    "refundDeadlineDate":
        { /* DateTime */
        "formattedValue": string,
        "value": datetime
        },
    "totalAmount":
        { /* Amount */
        "convertedFromCurrency": string,
        "convertedFromValue": number,
        "currency": string,
        "exchangeRate": string,
        "value": number
        }
    },
"inquiryHistoryDetails":
    { /* ClaimHistoryResponse */
    "history": [
        { /* ClaimHistoryEventModel */
        "action": string,
        "actor": string,
        "date":
            { /* DateTime */
            "formattedValue": string,
            "value": datetime
            },
        "description": string,
        "moneyMovement":
            { /* MoneyMovementEntries */
            "moneyMovementEntryList": [
                { /* MoneyMovementEntry */
                "amount":
                    { /* Amount */
                    "convertedFromCurrency": string,
                    "convertedFromValue": number,
                    "currency": string,
                    "exchangeRate": string,
                    "value": number
                    },
                "date":
                    { /* DateTime */
                    "formattedValue": string,
                    "value": datetime
                    },
                "fundingSource":
                    { /* FundingSource */
                    "brand": string,
                    "memo": string,
                    "type": string
                    },
                "fundingStatus": string,
                "type": string
                }
                /* More MoneyMovementEntry nodes here */
              ]
            }
        }
        /* More ClaimHistoryEventModel nodes here */
      ],
    "shipmentTrackingDetails":
        { /* ShipmentTrackingDetailType */
        "carrier": string,
        "currentStatus": string,
        "estimateFromDate":
            { /* DateTime */
            "formattedValue": string,
            "value": datetime
            },
        "estimateToDate":
            { /* DateTime */
            "formattedValue": string,
            "value": datetime
            },
        "trackingNumber": string,
        "trackingURL": string
        }
    },
"inquiryId": string,
"inquiryQuantity": integer,
"itemDetails":
    { /* ItemDetails */
    "itemPictureUrl": string,
    "itemPrice":
        { /* Amount */
        "convertedFromCurrency": string,
        "convertedFromValue": number,
        "currency": string,
        "exchangeRate": string,
        "value": number
        },
    "itemTitle": string,
    "viewPurchasedItemUrl": string
    },
"itemId": string,
"returnDetails":
    { /* ReturnAddress */
    "address":
        { /* Address */
        "addressLine1": string,
        "addressLine2": string,
        "addressType": string,
        "city": string,
        "country": string,
        "county": string,
        "isTransliterated": boolean,
        "nationalRegion": string,
        "postalCode": string,
        "script": string,
        "stateOrProvince": string,
        "transliteratedFromScript": string,
        "worldRegion": string
        },
    "editable": boolean,
    "firstName": string,
    "lastName": string,
    "RMA": string
    },
"sellerMakeItRightByDate":
    { /* DateTime */
    "formattedValue": string,
    "value": datetime
    },
"shippingCost":
    { /* Amount */
    "convertedFromCurrency": string,
    "convertedFromValue": number,
    "currency": string,
    "exchangeRate": string,
    "value": number
    },
"state": token,
"status": token,
"transactionId": string,
"viewPPTrasanctionUrl": string
}

Response field descriptions

Output Container/Field	Type	Occurrence	Meaning
claimAmount	Amount	Always	This container displays the dollar value of the order line item associated with the inquiry, which is generally the amount of the refund that the buyer will receive if the buyer is looking for a refund, or if the seller voluntarily refunds the buyer. Note: There's a possibility that this value can be inaccurate if the buyer passed in an inaccurate value into the claimQuantity field when the inquiry was created.
claimAmount   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
claimAmount.convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
claimAmount.currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
claimAmount.exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
claimAmount.value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
creationReason	string	Always	The enumeration value in this field indicates why the buyer created an INR inquiry for the line item. Applicable values are from INRCreationReasonEnum:See creationReason. Code so that your app gracefully handles any future changes to this list.
extTransactionId	string	Conditionally	This string value is the unique identifier of the payment transaction for the order.
initiator	string	Always	The party who created this inquiry. In most cases, this value will be BUYER, but the UserPartyEnum type has the complete list of possible values. Applicable values are from UserPartyEnum: BUYER The buyer initiated the action. CSR An eBay customer support representative initiated the action. SELLER The seller initiated the action. SYSTEM The eBay commerce platform initiated the action. UNKNOWN The initiator of the action cannot be identified. Code so that your app gracefully handles any future changes to this list.
inquiryClosureDate	DateTime	Conditionally	Contains a timestamp indicating when the inquiry was closed.
inquiryClosureDate   .formattedValue	string	Conditionally	Reserved for future use.
inquiryClosureDate.value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryDetails	InquiryDetails	Conditionally	Contains the details of the specified inquiry.
inquiryDetails.appealDetails	AppealDetails	Conditionally	This container consists of information related to the appeal of a case decision. This container is only returned for a inquiry that was escalated into a case.
inquiryDetails.appealDetails   .appealCloseReasonEnum	token	Conditionally	This enumeration value indicates why the appeal on the case decision was closed. This field will only be returned if an appeal was made on a case decision and this appeal was closed. Applicable values: See AppealCloseReasonEnum
inquiryDetails.appealDetails   .appealDate	DateTime	Conditionally	This timestamp indicates the date and time when the appeal was made. This field will only be returned if an appeal was made on the case decision.
inquiryDetails.appealDetails   .appealDate.formattedValue	string	Conditionally	Reserved for future use.
inquiryDetails.appealDetails   .appealDate.value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryDetails.appealDetails   .appealReasonCode	string	Conditionally	This string value is a string representation of why the buyer or seller appealed the case decision. This field is only returned if the buyer or seller has made an appeal on the case decision.
inquiryDetails.appealDetails   .appealRefundAmount	Amount	Conditionally	This field shows the total amount refunded to the seller if the seller wins an appeal on a case decision. The value will be in the seller's default currency.
inquiryDetails.appealDetails   .appealRefundAmount   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.appealDetails   .appealRefundAmount   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
inquiryDetails.appealDetails   .appealRefundAmount.currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.appealDetails   .appealRefundAmount   .exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
inquiryDetails.appealDetails   .appealRefundAmount.value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
inquiryDetails.appealDetails   .appealStatus	token	Conditionally	This enumeration value indicates whether or not eBay has accepted the buyer's or seller's appeal on the case decision. This field is only returned if the buyer or seller has attempted to make an appeal on the case decision. Applicable values: See AppealGrantStatusEnum
inquiryDetails.appealDetails   .appealStatusEnum	string	Conditionally	This enumeration value indicates the current status of the appeal against the case decision. Applicable values are from AppealStatusEnum:See appealStatusEnum. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.appealDetails   .eligibleForAppeal	boolean	Conditionally	This Boolean field will be returned as true if the buyer or seller is eligible to appeal the decision on the case.
inquiryDetails.creationDate	DateTime	Always	This timestamp indicates when the inquiry was created by the buyer.
inquiryDetails.creationDate   .formattedValue	string	Conditionally	Reserved for future use.
inquiryDetails.creationDate   .value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryDetails.escalationDate	DateTime	Conditionally	This timestamp indicates when the inquiry was escalated to a case. This field is not returned if the inquiry was not escalated.
inquiryDetails.escalationDate   .formattedValue	string	Conditionally	Reserved for future use.
inquiryDetails.escalationDate   .value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryDetails.expirationDate	DateTime	Always	This timestamp indicates when the inquiry will naturally expire if no further action is taken.
inquiryDetails.expirationDate   .formattedValue	string	Conditionally	Reserved for future use.
inquiryDetails.expirationDate   .value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryDetails   .lastBuyerRespDate	DateTime	Always	This timestamp indicates when the buyer last responded to, or performed an action on the inquiry.
inquiryDetails   .lastBuyerRespDate   .formattedValue	string	Conditionally	Reserved for future use.
inquiryDetails   .lastBuyerRespDate.value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryDetails.refundAmounts	RefundAmounts	Conditionally	This container consists of details related to the expected and actual refund amounts. This container is only returned if a refund is scheduled to, or has been issued to the buyer.
inquiryDetails.refundAmounts   .buyerFinalAcceptRefundAmt	Amount	Conditionally	The amount of money finally accepted as a refund by the buyer.
inquiryDetails.refundAmounts   .buyerFinalAcceptRefundAmt   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .buyerFinalAcceptRefundAmt   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
inquiryDetails.refundAmounts   .buyerFinalAcceptRefundAmt   .currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .buyerFinalAcceptRefundAmt   .exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
inquiryDetails.refundAmounts   .buyerFinalAcceptRefundAmt   .value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
inquiryDetails.refundAmounts   .buyerInitExpectRefundAmt	Amount	Conditionally	The amount of money initially expected as a refund by the buyer.
inquiryDetails.refundAmounts   .buyerInitExpectRefundAmt   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .buyerInitExpectRefundAmt   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
inquiryDetails.refundAmounts   .buyerInitExpectRefundAmt   .currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .buyerInitExpectRefundAmt   .exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
inquiryDetails.refundAmounts   .buyerInitExpectRefundAmt   .value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
inquiryDetails.refundAmounts   .feeCreditAmount	Amount	Conditionally	This container shows the total amount of fees credited towards this refund as per eBay policy. This field is only applicable to managed payments orders.
inquiryDetails.refundAmounts   .feeCreditAmount   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .feeCreditAmount   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
inquiryDetails.refundAmounts   .feeCreditAmount.currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .feeCreditAmount.exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
inquiryDetails.refundAmounts   .feeCreditAmount.value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
inquiryDetails.refundAmounts   .internationalRefundAmount	Amount	Conditionally	The amount of the refund issued by the seller that applies to the international leg of a Global Shipping Program shipment.
inquiryDetails.refundAmounts   .internationalRefundAmount   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .internationalRefundAmount   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
inquiryDetails.refundAmounts   .internationalRefundAmount   .currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .internationalRefundAmount   .exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
inquiryDetails.refundAmounts   .internationalRefundAmount   .value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
inquiryDetails.refundAmounts   .refundAmount	Amount	Conditionally	The amount of the refund that the seller issued.
inquiryDetails.refundAmounts   .refundAmount   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .refundAmount   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
inquiryDetails.refundAmounts   .refundAmount.currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.refundAmounts   .refundAmount.exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
inquiryDetails.refundAmounts   .refundAmount.value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
inquiryDetails   .refundChargeAmount	Amount	Conditionally	This field shows the total amount charged to the seller for this refund. The value will be in the seller's default currency. This container is only applicable to managed payments orders, and is only returned if a refund has been issued to the buyer.
inquiryDetails   .refundChargeAmount   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails   .refundChargeAmount   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
inquiryDetails   .refundChargeAmount.currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails   .refundChargeAmount   .exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
inquiryDetails   .refundChargeAmount.value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
inquiryDetails   .refundDeadlineDate	DateTime	Conditionally	This timestamp indicates when the seller is required to issue a refund for the INR inquiry. This container is only returned if the buyer is seeking a full refund and no longer wants the missing item.
inquiryDetails   .refundDeadlineDate   .formattedValue	string	Conditionally	Reserved for future use.
inquiryDetails   .refundDeadlineDate.value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryDetails.totalAmount	Amount	Always	The total cost of the order, including the item price and shipping fees. This will generally be the amount that the buyer will expect to receive if the buyer is seeking a full refund for the missing item.
inquiryDetails.totalAmount   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.totalAmount   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
inquiryDetails.totalAmount   .currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
inquiryDetails.totalAmount   .exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
inquiryDetails.totalAmount   .value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
inquiryHistoryDetails	ClaimHistoryResponse	Always	Contains information about the events and actions that occurred throughout the course of the specified inquiry.
inquiryHistoryDetails.history	array of ClaimHistoryEventModel	Always	Contains details about the previous events and actions regarding this case or inquiry.
inquiryHistoryDetails.history   .action	string	Always	The action initiated by one of the parties involved with the inquiry or case.
inquiryHistoryDetails.history   .actor	string	Always	The party that took this action. Applicable values are from UserPartyEnum: BUYER The buyer initiated the action. CSR An eBay customer support representative initiated the action. SELLER The seller initiated the action. SYSTEM The eBay commerce platform initiated the action. UNKNOWN The initiator of the action cannot be identified. Code so that your app gracefully handles any future changes to this list.
inquiryHistoryDetails.history   .date	DateTime	Always	Contains a timestamp indicating the date of this event or action.
inquiryHistoryDetails.history   .date.formattedValue	string	Conditionally	Reserved for future use.
inquiryHistoryDetails.history   .date.value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryHistoryDetails.history   .description	string	Conditionally	A description of this event or action. This field is returned if available.
inquiryHistoryDetails.history   .moneyMovement	MoneyMovementEntries	Conditionally	Contains information about the transfers of money associated with this event or action. This field is not returned if no money was transferred.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList	array of MoneyMovementEntry	Conditionally	Contains details about the transfers of money associated with the current action on the inquiry or case. This container is only returned if there were monetary transactions that occurred with the current action.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.amount	Amount	Conditionally	The amount of money transferred.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.amount   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.amount   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.amount   .currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.amount   .exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.amount   .value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.date	DateTime	Conditionally	Contains a timestamp indicating the date of the transfer.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.date   .formattedValue	string	Conditionally	Reserved for future use.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.date   .value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList   .fundingSource	FundingSource	Conditionally	This container provides details about the seller's funding source to issue the refund, such as a bank account, a credit card, or available seller payout funds. This container is only returned if the monetary transaction is a buyer refund, and the seller's account is enabled for eBay managed payments.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList   .fundingSource.brand	string	Conditionally	The enumeration value here indicates the brand of credit card used to fund the refund. Currently, this field is only returned if the funding source type is CREDIT_CARD. Applicable values are from FundingMethodBrandEnum: AMERICAN_EXPRESS This enumeration value indicates that a American Express credit card will be used to fund the refund to the buyer. DISCOVER This enumeration value indicates that a Discover credit card will be used to fund the refund to the buyer. MASTERCARD This enumeration value indicates that a Mastercard credit card will be used to fund the refund to the buyer. VISA This enumeration value indicates that a Visa credit card will be used to fund the refund to the buyer. Code so that your app gracefully handles any future changes to this list.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList   .fundingSource.memo	string	Conditionally	This provides a note about the funding source. This field is only returned if available.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList   .fundingSource.type	string	Conditionally	The enumeration value here indicates the type of funding source. Applicable values are from FundingMethodTypeEnum: AVAILABLE_FUNDS This enumeration value indicates that the refund will be funded by the seller's available payout funds that have not yet been deposited into the seller's bank account. CREDIT_CARD This enumeration value indicates that the seller's credit card will be used to fund the buyer's refund. DIRECT_DEBIT This enumeration value indicates that the seller's bank account on file will be debited to fund the buyer's refund. PAY_UPON_INVOICE This enumeration value indicates that the eBay will cover the buyer's refund, but will bill the seller on the seller's monthly invoice. Code so that your app gracefully handles any future changes to this list.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList   .fundingStatus	string	Conditionally	This enumeration value indicates if eBay was able to successfully 'fund' a refund to the buyer using the seller's preferred method of payment for refunds. This field is only returned if the monetary transaction is a refund, and the seller's account is enabled for eBay managed payments. Applicable values are from FundingStatusEnum: FAILED This enumeration value indicates that the refund was not successfully funded, which can mean there were insufficient funds in the account, or that the transaction was blocked for another reason. FUNDED This enumeration value indicates that the buyer refund was successfully funded. Code so that your app gracefully handles any future changes to this list.
inquiryHistoryDetails.history   .moneyMovement   .moneyMovementEntryList.type	string	Conditionally	The purpose of the monetary transaction.
inquiryHistoryDetails   .shipmentTrackingDetails	ShipmentTrackingDetailType	Conditionally	Contains information for monitoring the shipment of the order associated with this case or inquiry. This container is only returned if shipment tracking is currently relevant to the inquiry or case.
inquiryHistoryDetails   .shipmentTrackingDetails   .carrier	string	Conditionally	The name of the shipping carrier handling the shipment. This field is generally always returned with the shipmentTrackingDetails container unless the tracking number has yet to be provided for the order line item.
inquiryHistoryDetails   .shipmentTrackingDetails   .currentStatus	string	Conditionally	The current status of the shipment, such as delivered or still in-transit. This field is returned if it is known and available.
inquiryHistoryDetails   .shipmentTrackingDetails   .estimateFromDate	DateTime	Conditionally	The earliest date that the shipment is estimated to be delivered, based on the shipping service being used, the stated handling time, and when the package was shipped. This field is returned if it is known and available.
inquiryHistoryDetails   .shipmentTrackingDetails   .estimateFromDate   .formattedValue	string	Conditionally	Reserved for future use.
inquiryHistoryDetails   .shipmentTrackingDetails   .estimateFromDate.value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryHistoryDetails   .shipmentTrackingDetails   .estimateToDate	DateTime	Conditionally	The latest date that the shipment is estimated to be delivered, based on the shipping service being used, the stated handling time, and when the package was shipped. If the package is not received by this date, the buyer or seller should contact their order partner to get status, and then ask eBay to step in if the problem cannot be resolved. This field is returned if it is known and available.
inquiryHistoryDetails   .shipmentTrackingDetails   .estimateToDate.formattedValue	string	Conditionally	Reserved for future use.
inquiryHistoryDetails   .shipmentTrackingDetails   .estimateToDate.value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
inquiryHistoryDetails   .shipmentTrackingDetails   .trackingNumber	string	Conditionally	A unique identifier used to track the shipment of the order line item. This field is generally always returned with the shipmentTrackingDetails container unless the tracking number has yet to be provided for the order line item.
inquiryHistoryDetails   .shipmentTrackingDetails   .trackingURL	string	Conditionally	This field provides the URL to the shipping carrier's shipment tracking page. This field is returned if available.
inquiryId	string	Always	The unique identifier of the inquiry for which details have been retrieved. All information returned in the response is relevant to this specific inquiry.
inquiryQuantity	integer	Always	This integer is the quantity of the line item purchased by the buyer. This value is the same value passed into the claimQuantity field when the inquiry was created. If the claimQuantity field was omitted when the inquiry was created, this value defaults to 1.
itemDetails	ItemDetails	Always	This container consists of details related to the item associated with the INR inquiry, including the item title, price, and the URL of the item picture.
itemDetails.itemPictureUrl	string	Conditionally	This field provides the URL where the picture of the item may be viewed. This field is returned when available.
itemDetails.itemPrice	Amount	Always	The final price of the item, or the amount of money that the buyer agreed to pay for the item.
itemDetails.itemPrice   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
itemDetails.itemPrice   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
itemDetails.itemPrice.currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
itemDetails.itemPrice   .exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
itemDetails.itemPrice.value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
itemDetails.itemTitle	string	Always	The title of the listing.
itemDetails   .viewPurchasedItemUrl	string	Conditionally	This field provides the URL to the item purchase page. This field is returned when available.
itemId	string	Always	The unique identifier for the eBay listing where the item was purchased. This field is used in conjunction with the transactionId field to identify a line item within an order.
returnDetails	ReturnAddress	Conditionally	This container consists of information related to a buyer returning an order to the seller, including the seller's address and the RMA number (if applicable). This container is only returned under the following circumstances: The INR inquiry was escalated to a case. The seller already shipped the order line item The buyer's desired outcome upon creating the INR inquiry was to get a full refund for the missing order line item
returnDetails.address	Address	Conditionally	Contains the the full return address.
returnDetails.address   .addressLine1	string	Conditionally	The first line of the street address. The first line of the street address is always used by containers using the Address type.
returnDetails.address   .addressLine2	string	Conditionally	The second line of the street address. This field is not always used, but it should be provided in the POST /post-order/v2/casemanagement/{caseId}/provide_return_address call if applicable. It might be used for something like 'Suite Number' or 'Apt Number'.
returnDetails.address   .addressType	string	Conditionally	This enumeration value indicates whether the address is a business, a personal address, or a PO Box. This field is not always used by containers using the Address type. Applicable values are from AddressTypeEnum:See addressType. Code so that your app gracefully handles any future changes to this list.
returnDetails.address.city	string	Conditionally	The city of the address. This field is always used by containers using the Address type.
returnDetails.address.country	string	Conditionally	This enumeration value indicates the country of the address. The three-letter country codes of the ISO 3166-1 Standard are used. This field is always used by containers using the Address type. Applicable values are from CountryCodeEnum:See country. Code so that your app gracefully handles any future changes to this list.
returnDetails.address.county	string	Conditionally	The county of the address. This field is not always used, but it should be provided in the POST /post-order/v2/casemanagement/{caseId}/provide_return_address call if applicable.
returnDetails.address   .isTransliterated	boolean	Conditionally	This Boolean field is returned as 'true' if language transliteration was required.
returnDetails.address   .nationalRegion	string	Conditionally	This string value indicates a specific region or metropolitan area within a county in which the address resides. Not all countries have defined national regions.
returnDetails.address   .postalCode	string	Conditionally	The postal code of the address. This field is always used by containers using the Address type.
returnDetails.address.script	string	Conditionally	This enumeration value indicates the language that the address has been transliterated into. This field is only returned if transliteration was required (and the isTransliterated field is 'true'. Transliteration is required for languages that use special characters, such as Japanese, Chinese, or Arabic. Applicable values are from LanguageScriptEnum:See script. Code so that your app gracefully handles any future changes to this list.
returnDetails.address   .stateOrProvince	string	Conditionally	The state or province of the address. This field is always used by containers using the Address type.
returnDetails.address   .transliteratedFromScript	string	Conditionally	This enumeration value indicates the language that the address has been transliterated from. This field is only returned if transliteration was required (and the isTransliterated field is 'true'. Transliteration is required for languages that use special characters, such as Japanese, Chinese, or Arabic. Applicable values are from LanguageScriptEnum:See transliteratedFromScript. Code so that your app gracefully handles any future changes to this list.
returnDetails.address   .worldRegion	string	Conditionally	This string value indicates the region of the world in which the address resides. Values you'll see in this field include 'NORTH_AMERICA', 'EUROPEAN_UNION', or 'AUSTRALIA'. This field is not always used by containers using the Address type. Applicable values are from WorldRegionEnum:See worldRegion. Code so that your app gracefully handles any future changes to this list.
returnDetails.editable	boolean	Conditionally	A value of true indicates that the return address can be edited.
returnDetails.firstName	string	Conditionally	The first name associated with the return address, or if applicable, a business name.
returnDetails.lastName	string	Conditionally	The last name associated with the return address. This field will only be returned if applicable.
returnDetails.RMA	string	Conditionally	The return merchandise authorization (RMA) identifier authorizing this return. This field is only returned if an RMA number exists for the order line item.
sellerMakeItRightByDate	DateTime	Always	Contains a timestamp indicating when the seller is expected to resolve this inquiry.
sellerMakeItRightByDate   .formattedValue	string	Conditionally	Reserved for future use.
sellerMakeItRightByDate.value	datetime	Conditionally	The date and time defining the start or end of an action or event. The timestamp is formatted as an ISO 8601 string, which is based on the 24-hour Coordinated Universal Time (UTC) clock. Format: [YYYY]-[MM]-[DD]T[hh]:[mm]:[ss].[sss]Z Example: 2020-08-20T00:00:00.000Z
shippingCost	Amount	Conditionally	The cost of shipping the order line item associated with this inquiry.
shippingCost   .convertedFromCurrency	string	Conditionally	The three-letter ISO 4217 code representing the currency of the amount in the convertedFromValue field. This value is the pre-conversion currency. If no conversion occurs, this should not be populated. Applicable values are from CurrencyCodeEnum:See convertedFromCurrency. Code so that your app gracefully handles any future changes to this list.
shippingCost   .convertedFromValue	number	Conditionally	The monetary amount before any conversion is performed, in the currency specified by the convertedFromCurrency field. This value is the pre-conversion amount. The value field contains the converted amount of this value, in the currency specified by the currency field. If no conversion occurs, this should not be populated.
shippingCost.currency	string	Conditionally	A three-letter ISO 4217 code that indicates the currency of the amount in the value field. This field is always returned with any container using Amount type. Default: The currency of the authenticated user's country. Applicable values are from CurrencyCodeEnum:See currency. Code so that your app gracefully handles any future changes to this list.
shippingCost.exchangeRate	string	Conditionally	This field shows the exchange rate used to convert the amount in the convertedFromValue field to amount in the value field. This field is only returned when eBay does a currency version.
shippingCost.value	number	Conditionally	The monetary amount, in the currency specified by the currency field. This field is always returned with any container using Amount type.
state	token	Always	Indicates the current state of the INR inquiry. Applicable values: See InquiryStateEnum
status	token	Always	Indicates the current status of the INR inquiry. Applicable values: See InquiryStatusEnum
transactionId	string	Always	The unique identifier for the purchase of a item. This value is created right when the buyer is committed to buying the item, whether that buyer uses a 'Buy it Now' capability, is the winning bidder of an auction, or the buyer's Best Offer is accepted by the seller. This field is used in conjunction with the itemId field to identify a line item within an order.
viewPPTrasanctionUrl	string	Conditionally	This string value is the link to PayPal transaction page. This field is only returned if the payment method was PayPal and if the page is available.

null

Input Output Samples Change History

Samples

New to making API calls? Please see Making a Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Available samples:

• Get Inquiry Details ↓ - This operation returns information about an INR inquiry.
• Refund for an incomplete order ↓ - Retrieve an INR inquiry for a cross-border trade line item.

This operation returns information about an INR inquiry.

Description

Use this operation to retrieve full details about the inquiry, including any actions taken by the buyer, the seller, the Inquiry service, and eBay customer support representatives.

Input

There is no input payload with this request. Supply the inquiry ID as a path parameter in the call.

URL format. See also the non-wrapped version of this URL.

GET https://api.ebay.com/post-order/v2/inquiry/5********9

Output

The information returned by this operation includes the amount (EUR 131) that this claim is worth to the buyer; the identity of the inquiry's initiator (the buyer); the identity, details, and number of units in the order line item; the deadline for the seller to resolve this inquiry; the current status of this inquiry; as well as shipment tracking details, and the various events and actions taken to date with regard to this inquiry. The key dates, amounts, and appeal information for this inquiry are also returned.

JSON format.
{
  "inquiryId": "5********9",
  "itemId": "2**********0",
  "transactionId": "8********9",
  "claimAmount": {
    "value": 131.0,
    "currency": "EUR"
  },
  "shippingCost": {
    "value": 0.0,
    "currency": "EUR"
  },
  "inquiryQuantity": 1,
  "initiator": "BUYER",
  "sellerMakeItRightByDate": {
    "value": "2015-06-25T18:59:31.000Z"
  },
  "status": "CLOSED",
  "extTransactionId": "0***************A",
  "inquiryDetails": {
    "creationDate": {
      "value": "2015-06-26T16:47:56.000Z"
    },
    "expirationDate": {
      "value": "2015-09-26T16:47:56.000Z"
    },
    "totalAmount": {
      "value": 131.0,
      "currency": "EUR"
    },
    "refundDeadlineDate": {
      "value": "2015-08-01T19:13:55.000Z"
    },
    "lastBuyerRespDate": {
      "value": "2015-07-01T19:13:55.000Z"
    }
  },
  "itemDetails": {
    "itemTitle": "Single item Single seller Order PPThu Jan 15 03:19:06 MST 2015",
    "itemPrice": {
      "value": 131.0,
      "currency": "EUR"
    },
    "itemPictureUrl": "https://i.ebayimg.ebay.com/00/s/M********w/z/O**********Qm/$_1.JPG?set_id=8********F",
    "viewPurchasedItemUrl": "https://cgi.de.paradise.ebay.com/ws/eBayISAPI.dll?ViewItemVersion&item=2*******0&tid=8*******9&view=all"
  },
  "viewPPTrasanctionUrl": "https://payments.ebay.com/ws/eBayISAPI.dll?UnifiedCheckoutSummaryRedirect2PP&buyerorseller=0&itemid=2*******0&transid=8********0"
}

Back to list of samples

Retrieve an INR inquiry for a cross-border trade line item.

Description

A seller wants to get the current status and full details of an Item Not Received inquiry. In this particular case, the buyer received a multiple line item order, but the order was missing a line item.

Input

The seller passes in the inquiry ID as a path parameter. There is no request payload for this call.

URL format. See also the non-wrapped version of this URL.

GET https://api.ebay.com/post-order/v2/inquiry/5********3

Output

The response of the call indicates that the reason for the INR inquiry was that the buyer received an incomplete order (see the creationReason field). The specific line item that was missing from the order is identified with the itemId and transactionId values.

The buyer seeks a refund for the order line item instead of having the seller send the missing item. The buyer ends up receiving the full refund, and the moneyMovementEntryList.fundingSource container indicates that the funds for the buyer refund is retrieved through the seller's available payout funds. The seller was a Canadian seller that listed the item on the eBay US marketplace, so the moneyMovementEntryList.amount container shows the amount of the refund in Canadian dollars.

The inquiryDetails.totalAmount container shows the total amount (34.56 in USD) of the refund, the inquiryDetails.refundAmounts.feeCreditAmount container shows the selling fee credits amount (0.89 in USD) due back to the seller, and the inquiryDetails.refundChargeAmount container shows the net amount (33.67 in USD) charged to the seller for recoupment of the buyer's refund. The 33.67 value is derived from subtracing the fee credit amount (0.89) from the total amount of the refund (34.56). The 33.67 net charge is converted into Canadian dollars (43.71), and the exchange rate used is also shown in the exchangeRate field.

JSON format.
{
    "inquiryId": "5********3",
    "itemId": "2**********7",
    "transactionId": "1********15",
    "claimAmount": {
        "value": 34.56,
        "currency": "USD"
    },
    "shippingCost": {
        "value": 0,
        "currency": "USD"
    },
    "inquiryQuantity": 1,
    "initiator": "BUYER",
    "sellerMakeItRightByDate": {
        "value": "2020-08-14T06:59:59.000Z"
    },
    "creationReason": "INCOMPLETE_ORDER",
    "inquiryPaymentInfo": null,
    "inquiryClosureDate": {
        "value": "2020-08-12T05:08:48.000Z"
    },
    "state": "CLOSED",
    "status": "CLOSED",
    "inquiryDetails": {
        "creationDate": {
            "value": "2020-08-11T01:21:57.000Z"
        },
        "expirationDate": {
            "value": "2020-08-14T07:00:00.000Z"
        },
        "escalationDate": null,
        "refundAmounts": {
            "refundAmount": null,
            "feeCreditAmount": {
                "value": 0.89,
                "currency": "USD"
            },
            "buyerFinalAcceptRefundAmt": {
                "value": 0,
                "currency": "USD"
            },
            "buyerInitExpectRefundAmt": {
                "value": 0,
                "currency": "USD"
            },
            "internationalRefundAmount": {
                "value": 3.2,
                "currency": "USD"
            }
        },
        "refundChargeAmount": {
            "value": 43.71,
            "convertedFromValue": 33.67,
            "convertedFromCurrency": "USD",
            "currency": "CAD",
            "exchangeRate": "1.29826"
        },
        "appealDetails": {
            "eligibleForAppeal": false,
            "appealStatus": null,
            "appealDate": null,
            "appealReasonCode": null,
            "appealCloseReasonEnum": null,
            "appealStatusEnum": null,
            "appealRefundAmount": null
        },
        "totalAmount": {
            "value": 34.56,
            "currency": "USD"
        },
        "refundDeadlineDate": {
            "value": "2020-08-15T05:08:48.000Z"
        },
        "lastBuyerRespDate": null
    },
    "extTransactionId": null,
    "viewPPTrasanctionUrl": "http://L*************1/ws/eBayISAPI.dll?UnifiedCheckoutSummaryRedirect2PP&buyerorseller=1&itemid=2**********7&transid=1*********5",
    "itemDetails": {
        "itemTitle": "test item Active CBT ",
        "itemPrice": {
            "value": 34.56,
            "currency": "USD"
        },
        "itemPictureUrl": "https://i.qa.ebayimg.com/00/s/M**********w/z/Q*************Pf/$_0.JPG?set_id=8********7",
        "viewPurchasedItemUrl": "http://L*************1/ws/eBayISAPI.dll?ViewItemVersion&item=2**********7&tid=1*********5&view=all"
    },
    "returnDetails": null,
    "inquiryHistoryDetails": {
			"history": [
				{
						"date": {
								"value": "2020-08-11T01:21:57.000Z"
						},
						"action": "A CPS case was created.",
						"actor": "BUYER",
						"description": "active CBT feature testing",
						"moneyMovement": null
				},
				{
						"date": {
								"value": "2020-08-11T01:24:08.000Z"
						},
						"action": "Auto Dispose Approve the case",
						"actor": "SYSTEM",
						"description": null,
						"moneyMovement": null
				},
				{
						"date": {
								"value": "2020-08-12T05:03:39.000Z"
						},
						"action": "Voluntary refund pending",
						"actor": "SELLER",
						"description": null,
						"moneyMovement": null
				},
				{
						"date": {
								"value": "2020-08-12T05:08:48.000Z"
						},
						"action": "Voluntary refund completed or failed",
						"actor": "SYSTEM",
						"description": null,
						"moneyMovement": {
							"moneyMovementEntryList": [
									{
											"date": {
													"value": "2020-08-12T05:03:37.087Z"
											},
											"type": "REFUND",
											"fundingSource": {
													"type": "AVAILABLE_FUNDS"
											},
											"fundingStatus": "FUNDED",
											"amount": {
													"value": 43.71,
													"convertedFromValue": 33.67,
													"convertedFromCurrency": "USD",
													"currency": "CAD"
											}
									}
							]
						}
					}
        ],
        "shipmentTrackingDetails": {
            "trackingURL": null,
            "trackingNumber": null,
            "carrier": null,
            "estimateFromDate": null,
            "estimateToDate": null,
            "currentStatus": null
        }
    }
}

Back to list of samples

Input Output Samples Change History

Change History

Change Date	Description

Copyright © 2015–2021 eBay Inc. All rights reserved. This documentation and the API may only be used in accordance with the eBay Developers Program and API License Agreement.