Skip to main content
Version: 202607

Get refund records count

GET 
/openapi/2026-07/orders/refund_records/count

Returns the total number of refund records matching the same filters accepted by the list endpoint. Useful for paging UIs and dashboards.

Request​

Query Parameters

    order_ids string[]

    Filter by order IDs. Up to 10 IDs are supported. Example: ?order_ids=1001&order_ids=1002

    refund_order_ids string[]

    Filter by refund record IDs. Up to 20 IDs are supported. Example: ?refund_order_ids=2001&refund_order_ids=2002

    refund_statuses string[]

    Filter by refund status.

    • pending: refund in progress.
    • finished: refund completed.
    • failed: refund failed. Example: ?refund_statuses=pending&refund_statuses=finished
    created_at_start string

    Filter records created at or after this time (e.g., 2018-11-02T12:30:10Z)

    created_at_end string

    Filter records created at or before this time (e.g., 2018-11-02T12:30:10Z)

    updated_at_start string

    Filter records last updated at or after this time (e.g., 2018-11-02T12:30:10Z)

    updated_at_end string

    Filter records last updated at or before this time (e.g., 2018-11-02T12:30:10Z)

Responses​

OK

Schema
    codestring

    error code

    messagestring

    error message

    data object
    countint32

    Total count of refund order records matching the filter conditions