# Disputes API

> Disputes API on Apizie: 15 endpoints (List disputes, Show dispute details, Partially update dispute, Provide evidence, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/payments:paypal-disputes/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `payments:paypal-disputes`
- Category: Payments
- Status: byok
- Source: https://paypal
- Page: https://apizie.tech/api/payments/paypal-disputes
- OpenAPI: https://apizie.tech/api/payments/paypal-disputes/openapi.json

Occasionally, something goes wrong with a customer's order. To dispute a charge, a customer can create a dispute with PayPal. PayPal merchants, partners, and external developers can use the PayPal Disputes API to…

## Endpoints

### List disputes
`GET https://apizie.tech/v1/payments:paypal-disputes/disputes-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| start_time | string | no | Filters the disputes in the response by a creation date and time. The start time must be within the last 180 days. Value is in [Internet… |
| disputed_transaction_id | string | no | Filters the disputes in the response by a transaction, by ID. You can specify either but not both the `start_time` and… |
| page_size | integer | no | Limits the number of disputes in the response to this value. |
| next_page_token | string | no | The token that describes the next page of results to fetch. The list disputes call returns this token in the HATEOAS links in the response. |
| dispute_state | string | no | Filters the disputes in the response by a state. Separate multiple values with a comma (`,`). When you specify more than one… |
| update_time_before | string | no | The date and time when the dispute was last updated, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).… |
| update_time_after | string | no | The date and time when the dispute was last updated, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6).… |

### Show dispute details
`GET https://apizie.tech/v1/payments:paypal-disputes/disputes-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |

### Partially update dispute
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-patch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | JSON request body |

### Provide evidence
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-provide-evidence` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | Form fields as a JSON object |

### Appeal dispute
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-appeal` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | Form fields as a JSON object |

### Accept claim
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-accept-claim` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | Form fields as a JSON object |

### Settle dispute
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-adjudicate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | JSON request body |

### Update dispute status
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-require-evidence` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | yes | JSON request body |

### Escalate dispute to claim
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-escalate` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | JSON request body |

### Send message about dispute to other party
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-send-message` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | Form fields as a JSON object |

### Make offer to resolve dispute
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-make-offer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | JSON request body |

### Accept offer to resolve dispute
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-accept-offer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | JSON request body |

### Deny offer to resolve dispute
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-deny-offer` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | JSON request body |

### Acknowledge returned item
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-acknowledge-return-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | Form fields as a JSON object |

### Provide supporting information for dispute
`POST https://apizie.tech/v1/payments:paypal-disputes/disputes-provide-supporting-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | yes | The ID of the dispute for which to provide the supporting information. |
| body | object | no | Form fields as a JSON object |

## Example
```
curl "https://apizie.tech/v1/payments:paypal-disputes/disputes-list" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Disputes API?
Create a free Apizie key, then send GET https://apizie.tech/v1/payments:paypal-disputes/disputes-list with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Disputes API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Disputes itself also needs your own key from paypal.

### Can AI agents use the Disputes API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key payments:paypal-disputes.

### What is the status of the Disputes API?
Needs your own provider key (bring your own key)