📜 Get org’s translation history log

This API returns a paginated list of translation records (history) for an organization or user account.

📋 Basic Information

Method: GET
Path: https://api.bluente.com/api/20250924/blu_translate/history
Authentication: Required — Authorization: Bearer $BLUENTE_API_KEY

📝 Request Parameters (Query)

Query String

Field	Type	Required	Description
`caller`	string	No	Caller name, `"blutranslate"` by default
`next_token`	string	No	Pagination token for next page; omit or empty to fetch the first page

Request Body

None

💡 Example

curl -X GET "https://api.bluente.com/api/20250924/blu_translate/history?caller=blutranslate&next_token=xxx" \
     -H "Authorization: Bearer $BLUENTE_API_KEY" \
     -H "Accept: application/json"

fetch("https://api.bluente.com/api/20250924/blu_translate/history?caller=blutranslate&next_token=xxx", {
  method: "GET",
  headers: {
    "Authorization": "Bearer $BLUENTE_API_KEY"
  }
})

✅ Success Response Example

{
  "message": "success",
  "code": 0,
  "data": {
    "translations": [
      {
        "id": 2480,
        "file_extension": ".docx",
        "page_count": 70,
        "deducted": 0,
        "source_lang": "",
        "target_lang": "",
        "state_str": "SERVICE_PROCESSED",
        "created_at": "2024-08-06 09:44:39",
        "created_by": "tech@bluente.com",
        "updated_at": "2024-08-06 09:44:50"
      },
      {
        "id": 2479,
        "file_extension": ".docx",
        "page_count": 70,
        "deducted": 0,
        "source_lang": "",
        "target_lang": "",
        "state_str": "SERVICE_PROCESSED",
        "created_at": "2024-08-06 09:44:39",
        "created_by": "tech@bluente.com",
        "updated_at": "2024-08-06 09:44:50"
      },
      {
        "id": 2471,
        "file_extension": ".docx",
        "page_count": 70,
        "deducted": 0,
        "source_lang": "en",
        "target_lang": "zh",
        "state_str": "READY",
        "created_at": "2024-08-06 09:44:39",
        "created_by": "tech@bluente.com",
        "updated_at": "2024-08-06 10:00:43"
      }
    ],
    "next_token": "2471" // if this next_token is empty means no more logs; otherwise pass this value to the next request
  }
}

📊 Response Fields

Field	Type	Description
`message`	string	Response message, usually `"success"`
`code`	int	Status code, `0` means success
`data.translations`	array	List of translation log entries
`translations[].id`	int	Translation task ID
`translations[].file_extension`	string	Original file extension (e.g., `.docx`)
`translations[].page_count`	int	Number of pages in the file
`translations[].deducted`	int	Pages deducted from account for this translation
`translations[].source_lang`	string	Source language code (may be empty)
`translations[].target_lang`	string	Target language code (may be empty)
`translations[].state_str`	string	Task state (e.g., `SERVICE_PROCESSED`, `READY`)
`translations[].created_at`	string	Creation timestamp
`translations[].created_by`	string	Creator (user email)
`translations[].updated_at`	string	Last update timestamp
`data.next_token`	string	Pagination token for next page; empty means no more pages

❌ Error Response Example

{
  "message": "unauthorized",
  "code": 401
}

📌 Notes

Use next_token for pagination: if the response data.next_token is non-empty, supply it in the next request to fetch the following page.
deducted indicates how many pages were charged for that translation (may be 0 for some internal/system entries).
state_str corresponds to the same status values used by the Get Translation Status API (e.g., SERVICE_PROCESSED, READY, ERROR).

Download file Upload