---
title: "GET File history"
method: GET
path: "/api/histories/{file}"
---

# GET File history

`GET /api/histories/{file}`

Com este endpoint você pode obter o histórico de um documento, este normalmente inicia quando o doc é enviado para a plataforma, e finaliza quando o mesmo é assinado. <br><br> Com este histórico você pode obter todas as informações do documento, como quando ele foi editado, se um e-mail de solicitação foi aberto, se o documento foi baixado por um visitante e etc. <br><br> O histórico é composto da data e hora da atividade, no horário de Brasília, da mensagem que diz o que ocorreu com o mesmo, do usuário e empresa responsável pela ação (Caso estejam vazios, significa que a ação foi executada por um convidado, ou seja, um usuário sem cadastro no sistema) e do tipo de atividade. <br><br> O tipo de atividade por ser um de 3 tipos, sendo <b>default</b> o padrão para atividades simples, <b>success</b> para conclusões de assinatura e <b>danger</b> para alertas de ações, como ativação de proteção e recusa de assinatura.

## Path parameters

- `file` string, required

## Response `200`

200

- object
  - `data` object[] — Lista de registros do histórico do arquivo.
    - `id` integer — Identificador único do registro de histórico.
    - `company` integer — Identificador da empresa à qual o registro pertence.
    - `user` string — Identificador do usuário que realizou a ação.
    - `file` string — Document key do arquivo ao qual o histórico pertence.
    - `activity` string — Descrição da atividade registrada no histórico.
    - `time` string — Data e hora em que a atividade foi registrada.
    - `type` string — Tipo do registro de histórico.
    - `signing_key` string — Chave de assinatura associada ao registro, quando aplicável.

---

[API](https://skmtc.net/plugsign/apis/endpoints-manuais.md) · [All operations](https://skmtc.net/plugsign/apis/endpoints-manuais/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plugsign/endpoints-manuais/revisions/41e10c7c691b/schema)