Resolution Center Cases

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.

get/resolution_center_cases

Query parameters

account_idstring

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.

user_idstring

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.

firstinteger

The number of cases to return (default 20, max 100).

afterstring

A cursor; returns cases after this position.

lastinteger

The number of cases to return from the end of the range.

beforestring

A cursor; returns cases before this position.

order'created_at' | 'response_due_at'

The field to sort cases by.

direction'asc' | 'desc'

Sort direction.

statusstring[]

Only cases in these statuses. Repeat the parameter to pass several — one paginated list covers all of them.

[
  "awaiting_merchant"
]
reasonstring[]

Only cases opened for these reasons. Repeat the parameter to pass several.

[
  "fraudulent"
]
outcomestring[]

Only closed cases that ended these ways. Repeat the parameter to pass several.

[
  "customer_won"
]
created_beforestring

Only cases created before this ISO 8601 timestamp.

created_afterstring

Only cases created after this ISO 8601 timestamp.

Headers

Api-Version-Datestring
Example:2026-08-25-2

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/code to the response with the 401 status

      response-optional-property-added

    • added the optional property error/code to the response with the 403 status

      response-optional-property-added

    • added the optional property error/code to the response with the 404 status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 099fdc3be422111243See the full diff
    • the query request parameter direction was restricted to a list of enum values

      request-parameter-became-enum

    • for the query request parameter direction, default value desc was added

      request-parameter-default-value-added

    • the data/items/created_at response's property type/format changed from string/date-time to string/ for status 200

      response-property-type-changed

    • the data/items/updated_at response's property type/format changed from string/date-time to string/ for status 200

      response-property-type-changed

    • removed the required property data/items/company from the response with the 200 status

      response-required-property-removed

    • removed the required property data/items/customer_response_actions from the response with the 200 status

      response-required-property-removed

    • removed the required property data/items/due_date from the response with the 200 status

      response-required-property-removed

    • removed the required property data/items/issue from the response with the 200 status

      response-required-property-removed

    • removed the required property data/items/merchant_appealed from the response with the 200 status

      response-required-property-removed

    • removed the required property data/items/merchant_response_actions from the response with the 200 status

      response-required-property-removed

    • removed the required property data/items/user from the response with the 200 status

      response-required-property-removed

    • deleted the query request parameter company_id

      request-parameter-removed

    • deleted the query request parameter statuses

      request-parameter-removed

    • removed the optional property error/code from the response with the 401 status

      response-optional-property-removed

    • removed the optional property error/code from the response with the 403 status

      response-optional-property-removed

    • removed the optional property error/code from the response with the 404 status

      response-optional-property-removed

    • removed the optional property error/param from the response with the 401 status

      response-optional-property-removed

    • removed the optional property error/param from the response with the 403 status

      response-optional-property-removed

    • removed the optional property error/param from the response with the 404 status

      response-optional-property-removed

    • added the new awaiting_customer enum value to the data/items/status response property for the response status 200

      response-property-enum-value-added

    • added the new awaiting_merchant enum value to the data/items/status response property for the response status 200

      response-property-enum-value-added

    • added the new closed enum value to the data/items/status response property for the response status 200

      response-property-enum-value-added

    • added the new under_review enum value to the data/items/status response property for the response status 200

      response-property-enum-value-added

    • api operation id listResolutionCenterCase removed and replaced with listResolutionCenterCases

      api-operation-id-removed

    • api tag Resolution Center Cases added

      api-tag-added

    • api tag Resolution center cases removed

      api-tag-removed

    • added the new optional header request parameter Api-Version-Date

      new-optional-request-parameter

    • added the new optional query request parameter account_id

      new-optional-request-parameter

    • added the new optional query request parameter order

      new-optional-request-parameter

    • added the new optional query request parameter outcome

      new-optional-request-parameter

    • added the new optional query request parameter reason

      new-optional-request-parameter

    • added the new optional query request parameter status

      new-optional-request-parameter

    • added the new optional query request parameter user_id

      new-optional-request-parameter

    • added the new enum value asc to the query request parameter direction

      request-parameter-enum-value-added

    • added the new enum value desc to the query request parameter direction

      request-parameter-enum-value-added

    • for the query request parameter created_after, the type/format was generalized from string null/date-time to string/

      request-parameter-type-generalized

    • for the query request parameter created_before, the type/format was generalized from string null/date-time to string/

      request-parameter-type-generalized

    • for the query request parameter direction, the type/format was generalized from / to string/

      request-parameter-type-generalized

    • removed the non-success response with the status 400

      response-non-success-status-removed

    • removed the non-success response with the status 422

      response-non-success-status-removed

    • removed the non-success response with the status 429

      response-non-success-status-removed

    • removed the non-success response with the status 500

      response-non-success-status-removed

    • removed the customer_info_needed enum value from the data/items/status response property for the response status 200

      response-property-enum-value-removed

    • removed the customer_response_needed enum value from the data/items/status response property for the response status 200

      response-property-enum-value-removed

    • removed the customer_withdrew enum value from the data/items/status response property for the response status 200

      response-property-enum-value-removed

    • removed the customer_won enum value from the data/items/status response property for the response status 200

      response-property-enum-value-removed

    • removed the merchant_info_needed enum value from the data/items/status response property for the response status 200

      response-property-enum-value-removed

    • removed the merchant_response_needed enum value from the data/items/status response property for the response status 200

      response-property-enum-value-removed

    • removed the merchant_won enum value from the data/items/status response property for the response status 200

      response-property-enum-value-removed

    • removed the under_platform_review enum value from the data/items/status response property for the response status 200

      response-property-enum-value-removed

    • added the required property data/items/account to the response with the 200 status

      response-required-property-added

    • added the required property data/items/amount to the response with the 200 status

      response-required-property-added

    • added the required property data/items/available_actions to the response with the 200 status

      response-required-property-added

    • added the required property data/items/buyer to the response with the 200 status

      response-required-property-added

    • added the required property data/items/currency to the response with the 200 status

      response-required-property-added

    • added the required property data/items/escalated to the response with the 200 status

      response-required-property-added

    • added the required property data/items/outcome to the response with the 200 status

      response-required-property-added

    • added the required property data/items/payment/card_brand to the response with the 200 status

      response-required-property-added

    • added the required property data/items/payment/card_last4 to the response with the 200 status

      response-required-property-added

    • added the required property data/items/payment/created_at to the response with the 200 status

      response-required-property-added

    • added the required property data/items/payment/payment_method_type to the response with the 200 status

      response-required-property-added

    • added the required property data/items/plan_id to the response with the 200 status

      response-required-property-added

    • added the required property data/items/product_id to the response with the 200 status

      response-required-property-added

    • added the required property data/items/reason to the response with the 200 status

      response-required-property-added

    • added the required property data/items/refund to the response with the 200 status

      response-required-property-added

    • added the required property data/items/response_due_at to the response with the 200 status

      response-required-property-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog