--- title: "Submit dispute response" method: POST path: "/disputes/{id}/response" tags: ["Disputes"] --- # Submit dispute response `POST /disputes/{id}/response` ## Request - Base URL: `https://api.justifi.ai/v1` - URL: `https://api.justifi.ai/v1/disputes/{id}/response` - Auth: none declared. Required headers: `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) Submits the dispute response > ⚠️ **Not available for Canada accounts** > > The dispute response and evidence endpoints are not available for Canada accounts. ## Path parameters - `id` string, uuid, required ## Headers - `Authorization` string, required ## Request body - object - `forfeit` boolean, required: when true forfeits the dispute and all other parameters passed in are ignored - `additional_statement` string: any additional evidence or statements - `cancellation_policy_disclosure` string: an explanation of how and when the customer was shown your cancellation policy prior to purchase - `cancellation_rebuttal` string: a justification for why the customer’s subscription was not canceled - `customer_billing_address` string: the billing address provided by the customer - `customer_email_address` string: the email address of the customer - `customer_name` string: the name of the customer - `customer_purchase_ip_address` string: the IP address that the customer used when making the purchase - `duplicate_charge_explanation` string: an explanation of the difference between the disputed charge versus the prior charge that appears to be a duplicate - `product_description` string: a description of the product or service that was sold - `refund_policy_disclosure` string: documentation demonstrating that the customer was shown your refund policy prior to purchase - `refund_refusal_explanation` string: justification for why the customer is not entitled to a refund - `service_date` string: the date on which the customer received or began receiving the purchased service - `shipping_address` string: the address to which a physical product was shipped - `shipping_carrier` string: the delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc. If multiple carriers were used for this purchase, please separate them with commas - `shipping_date` string: the date on which a physical product began its route to the shipping address - `shipping_tracking_number` string: the tracking number for a physical product. If multiple tracking numbers were generated for this purchase, please separate them with commas - `duplicate_charge_original_payment_id` string: the payment id for the prior charge which appears to be a duplicate of the disputed charge ## Response `200` Dispute response submitted - object - `id` string, uuid: the object id, also found in the data object - `type` string: the object type, or array of objects - `data` object: the attributes for the object - `id` string: unique dispute id - `payment_id` string, uuid: the disputed payment - `account_id` string, uuid: id of the account associated with the dispute - `amount` number: amount disputed in cents - `currency` 'usd' | 'cad' - `reason` string: the reason this payment was disputed - `due_date` string, date: due date for evidence submission to counter the dispute - `status` 'needs_response' | 'under_review' | 'won' | 'lost': status of the dispute - `metadata` object: any useful information you'd like to store alongside this dispute - `created_at` string, date-time - `updated_at` string, date-time - `dispute_response` object, nullable: present when evidence was submitted to counter dispute - `additional_statement` string: any additional evidence or statements - `cancellation_policy_disclosure` string: an explanation of how and when the customer was shown your cancellation policy prior to purchase - `cancellation_rebuttal` string: a justification for why the customer’s subscription was not canceled - `customer_billing_address` string: the billing address provided by the customer - `customer_email_address` string: the email address of the customer - `customer_name` string: the name of the customer - `customer_purchase_ip_address` string: the IP address that the customer used when making the purchase - `duplicate_charge_explanation` string: an explanation of the difference between the disputed charge versus the prior charge that appears to be a duplicate - `product_description` string: a description of the product or service that was sold - `refund_policy_disclosure` string: documentation demonstrating that the customer was shown your refund policy prior to purchase - `refund_refusal_explanation` string: justification for why the customer is not entitled to a refund - `service_date` string: the date on which the customer received or began receiving the purchased service - `shipping_address` string: the address to which a physical product was shipped - `shipping_carrier` string: the delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc. If multiple carriers were used for this purchase, please separate them with commas - `shipping_date` string: the date on which a physical product began its route to the shipping address - `shipping_tracking_number` string: the tracking number for a physical product. If multiple tracking numbers were generated for this purchase, please separate them with commas - `duplicate_charge_original_payment_id` string: the payment id for the prior charge which appears to be a duplicate of the disputed charge - `dispute_reversal` object, nullable: present when dispute gets reversed from lost to won - `description` string - `created_at` string, date-time - `page_info` unknown --- [API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)