List Resolution Center Cases
Lists resolution center cases. Without account_id you get every case you can read — the ones you opened as a buyer and every account you are a team member of; the filters narrow that list.
Query parameters
Only cases filed against this account (biz_ tag). With read access to the account this lists its whole queue; without, only the cases you opened against it.
Only cases opened by this customer — a user_ tag, or me for the calling user. It narrows what you can already read, so me lists the cases you opened without the ones on accounts you are a team member of.
The number of cases to return (default 20, max 100).
A cursor; returns cases after this position.
The number of cases to return from the end of the range.
A cursor; returns cases before this position.
The field to sort cases by.
Sort direction.
Only cases in these statuses. Repeat the parameter to pass several — one paginated list covers all of them.
[ "awaiting_merchant" ]
Only cases opened for these reasons. Repeat the parameter to pass several.
[ "fraudulent" ]
Only closed cases that ended these ways. Repeat the parameter to pass several.
[ "customer_won" ]
Only cases created before this ISO 8601 timestamp.
Only cases created after this ISO 8601 timestamp.
Headers
Pins the request to a dated API version.
Response
cases listed
Example response
{
"data": [
{
"account": {
"id": "biz_xxxxxxxxxxxxxx",
"title": "Shine Time Auto Detailing"
},
"amount": 249,
"available_actions": [
"accept"
],
"buyer": {
"email": "marcus@shinetime.example",
"member_id": "mber_xxxxxxxxxxxxxx",
"name": "Dana Whitfield",
"user_id": "user_xxxxxxxxxxxxxx",
"username": "danawhitfield"
},
"created_at": "2026-01-01T12:00:00.000Z",
"currency": "usd",
"id": "reso_xxxxxxxxxxxxxx",
"outcome": "merchant_won",
"payment": {
"card_brand": "visa",
"card_last4": "4242",
"created_at": "2026-01-01T12:00:00.000Z",
"id": "pay_xxxxxxxxxxxxxx",
"payment_method_type": "card"
},
"plan_id": "plan_xxxxxxxxxxxxxx",
"product_id": "prod_xxxxxxxxxxxxxx",
"reason": "product_not_received",
"refund": "none",
"response_due_at": "2026-01-01T12:00:00.000Z",
"status": "closed",
"updated_at": "2026-01-01T12:00:00.000Z"
}
],
"page_info": {
"end_cursor": "WyJjdXJzb3IiLDFd",
"start_cursor": "WyJjdXJzb3IiLDFd"
}
}Changes
Changed in 2 of the 41 revisions of this API.111246
- ○
added the optional property
error/codeto the response with the401statusresponse-optional-property-added
- ○
added the optional property
error/codeto the response with the403statusresponse-optional-property-added
- ○
added the optional property
error/codeto the response with the404statusresponse-optional-property-added
This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ○
- ▲
the
queryrequest parameterdirectionwas restricted to a list of enum valuesrequest-parameter-became-enum
- ▲
for the
queryrequest parameterdirection, default valuedescwas addedrequest-parameter-default-value-added
- ▲
the
data/items/created_atresponse's property type/format changed fromstring/date-timetostring/for status200response-property-type-changed
- ▲
the
data/items/updated_atresponse's property type/format changed fromstring/date-timetostring/for status200response-property-type-changed
- ▲
removed the required property
data/items/companyfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
data/items/customer_response_actionsfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
data/items/due_datefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
data/items/issuefrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
data/items/merchant_appealedfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
data/items/merchant_response_actionsfrom the response with the200statusresponse-required-property-removed
- ▲
removed the required property
data/items/userfrom the response with the200statusresponse-required-property-removed
- ●
deleted the
queryrequest parametercompany_idrequest-parameter-removed
- ●
deleted the
queryrequest parameterstatusesrequest-parameter-removed
- ●
removed the optional property
error/codefrom the response with the401statusresponse-optional-property-removed
- ●
removed the optional property
error/codefrom the response with the403statusresponse-optional-property-removed
- ●
removed the optional property
error/codefrom the response with the404statusresponse-optional-property-removed
- ●
removed the optional property
error/paramfrom the response with the401statusresponse-optional-property-removed
- ●
removed the optional property
error/paramfrom the response with the403statusresponse-optional-property-removed
- ●
removed the optional property
error/paramfrom the response with the404statusresponse-optional-property-removed
- ●
added the new
awaiting_customerenum value to thedata/items/statusresponse property for the response status200response-property-enum-value-added
- ●
added the new
awaiting_merchantenum value to thedata/items/statusresponse property for the response status200response-property-enum-value-added
- ●
added the new
closedenum value to thedata/items/statusresponse property for the response status200response-property-enum-value-added
- ●
added the new
under_reviewenum value to thedata/items/statusresponse property for the response status200response-property-enum-value-added
- ○
api operation id
listResolutionCenterCaseremoved and replaced withlistResolutionCenterCasesapi-operation-id-removed
- ○
api tag
Resolution Center Casesaddedapi-tag-added
- ○
api tag
Resolution center casesremovedapi-tag-removed
- ○
added the new optional
headerrequest parameterApi-Version-Datenew-optional-request-parameter
- ○
added the new optional
queryrequest parameteraccount_idnew-optional-request-parameter
- ○
added the new optional
queryrequest parameterordernew-optional-request-parameter
- ○
added the new optional
queryrequest parameteroutcomenew-optional-request-parameter
- ○
added the new optional
queryrequest parameterreasonnew-optional-request-parameter
- ○
added the new optional
queryrequest parameterstatusnew-optional-request-parameter
- ○
added the new optional
queryrequest parameteruser_idnew-optional-request-parameter
- ○
added the new enum value
ascto thequeryrequest parameterdirectionrequest-parameter-enum-value-added
- ○
added the new enum value
descto thequeryrequest parameterdirectionrequest-parameter-enum-value-added
- ○
for the
queryrequest parametercreated_after, the type/format was generalized fromstringnull/date-timetostring/request-parameter-type-generalized
- ○
for the
queryrequest parametercreated_before, the type/format was generalized fromstringnull/date-timetostring/request-parameter-type-generalized
- ○
for the
queryrequest parameterdirection, the type/format was generalized from/tostring/request-parameter-type-generalized
- ○
removed the non-success response with the status
400response-non-success-status-removed
- ○
removed the non-success response with the status
422response-non-success-status-removed
- ○
removed the non-success response with the status
429response-non-success-status-removed
- ○
removed the non-success response with the status
500response-non-success-status-removed
- ○
removed the
customer_info_neededenum value from thedata/items/statusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
customer_response_neededenum value from thedata/items/statusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
customer_withdrewenum value from thedata/items/statusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
customer_wonenum value from thedata/items/statusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
merchant_info_neededenum value from thedata/items/statusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
merchant_response_neededenum value from thedata/items/statusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
merchant_wonenum value from thedata/items/statusresponse property for the response status200response-property-enum-value-removed
- ○
removed the
under_platform_reviewenum value from thedata/items/statusresponse property for the response status200response-property-enum-value-removed
- ○
added the required property
data/items/accountto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/amountto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/available_actionsto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/buyerto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/currencyto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/escalatedto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/outcometo the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/payment/card_brandto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/payment/card_last4to the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/payment/created_atto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/payment/payment_method_typeto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/plan_idto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/product_idto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/reasonto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/refundto the response with the200statusresponse-required-property-added
- ○
added the required property
data/items/response_due_atto the response with the200statusresponse-required-property-added
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
- ▲