# PostDisputesDispute
From **Stripe API**.
`POST /v1/disputes/{dispute}`
When you get a dispute, contacting your customer is always the best first step. If that doesn’t work, you can submit evidence to help us resolve the dispute in your favor. You can do this in your dashboard, but if you prefer, you can use the API to submit evidence programmatically.
Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. To figure out which evidence fields to provide, see our guide to dispute types.
## Parameters
### `dispute`
- Location: path
- Required: true
- Type: `string`
- maxLength: `5000`
## Request body
- Required: false
### `application/x-www-form-urlencoded`
- Type: `object`
```json
{"additionalProperties":false,"properties":{"evidence":{"description":"Evidence to upload, to respond to a dispute. Updating any field in the hash will submit all fields in the hash for review. The combined character count of all fields is limited to 150,000.","properties":{"access_activity_log":{"maxLength":20000,"type":"string"},"billing_address":{"maxLength":5000,"type":"string"},"cancellation_policy":{"type":"string"},"cancellation_policy_disclosure":{"maxLength":20000,"type":"string"},"cancellation_rebuttal":{"maxLength":20000,"type":"string"},"customer_communication":{"type":"string"},"customer_email_address":{"maxLength":5000,"type":"string"},"customer_name":{"maxLength":5000,"type":"string"},"customer_purchase_ip":{"maxLength":5000,"type":"string"},"customer_signature":{"type":"string"},"duplicate_charge_documentation":{"type":"string"},"duplicate_charge_explanation":{"maxLength":20000,"type":"string"},"duplicate_charge_id":{"maxLength":5000,"type":"string"},"product_description":{"maxLength":20000,"type":"string"},"receipt":{"type":"string"},"refund_policy":{"type":"string"},"refund_policy_disclosure":{"maxLength":20000,"type":"string"},"refund_refusal_explanation":{"maxLength":20000,"type":"string"},"service_date":{"maxLength":5000,"type":"string"},"service_documentation":{"type":"string"},"shipping_address":{"maxLength":5000,"type":"string"},"shipping_carrier":{"maxLength":5000,"type":"string"},"shipping_date":{"maxLength":5000,"type":"string"},"shipping_documentation":{"type":"string"},"shipping_tracking_number":{"maxLength":5000,"type":"string"},"uncategorized_file":{"type":"string"},"uncategorized_text":{"maxLength":20000,"type":"string"}},"title":"dispute_evidence_params","type":"object"},"expand":{"description":"Specifies which fields in the response should be expanded.","items":{"maxLength":5000,"type":"string"},"type":"array"},"metadata":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"enum":[""],"type":"string"}],"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`."},"submit":{"description":"Whether to immediately submit evidence to the bank. If `false`, evidence is staged on the dispute. Staged evidence is visible in the API and Dashboard, and can be submitted to the bank by making another request with this attribute set to `true` (the default).","type":"boolean"}},"type":"object"}
```
## Security
### `basicAuth`
- Type: `http`
- Request header: `Authorization`
- Scheme: `basic`
Send credentials in the `Authorization` request header using the `Basic` scheme.
Basic HTTP authentication. Allowed headers-- Authorization: Basic | Authorization: Basic
### `bearerAuth`
- Type: `http`
- Request header: `Authorization`
- Scheme: `bearer`
- Bearer format: `auth-scheme`
Send the token in the `Authorization` request header using the `Bearer` scheme.
Bearer HTTP authentication. Allowed headers-- Authorization: Bearer
## Responses
### `200`
Successful response.
### `application/json`
- Type: `object`
A dispute occurs when a customer questions your charge with their card issuer.
When this happens, you're given the opportunity to respond to the dispute with
evidence that shows that the charge is legitimate. You can find more
information about the dispute process in our [Disputes and
Fraud](/docs/disputes) documentation.
Related guide: [Disputes and Fraud](https://stripe.com/docs/disputes).
```json
{"description":"A dispute occurs when a customer questions your charge with their card issuer.\nWhen this happens, you're given the opportunity to respond to the dispute with\nevidence that shows that the charge is legitimate. You can find more\ninformation about the dispute process in our [Disputes and\nFraud](/docs/disputes) documentation.\n\nRelated guide: [Disputes and Fraud](https://stripe.com/docs/disputes).","properties":{"amount":{"description":"Disputed amount. Usually the amount of the charge, but can differ (usually because of currency fluctuation or because only part of the order is disputed).","type":"integer"},"balance_transactions":{"description":"List of zero, one, or two balance transactions that show funds withdrawn and reinstated to your Stripe account as a result of this dispute.","items":{"$ref":"#/components/schemas/balance_transaction"},"type":"array"},"charge":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/charge"}],"description":"ID of the charge that was disputed.","x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/charge"}]}},"created":{"description":"Time at which the object was created. Measured in seconds since the Unix epoch.","format":"unix-time","type":"integer"},"currency":{"description":"Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).","type":"string"},"evidence":{"$ref":"#/components/schemas/dispute_evidence"},"evidence_details":{"$ref":"#/components/schemas/dispute_evidence_details"},"id":{"description":"Unique identifier for the object.","maxLength":5000,"type":"string"},"is_charge_refundable":{"description":"If true, it is still possible to refund the disputed payment. Once the payment has been fully refunded, no further funds will be withdrawn from your Stripe account as a result of this dispute.","type":"boolean"},"livemode":{"description":"Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.","type":"boolean"},"metadata":{"additionalProperties":{"maxLength":500,"type":"string"},"description":"Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.","type":"object"},"object":{"description":"String representing the object's type. Objects of the same type share the same value.","enum":["dispute"],"type":"string"},"payment_intent":{"anyOf":[{"maxLength":5000,"type":"string"},{"$ref":"#/components/schemas/payment_intent"}],"description":"ID of the PaymentIntent that was disputed.","nullable":true,"x-expansionResources":{"oneOf":[{"$ref":"#/components/schemas/payment_intent"}]}},"reason":{"description":"Reason given by cardholder for dispute. Possible values are `bank_cannot_process`, `check_returned`, `credit_not_processed`, `customer_initiated`, `debit_not_authorized`, `duplicate`, `fraudulent`, `general`, `incorrect_account_details`, `insufficient_funds`, `product_not_received`, `product_unacceptable`, `subscription_canceled`, or `unrecognized`. Read more about [dispute reasons](https://stripe.com/docs/disputes/categories).","maxLength":5000,"type":"string"},"status":{"description":"Current status of dispute. Possible values are `warning_needs_response`, `warning_under_review`, `warning_closed`, `needs_response`, `under_review`, `charge_refunded`, `won`, or `lost`.","enum":["charge_refunded","lost","needs_response","under_review","warning_closed","warning_needs_response","warning_under_review","won"],"type":"string"}},"required":["amount","balance_transactions","charge","created","currency","evidence","evidence_details","id","is_charge_refundable","livemode","metadata","object","reason","status"],"title":"Dispute","type":"object","x-expandableFields":["balance_transactions","charge","evidence","evidence_details","payment_intent"],"x-resourceId":"dispute"}
```
### `default`
Error response.
### `application/json`
- Type: `object`
An error response from the Stripe API
```json
{"description":"An error response from the Stripe API","properties":{"error":{"$ref":"#/components/schemas/api_errors"}},"required":["error"],"type":"object"}
```
## Request examples
### cURL
```shell
curl --request POST \
--url https://api.stripe.com/v1/disputes/{dispute} \
--header 'content-type: application/x-www-form-urlencoded' \
--data '{
"evidence": {
"access_activity_log": "string",
"billing_address": "string",
"cancellation_policy": "string",
"cancellation_policy_disclosure": "string",
"cancellation_rebuttal": "string",
"customer_communication": "string",
"customer_email_address": "string",
"customer_name": "string",
"customer_purchase_ip": "string",
"customer_signature": "string",
"duplicate_charge_documentation": "string",
"duplicate_charge_explanation": "string",
"duplicate_charge_id": "string",
"product_description": "string",
"receipt": "string",
"refund_policy": "string",
"refund_policy_disclosure": "string",
"refund_refusal_explanation": "string",
"service_date": "string",
"service_documentation": "string",
"shipping_address": "string",
"shipping_carrier": "string",
"shipping_date": "string",
"shipping_documentation": "string",
"shipping_tracking_number": "string",
"uncategorized_file": "string",
"uncategorized_text": "string"
},
"expand": [
"string"
],
"metadata": "string",
"submit": true
}'
```