# Decisionly API Documentation - [Introduction](https://docs.decisionly.com/introduction.md): Get started with the Decisionly API to automate dispute filing - [Quickstart](https://docs.decisionly.com/quickstart.md): Learn how to file your first dispute with the Decisionly API - [What Are Disputes?](https://docs.decisionly.com/guide.md): What disputes are, how they work, and what you need to know as an issuer - [Dispute Types](https://docs.decisionly.com/dispute-types.md): Understanding dispute categories and required evidence - [Authentication](https://docs.decisionly.com/authentication.md): Learn how to authenticate with the Decisionly API - [API Versioning](https://docs.decisionly.com/versioning.md): Understanding Decisionly API versions and changes - [Pagination](https://docs.decisionly.com/pagination.md): Learn how to paginate through list responses - [Errors](https://docs.decisionly.com/errors.md): Understanding Decisionly API error responses - [Case Lifecycle](https://docs.decisionly.com/case-lifecycle.md): Understanding case statuses and terminal states - [Webhooks](https://docs.decisionly.com/webhooks.md): Receive real-time updates about your cases - [Custom Fields](https://docs.decisionly.com/custom-fields.md): Associate additional metadata with your cases - [Reference IDs](https://docs.decisionly.com/reference-ids.md): Link cases to your internal systems with reference IDs - [Categorization](https://docs.decisionly.com/categorization.md): How Decisionly categorizes disputes with reason 'other' - [Recovered Amount](https://docs.decisionly.com/recovered-amount.md): How much of a disputed amount was recovered through the chargeback - [Testing](https://docs.decisionly.com/testing.md): Use test mode overrides and simulated outcomes to test your integration - [Filing a Dispute](https://docs.decisionly.com/filing.md): Learn how to file disputes with the card network - [Filing Timelines](https://docs.decisionly.com/filing-timelines.md): Filing windows for each dispute type and card network - [Filing Requirements](https://docs.decisionly.com/filing-requirements.md): Required fields and documentation for each dispute type and card network - [Workflow Rules](https://docs.decisionly.com/workflow-rules.md): Customize filing decisions with workflow rules - [Fraud Liability](https://docs.decisionly.com/fraud-liability.md): Network data checks for fraud disputes - [Evidence Review](https://docs.decisionly.com/evidence-review.md) - [Create a case](https://docs.decisionly.com/api-reference/v2-cases/create-a-case.md): Creates a new case. - [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. - [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. - [Run a case workflow](https://docs.decisionly.com/api-reference/v2-cases/run-a-case-workflow.md): Evaluates your workflow rules for the case. - [File a case](https://docs.decisionly.com/api-reference/v2-cases/file-a-case.md): Files a case as a chargeback with the card network, bypassing workflow rule evaluation. - [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. - [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. ## OpenAPI Specs - [openapi](/api-reference/v2/openapi.yaml) ## Optional - [Dashboard](https://decisionly.com) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.