> For the complete documentation index, see [llms.txt](https://docs.malwation.com/cdr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.malwation.com/cdr/api-documentation.md).

# API Documentation

This page contains the API Requests of Malwation CDR

*If you have any further questions, feel free to ask it this email:* \
***<batuhan.isildak@malwation.com>***

{% hint style="info" %}
If you want to access Swagger docs, navigate to **/docs** in your CDR url. And also, if you want to get the JSON of the Swagger file, navigate to **/docs-json**.
{% endhint %}

{% hint style="info" %}
Every page in this documentation, like *Start Submisssion* has the **OpenAPI Documentation** of the request and an **Example Response.**&#x20;
{% endhint %}

### Status IDs & Explanations

```json
{
    "status": 1 // Received -> Submission is received from the server, but not finished yet
    "status": 2 // Finished -> Submission is finished and the "result" key is set with the result of the submission
}
```

### Example Result of a Finished Submission

```json
{
	"type": "file",
	"name": "sample.docx",
	"fileId": "58b46901099bd149b6a9c186ddd5394e2d98cfafdecd179bc428e89c01303a2b",
	"resultId": "a3d68330-4155-469c-a393-beaa645015da",
	"size": 46516,
	"hashes": {
		"sha256": "58b46901099bd149b6a9c186ddd5394e2d98cfafdecd179bc428e89c01303a2b",
		"sha1": "35d4cdeea9bf51902ca268af911c9d527af3d35e",
		"md5": "480f4b4ffb6cca1b872cf55329a8881e"
	},
	"status": 2,
	"level": 0,
	"files": [
		{
			"name": "58b46901099bd149b6a9c186ddd5394e2d98cfafdecd179bc428e89c01303a2b_sanitized.docx",
			"id": "336ccc96-286c-4a12-afce-4efe2f8fdba4"
		}
	],
	"message": "Submission is finished",
	"result": {
		"filename": "58b46901099bd149b6a9c186ddd5394e2d98cfafdecd179bc428e89c01303a2b_sanitized.docx",
		"log": {
			"description": "File sanitized successfully.",
			"removed": [
				"Metadata"
			],
			"sanitized": [
				"Image"
			],
			"processing time": "7.50170 seconds"
		}
	}
}
```

{% content-ref url="/pages/pCpBvYEUEtFhI24t6Y7u" %}
[Start Submission](/cdr/api-documentation/start-submission.md)
{% endcontent-ref %}

{% content-ref url="/pages/uzI3vrpl7JMLd6PSpY1s" %}
[Listen Submission](/cdr/api-documentation/listen-submission.md)
{% endcontent-ref %}

{% content-ref url="/pages/oKDh8kzEhIAzhWwel2p7" %}
[Download Sanitized File](/cdr/api-documentation/download-sanitized-file.md)
{% endcontent-ref %}