> For the complete documentation index, see [llms.txt](https://developer.doctranslate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.doctranslate.io/document-translation-api/user-api/user-history.md).

# User History

#### HTTP request <a href="#http-request" id="http-request"></a>

POST `/user/history`

**Authorization(***Bearer token or API key)*

*OAuth2PasswordBearer*

```
Authorization: OAuth2PasswordBearer
```

Header API Key

```
X-API-Key: <your_api_key>
```

**Query Parameter**

| KEY        | TYPE    | VALUE                                                                                    |
| ---------- | ------- | ---------------------------------------------------------------------------------------- |
| page       | Integer | The page number to retrieve, for pagination. Must be greater than 0.                     |
| page\_size | Integer | The number of items to retrieve per page, for pagination. Must be greater than 0.        |
| keyword    | String  | A keyword to search for file name. Used to filter results based on a specific criterion. |
|            |         |                                                                                          |

**Body Payload**

| KEY         | TYPE   | VALUE                                                                                                                              |
| ----------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| start\_date | String | <p>The start time for the query. Should be in ISO 8601 format.<br>format: yyyy-mm-dd hh-mm-ss utc+7<br>ex: 2024-03-07 04:44:11</p> |
| end\_date   | String | <p>The end time for the query. Should be in ISO 8601 format.<br>format: yyyy-mm-dd hh-mm-ss utc+7<br>ex: 2024-03-07 15:44:11</p>   |
|             |        |                                                                                                                                    |

**Response**

**200:** Success

Response schema: *application/json*

| KEY          | VALUE                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| status\_code | 200                                                                                                                                                                                                                                                                                                                                                                                                 |
| content      | { "data": \[ { "id": 26524, "file\_name": "5\_1709782940\_trial.docx", "url\_download": "\<translated\_file\_download\_URL>", "translation\_type": "Document", "datetime": "2024-03-07 04:44:11", "cost": 1, "credit": 1, "dest\_lang": "en", "share\_url": "" } ], "errors": \[], "error\_description": "", "start\_time": "yyyy-mm-dd hh-mm-ss utc+7", "end\_time": "yyyy-mm-dd hh-mm-ss utc+7" } |

**400:** Bad Request

| KEY          | VALUE                                                                                                                                                                                                   |   |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| status\_code | 400                                                                                                                                                                                                     |   |
| content      | { "data": {}, "errors": \[ "Error" ], "error\_description": "Error while sending message. Please check server!", "start\_time": "yyyy-mm-dd hh-mm-ss utc+7", "end\_time": "yyyy-mm-dd hh-mm-ss utc+7" } |   |
|              |                                                                                                                                                                                                         |   |

**401: A**uthentication Error

| KEY          | VALUE                             |   |
| ------------ | --------------------------------- | - |
| status\_code | 401                               |   |
| content      | { "detail": "Not authenticated" } |   |
|              |                                   |   |

Response schema: *application/json*

| detail |   |
| ------ | - |