eBay Post-Order APIVersion 2

Search Inquiries

GET /post-order/v2/inquiry/search

This call is used to search for inquiries using multiple filter types.

Input

See also Samples.

Resource URI (production)

GET https://api.ebay.com/post-order/v2/post-order/v2/inquiry/search?
  fieldgroups=InquirySearchFieldGroupEnum&
  inquiry_creation_date_range_from=string&
  inquiry_creation_date_range_to=string&
  inquiry_status=InquiryStatusFilter&
  item_id=string&
  limit=integer&
  offset=integer&
  order_id=string&
  sort=string&
  transaction_id=string

URI parameters

Parameter Type Required? Meaning
fieldgroups string Optional The fieldgroups query parameter can be used in the call URI to control the detail level that is returned in the response. See the InquirySearchFieldGroupEnum type for more information on the values that may be used in this query parameter.

Note: Using the fieldGroups query parameter is not recommended at this time, as the two supported enumeration values for this field will have the same effect on the Search Inquiries call response.



Applicable values are from InquirySearchFieldGroupEnum.
inquiry_creation_date_range_from string Optional The inquiry_creation_date_range_from and inquiry_creation_date_range_to query parameters are used if the user wants to retrieve inquiries that were created during a specific time range. The starting date range is input into the inquiry_creation_date_range_from query parameter. The inquiry_creation_date_range_from date must be older than the inquiry_creation_date_range_to date, and it cannot be set back more than 18 months in the past. If the inquiry_creation_date_range_from query parameter is used, but the inquiry_creation_date_range_to query parameter is not used, the call will look for all inquiries created at or after this date/time, going forward 90 days from this date. The ISO date format should be used for this query parameter. Here's a sample of that format: 2015-05-15T03:52:39.000Z.
inquiry_creation_date_range_to string Optional The inquiry_creation_date_range_from and inquiry_creation_date_range_to query parameters are used if the user wants to retrieve inquiries that were created during a specific time range. The ending date range is input into the inquiry_creation_date_range_to query parameter. The inquiry_creation_date_range_to date must be more recent than the inquiry_creation_date_range_from date. If the inquiry_creation_date_range_from query parameter is used, but the inquiry_creation_date_range_to query parameter is not used, the call will look for all inquiries created at or after the inquiry_creation_date_range_from value, going forward 90 days from this date. The ISO date format should be used for this query parameter. Here's a sample of that format: 2015-05-15T03:52:39.000Z.
inquiry_status string Optional This query parameter is used if the user wants to search for inquiries in a specific state. The possible states are defined in the InquiryStatusFilter type.

Applicable values are from InquiryStatusFilter.
item_id string --- The unique identifier of a listing. An item_id and a transaction_id value are both needed if the user wants to find any inquiries filed against a specific order line item. If these query parameters are used, any other query parameters that are used will be ignored.
limit integer Optional This integer value is used to specify the maximum number of inquiries to display on a single 'page' of data. This value, along with the number of inquiries that match the input criteria, will determine the total pages (see paginationOutput.totalPages) in the result set. The maximum value is 200 and the default value is 25 inquiries per page. The inquiries that are actually retrieved (and those that are left out) will be determined by the settings specified in the sort container.
offset integer Optional This integer value sets the results page to return in the current call. Page '1' of results is returned if this query parameter isn't used. Specify a positive value equal to or lower than the number of pages available (which you determine by examining the results in the paginationOutput container of your initial call).
order_id string Optional The unique identifier of an order. A order_id value is provided as a query parameter if the user wants to see if an inquiry was filed against one or more order line items in the order specified in this field.

Note: This is the value of the OrderID field returned by the Trading API's GetOrders call.

sort string Optional This query parameter is used if you want to sort the retrieved inquiries by creation date. The two supported values for this query parameter are 'Ascending' and 'Descending'. If the value is set to 'Descending', the most recently opened inquiries are returned at the top of the response. If the value is set to 'Ascending', the oldest inquiries are returned at the top of the response.
transaction_id string --- The unique identifier of an order line item. An item_id and a transaction_id value are both needed if the user wants to find any inquiries filed against a specific order line item. If these query parameters are used, any other query parameters that are used will be ignored.


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.


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.

{ /* InquirySearchResponse */
"members": [
    { /* InquirySummaryType */
    "buyer": string,
    "claimAmount":
        { /* Amount */
        "convertedFromCurrency": string,
        "convertedFromValue": number,
        "currency": string,
        "value": number
        },
    "creationDate":
        { /* DateTime */
        "value": datetime
        },
    "inquiryId": integer,
    "inquiryStatusEnum": string,
    "itemId": integer,
    "lastModifiedDate":
        { /* DateTime */
        "value": datetime
        },
    "respondByDate":
        { /* DateTime */
        "value": datetime
        },
    "seller": string,
    "transactionId": integer
    }
    /* More InquirySummaryType nodes here */
  ],
"paginationOutput":
    { /* PaginationOutput */
    "limit": integer,
    "offset": integer,
    "totalEntries": integer,
    "totalPages": integer
    },
"totalNumberOfInquiries": integer
}

Response field descriptions



Output Container/Field Type Occurrence Meaning
members array of InquirySummaryType Always This container is an array of inquiries that match the query parameters in the call request.
members.buyer string Always The eBay user ID of the buyer involved in the inquiry.
members.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.

