API Get Memory

API Documentation home

Quick Example

curl -H "MMT-ApiKey:<your_api_key>" https://api.modernmt.com/memories/5 | python -mjson.tool
    "status": 200,
    "data": {
        "id": 5,
        "key": "mk_f4932hg205vh7h20h05g72",
        "name": "BeautifulMemory",
        "description": "My most precious memories",
        "externalId": null,
        "creationDate": "2017-10-13T13:32:34+00:00"


This method retrieves a specific memory associated to the owner of the MMT-ApiKey header used in the HTTP Request.

If the MMT-ApiKey header is missing or invalid, this API returns an HTTP ERROR 401:

    "error": {
        "message":"Missing or invalid authentication header"

If passed ID does not correspond to any Memory that the User is connected to, this API returns an HTTP ERROR 404:

    "error": {
        "message": "Requested resource not found",
        "type": "NotFoundException"
    "status": 404

Resource URL


Request Fields

None. The memory identifier is specified directly in the URL. Note: the identifier can be:

  • the id of the MMT Memory that this ServiceApi Memory refers to (example: 5);
  • the ServiceApi Memory Key (example: mk_f4932hg205vh7h20h05g72);

Response Fields

Name Description
id The ModernMT Memory id for this Memory.

Example: 5
key The ServiceApi Memory key for this Memory.

Example: mk_f4932hg205vh7h20h05g72
externalId Private parameter for internal use only
name The name with which this user was linked to the memory.

Example: BeautifulMemory
description The description with which this user was linked to the memory.

Example: My most precious memories
creationDate A timestamp marking the instant that the Memory was created. It refers to the Memory, and not to the link between User and Memory.

Example: 2017-10-13T13:32:34+00:00