# Query chargebacks > Query chargeback records by chargeback ID, transaction identifiers, or import time range. ```yaml openapi: 3.1.0 info: title: Query chargebacks version: 1.0.0 description: Query chargeback records by chargeback ID, transaction identifiers, or import time range. paths: /v1/chargeback/list: post: summary: Query chargebacks description: Query chargeback records by chargeback ID, transaction identifiers, or import time range. requestBody: required: true content: application/json: schema: type: object properties: merchantNo: type: string description: Merchant number assigned by Onerway. See [Setup](/payments/get-started/setup#retrieve-your-credentials) for how to obtain it. chargebackIds: type: string description: Comma-separated Onerway chargeback IDs used to query chargeback records in batch. x-onerway-required: conditional x-onerway-condition: - Provide this field as one query condition. At least one of `merchantTxnIds`, `originTransactionIds`, `chargebackIds`, or `importTimeStart` + `importTimeEnd` is required. x-onerway-constraints: - kind: range max: 10 unit: IDs text: A single request can include up to 10 comma-separated IDs. merchantTxnIds: type: string description: Comma-separated merchant transaction numbers used to query chargeback records in batch. x-onerway-required: conditional x-onerway-condition: - Provide this field as one query condition. At least one of `merchantTxnIds`, `originTransactionIds`, `chargebackIds`, or `importTimeStart` + `importTimeEnd` is required. x-onerway-constraints: - kind: range max: 10 unit: IDs text: A single request can include up to 10 comma-separated IDs. originTransactionIds: type: string description: Comma-separated original Onerway transaction IDs used to query chargeback records in batch. x-onerway-required: conditional x-onerway-condition: - Provide this field as one query condition. At least one of `merchantTxnIds`, `originTransactionIds`, `chargebackIds`, or `importTimeStart` + `importTimeEnd` is required. x-onerway-constraints: - kind: range max: 10 unit: IDs text: A single request can include up to 10 comma-separated IDs. importTimeStart: type: string description: Start of the time range, filtered by the time when Onerway received the chargeback transaction, in `yyyy-MM-dd HH:mm:ss` format. x-onerway-required: conditional x-onerway-condition: - Provide this field as one query condition. At least one of `merchantTxnIds`, `originTransactionIds`, `chargebackIds`, or `importTimeStart` + `importTimeEnd` is required. x-onerway-constraints: - kind: rule text: When querying by time range, submit both `importTimeStart` and `importTimeEnd`. The maximum range is 90 days. importTimeEnd: type: string description: End of the time range, in `yyyy-MM-dd HH:mm:ss` format. It must be later than `importTimeStart`. x-onerway-required: conditional x-onerway-condition: - Provide this field as one query condition. At least one of `merchantTxnIds`, `originTransactionIds`, `chargebackIds`, or `importTimeStart` + `importTimeEnd` is required. x-onerway-constraints: - kind: rule text: When querying by time range, submit both `importTimeStart` and `importTimeEnd`. The maximum range is 90 days. current: type: string description: Query page number. `0` and `1` both mean the first page. The response `current` value is always returned as a 1-based page number. sign: type: string description: Request signature string. See [Request signing](/payments/get-started/request-signing) for how to generate it. required: - merchantNo - current - sign examples: query-chargebacks-by-time-range: summary: Query chargebacks by time range value: current: "1" importTimeEnd: 2026-06-21 23:59:59 importTimeStart: 2026-06-01 00:00:00 merchantNo: replace_with_merchant_no sign: "{{SIGN}}" responses: "200": description: Response content: application/json: schema: type: object properties: respCode: type: string description: "`20000` means the query request was processed successfully. Other values are error codes. See [Response codes](/payments/api-reference/response-codes)." respMsg: type: string description: Human-readable message for the response code. data: type: object properties: content: type: array description: Chargeback records matching the query conditions. items: type: object properties: merchantNo: type: string description: Merchant number assigned by Onerway, identifying the merchant account. chargebackId: type: string description: Chargeback transaction ID generated by Onerway, transmitted as a JSON string. Use this ID when communicating with Onerway about a specific chargeback case. importTime: type: string description: Time when Onerway received the chargeback transaction, in `yyyy-MM-dd HH:mm:ss` format. merchantTxnId: type: string description: Merchant payment order number of the original transaction that received the chargeback. originTransactionId: type: string description: Original Onerway transaction ID that received the chargeback, transmitted as a JSON string. txnAmount: type: string description: Original transaction amount in settlement currency. Actual received and settled amounts follow the corresponding settlement batch, detail, or report. txnCurrency: type: string description: Settlement currency of the original transaction, as a three-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. The actual settlement currency follows the merchant settlement configuration agreed with Onerway. txnTime: type: string description: Original transaction completion time in `yyyy-MM-dd HH:mm:ss` format. paymentMethod: type: string description: Payment method or card brand used by the original transaction. chargebackAmount: type: string description: Chargeback amount in `chargebackCurrency`. It can be less than or equal to the original transaction amount. chargebackCurrency: type: string description: Chargeback amount currency, usually the same as the original transaction currency, as a three-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. chargebackSettleAmount: type: - string - "null" description: Chargeback amount converted to the merchant settlement currency when the chargeback was recorded. Later chargeback status changes do not update this value. x-onerway-value: nullable: true when: en: May be `null` if no settlement amount was recorded when the chargeback was created, including for historical records. zh: 拒付录入时未记录结算金额的记录（包括历史记录）可返回 `null`。 chargebackSettleCurrency: type: - string - "null" description: Merchant settlement currency used to calculate `chargebackSettleAmount` when the chargeback was recorded, as a three-letter [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code. x-onerway-value: nullable: true when: en: May be `null` when no chargeback settlement currency was recorded, including historical records. zh: 未记录拒付结算币种时可返回 `null`，包括历史记录。 chargebackDate: type: string description: Chargeback date, meaning the date when the issuer processed the chargeback, in `yyyy-MM-dd` format. chargebackStatus: type: string description: Current chargeback status. enum: - NEW - FA - FAF - FAS - FAT - SA - SAF - SAS - SAT - ACCEPT - REVOKE - DELETE x-enum-descriptions: NEW: New chargeback. The cardholder has filed a chargeback; review the case and decide whether to accept or dispute it. FA: First representment is in progress. The merchant’s first chargeback appeal is being processed by the card network. FAF: First representment failed. The first chargeback appeal was rejected; the merchant may still be able to proceed to arbitration (second appeal). FAS: First representment succeeded. The appeal was accepted, the chargeback was reversed, and funds were returned. FAT: First representment timed out. The first chargeback appeal was not completed within the required time. SA: Arbitration (second appeal) is in progress after the first chargeback appeal failed. SAF: Arbitration was unsuccessful for the merchant. The chargeback remains. SAS: Arbitration was successful for the merchant and funds were returned. SAT: The deadline for the arbitration stage (second appeal) was missed. The required response was not completed within the specified time. ACCEPT: Chargeback accepted. The merchant accepted the chargeback without disputing it; the transaction amount will be deducted. REVOKE: Chargeback revoked. The chargeback was withdrawn by the cardholder or issuer. DELETE: Chargeback record deleted. chargebackReason: type: string description: Free-text reason explaining why this chargeback was initiated. chargebackArn: type: string description: Acquirer Reference Number (ARN) for this chargeback, used for reconciliation and dispute handling. appealDueTime: type: string description: Appeal deadline. Submit evidence before this time to contest the chargeback, in `yyyy-MM-dd HH:mm:ss` format. chargebackCode: type: string description: Standardized chargeback reason code assigned by the card network. current: type: string description: Current returned page number, using 1-based numbering. size: type: number description: Number of records in the current page. The current page size is fixed at 10 records. totalPages: type: number description: Total number of pages based on the current page size. totalElements: type: number description: Total number of chargeback records matching the query conditions. description: Chargeback records and pagination information. ```