# Decisionly API Documentation

## Docs

- [Create a case](https://docs.decisionly.com/api-reference/v1-cases/create-a-case.md): Creates a new case.
- [Delete a case](https://docs.decisionly.com/api-reference/v1-cases/delete-a-case.md): Deletes a case by ID.
- [List all cases](https://docs.decisionly.com/api-reference/v1-cases/list-all-cases.md): Returns a list of all cases.
- [Retrieve a case](https://docs.decisionly.com/api-reference/v1-cases/retrieve-a-case.md): Returns a case by ID.
- [Update a case](https://docs.decisionly.com/api-reference/v1-cases/update-a-case.md): Updates a case.
- [Withdraw a case](https://docs.decisionly.com/api-reference/v1-cases/withdraw-a-case.md): Withdraws a case. Cases will have status 'closed' and closed_reason set to 'withdrawn'.
- [List all events](https://docs.decisionly.com/api-reference/v1-events/list-all-events.md): Returns a list of all events for an account. Events are also delivered via webhooks - see the [Webhooks documentation](/webhooks) for more details.
- [Upload a file](https://docs.decisionly.com/api-reference/v1-files/upload-a-file.md): Upload a file that can be attached as evidence to cases.
- [Create a case](https://docs.decisionly.com/api-reference/v2-cases/create-a-case.md): Creates a new case.
- [Delete a case](https://docs.decisionly.com/api-reference/v2-cases/delete-a-case.md): Deletes a case by ID. Filed cases cannot be deleted.
- [File a case](https://docs.decisionly.com/api-reference/v2-cases/file-a-case.md): Files a case with the card network. The case must be in 'created' status to be filed.
- [List all cases](https://docs.decisionly.com/api-reference/v2-cases/list-all-cases.md): Returns a list of all cases.
- [Retrieve a case](https://docs.decisionly.com/api-reference/v2-cases/retrieve-a-case.md): Returns a case by ID.
- [Update a case](https://docs.decisionly.com/api-reference/v2-cases/update-a-case.md): Updates a case. Filed cases cannot be updated. Partial updates are supported - you only need to include the fields you want to update in the request body.
- [Withdraw a case](https://docs.decisionly.com/api-reference/v2-cases/withdraw-a-case.md): Withdraws a case. The case must be in 'created' or 'chargeback_filed' status to be withdrawn.
- [Create a claim](https://docs.decisionly.com/api-reference/v2-claims/create-a-claim.md): Creates a new claim by grouping existing cases together.
- [Create a claim with cases](https://docs.decisionly.com/api-reference/v2-claims/create-a-claim-with-cases.md): Creates a new claim and all its cases in a single request.
- [File a claim](https://docs.decisionly.com/api-reference/v2-claims/file-a-claim.md): Files each case in the claim to the card network.
- [List all claims](https://docs.decisionly.com/api-reference/v2-claims/list-all-claims.md): Returns a simplified list of all claims. Use the retrieve endpoint to get full claim details with cases.
- [Retrieve a claim](https://docs.decisionly.com/api-reference/v2-claims/retrieve-a-claim.md): Returns a claim by ID with all associated cases and their full details.
- [Set claim cases](https://docs.decisionly.com/api-reference/v2-claims/set-claim-cases.md): Replaces all cases in a claim with the supplied list.
- [Withdraw a claim](https://docs.decisionly.com/api-reference/v2-claims/withdraw-a-claim.md): Withdraws all cases in a claim.
- [List all events](https://docs.decisionly.com/api-reference/v2-events/list-all-events.md): Returns a list of all events for an account. Events are also delivered via webhooks - see the [Webhooks documentation](/webhooks) for more details.
- [Upload a file](https://docs.decisionly.com/api-reference/v2-files/upload-a-file.md): Upload a file that can be attached as documentation to cases.
- [Authentication](https://docs.decisionly.com/authentication.md): Learn how to authenticate with the Decisionly API
- [Case Lifecycle](https://docs.decisionly.com/case-lifecycle.md): Understanding case statuses and terminal states
- [Categorization](https://docs.decisionly.com/categorization.md): How Decisionly categorizes disputes with reason 'other'
- [Custom Fields](https://docs.decisionly.com/custom-fields.md): Associate additional metadata with your cases
- [Dispute Types](https://docs.decisionly.com/dispute-types.md): Understanding dispute categories, required evidence, and filing windows
- [Errors](https://docs.decisionly.com/errors.md): Understanding Decisionly API error responses
- [Evidence Review](https://docs.decisionly.com/evidence-review.md)
- [Filing](https://docs.decisionly.com/filing.md): Learn how to file chargebacks with the card network
- [Fraud Validations](https://docs.decisionly.com/fraud-validations.md): Network data checks for fraud disputes
- [Introduction](https://docs.decisionly.com/introduction.md): Get started with the Decisionly API to automate dispute filing
- [Pagination](https://docs.decisionly.com/pagination.md): Learn how to paginate through list responses
- [Quickstart](https://docs.decisionly.com/quickstart.md): Learn how to file your first dispute with the Decisionly API
- [Reference IDs](https://docs.decisionly.com/reference-ids.md): Link cases to your internal systems with reference IDs
- [API Versioning](https://docs.decisionly.com/versioning.md): Understanding Decisionly API versions and changes
- [Webhooks](https://docs.decisionly.com/webhooks.md): Receive real-time updates about your cases
- [Workflow Rules](https://docs.decisionly.com/workflow-rules.md): Customize filing decisions with workflow rules

## OpenAPI Specs

- [openapi](https://docs.decisionly.com/api-reference/openapi.json)

## Optional

- [Dashboard](https://decisionly.com)