# Get Contact History

Reads a contact’s history of subscriptions, tagging, messages, feedback and notes, newest first and cursor-paginated. Entries include time, type, category and app text.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "contactId": {
      "type": "integer",
      "description": "Numeric contact ID returned by search-contacts",
      "minimum": 1
    },
    "category": {
      "type": [
        "null",
        "string"
      ],
      "description": "Only entries of this group of the app's history filter; omit for every entry",
      "default": null,
      "enum": [
        "subscription",
        "tagging",
        "miscellaneous",
        "other"
      ]
    },
    "cursor": {
      "type": [
        "null",
        "string"
      ],
      "description": "Opaque nextCursor value of the previous page; omit for the first page",
      "default": null,
      "maxLength": 500
    },
    "pageSize": {
      "type": "integer",
      "description": "Maximum entries on the page, from 1 through 100",
      "default": 50,
      "minimum": 1,
      "maximum": 100
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account the access token works in",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "contactId"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "contactId",
    "historyUrl",
    "count",
    "hasNextPage",
    "nextCursor",
    "entries"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "contactId": {
      "type": "integer"
    },
    "historyUrl": {
      "type": "string"
    },
    "count": {
      "type": "integer"
    },
    "hasNextPage": {
      "type": "boolean"
    },
    "nextCursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "date",
          "type",
          "category",
          "text",
          "referenceId"
        ],
        "properties": {
          "date": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "enum": [
              "subscription",
              "tagging",
              "miscellaneous",
              "other"
            ]
          },
          "text": {
            "type": "string"
          },
          "referenceId": {
            "type": "integer"
          }
        }
      }
    }
  }
}
```