members.claimAmount
  .convertedFromCurrency
string Conditionally This field indicates the currency involved in a monetary transaction before a price conversion was performed. Generally, this is the currency used by the buyer. This field is only applicable if a price conversion was necessary, and a price conversion is generally necessary if the buyer and seller are using different forms of currency.

Applicable values are from CurrencyCodeEnum:See convertedFromCurrency.
Code so that your app gracefully handles any future changes to this list.
members.claimAmount
  .convertedFromValue
number Conditionally This value is the dollar amount of the currency involved in a monetary transaction before a price conversion was performed. This field is only applicable if a price conversion was necessary, and a price conversion is generally necessary if the buyer and seller are using different forms of currency.
members.claimAmount.currency string Conditionally This field indicates the currency involved in a monetary transaction. Generally, this is the currency used by the listing site's country.

Applicable values are from CurrencyCodeEnum:See currency.
Code so that your app gracefully handles any future changes to this list.
members.claimAmount.value number Conditionally The dollar value of the currency specified in the currency field. The value of currency defaults to the standard currency used by the country of the listing site.
members.creationDate DateTime Always This timestamp indicates when the INR inquiry was created by the buyer.
members.creationDate.value datetime Conditionally This field is a timestamp for when an event or action occurred or is going to occur in the near future. It is intended for consumption by a caller's code for further computation, transformation, or comparison, and not for the end user. It uses the ISO 8601 date and time format with the 24-hour clock and Universal Coordinated Time (UTC). Following is the format template, and an example of a timestamp in this format:

Format: YYYY-MM-DDTHH:MM:SS.SSSZ

Example: 2004-08-04T19:09:02.768Z

This field is always used for containers using the DateTime type.
members.inquiryId integer Always The unique identifier of the INR inquiry.
members.inquiryStatusEnum string Always This enumeration value indicates the current status of the INR inquiry.

Applicable values are from res-resInquiryStatusEnum:See inquiryStatusEnum.
Code so that your app gracefully handles any future changes to this list.
members.itemId integer Always The unique identifier of the listing that has an INR inquiry filed against it. This value along with the transactionId value identifies the order line item involved in the INR inquiry.
members.lastModifiedDate DateTime Always This timestamp indicates when the last action was performed on the INR inquiry.
members.lastModifiedDate.value datetime Conditionally This field is a timestamp for when an event or action occurred or is going to occur in the near future. It is intended for consumption by a caller's code for further computation, transformation, or comparison, and not for the end user. It uses the ISO 8601 date and time format with the 24-hour clock and Universal Coordinated Time (UTC). Following is the format template, and an example of a timestamp in this format:

Format: YYYY-MM-DDTHH:MM:SS.SSSZ

Example: 2004-08-04T19:09:02.768Z

This field is always used for containers using the DateTime type.
members.respondByDate DateTime Conditionally This timestamp indicates the deadline for when a buyer or seller must perform the next action on the INR inquiry. This field will only be returned if there is a deadline associated with the next action.
members.respondByDate.value datetime Conditionally This field is a timestamp for when an event or action occurred or is going to occur in the near future. It is intended for consumption by a caller's code for further computation, transformation, or comparison, and not for the end user. It uses the ISO 8601 date and time format with the 24-hour clock and Universal Coordinated Time (UTC). Following is the format template, and an example of a timestamp in this format:

Format: YYYY-MM-DDTHH:MM:SS.SSSZ

Example: 2004-08-04T19:09:02.768Z

This field is always used for containers using the DateTime type.
members.seller string Always The eBay user ID of the buyer involved in the inquiry.
members.transactionId integer Always The unique identifier of the transaction that has an INR inquiry filed against it. This value along with the itemId value identifies the order line item involved in the INR inquiry.
paginationOutput PaginationOutput Always This container consists of metadata related to the current response page. It contains the page number and the inquiries per page, as well as the total amount of response pages and inquiries.
paginationOutput.limit integer Always The maximum number of entries to return per request. The value of the totalEntries field divided by the value of this field determines the value of the totalPages field. This value cannot be higher than the number of entries that match the input criteria.
paginationOutput.offset integer Always Identifies the specific page of data to be returned by the request.

The total number of pages in the result set is determined by the total number of entries matching the request criteria (totalEntries), divided by the number of entries to display per page of data (as specified by limit). If there are multiple pages of entries to view (see totalPages), make multiple requests to view all entries and increment the page number by 1 in each subsequent request.

Default: 1
paginationOutput.totalEntries integer Always The total number of entries that match the current input criteria of the request. This value divided by the value of the limit field determines the value of the totalPages field.

Once this number of response set is known, you can modify the input to get the results you desire.
paginationOutput.totalPages integer Always The total number of pages of entries that match the current input criteria of the request.

This value is determined by dividing the value of the totalEntries field by the value of the limit field. If totalPages is more than 1, this call must be issued multiple times to view all result pages, with the page number value being incremented by 1 in each subsequent call.
totalNumberOfInquiries integer Always This integer value indicates the total number of inquiries that were found based on the input filter(s) in the request.
null



Samples

Code samples not yet added for this call's documentation.



Change History

Change Date Description