# Dispute OpenAPI Specification

This is the documentation for the Ratepay Dispute API. The API is still in development and subject to change. This documentation will evolve as the development of the API progresses.

Version: version

## Servers

Ratepay Integration Platform
```
https://api-integration.ratepay.com/dispute/management
```

## Security

### Bearer Authentication

For each request, a valid access token must be provided in the Authorization header. See [Authentication API](/docs/developer/authentication/authentication/) for obtaining a valid token.

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Dispute OpenAPI Specification](https://docs.ratepay.com/_bundle/apis/dispute/openapi/dispute_api.yaml)

## Other

### Provide evidence for ITEM_NOT_RECEIVED

 - [POST /v1/disputes/{ratepay_dispute_id}/evidences/item-not-received](https://docs.ratepay.com/apis/dispute/openapi/dispute_api/other/itemnotreceived.md): Endpoint to provide evidence for the ITEM_NOT_RECEIVED request for information.

A valid JWT token is required in order to perform requests against this API.
See Ratepay Authentication API specification.

### Provide evidence for ITEM_RETURNED

 - [POST /v1/disputes/{ratepay_dispute_id}/evidences/item-returned](https://docs.ratepay.com/apis/dispute/openapi/dispute_api/other/itemreturned.md): Endpoint to provide evidence for the ITEM_RETURNED request for information.

A valid JWT token is required in order to perform requests against this API.
See Ratepay Authentication API specification.

### Provide evidence for DEFEND

 - [POST /v1/disputes/{ratepay_dispute_id}/evidences/defend](https://docs.ratepay.com/apis/dispute/openapi/dispute_api/other/defend.md): Endpoint to provide evidence for the DEFEND request for information.

A valid JWT token is required in order to perform requests against this API.
See Ratepay Authentication API specification.

### Provide evidence for FRAUD

 - [POST /v1/disputes/{ratepay_dispute_id}/evidences/fraud](https://docs.ratepay.com/apis/dispute/openapi/dispute_api/other/fraud.md): Endpoint to provide evidence for the FRAUD request for information.

A valid JWT token is required in order to perform requests against this API.
See Ratepay Authentication API specification.