# Listado de actividad

{% hint style="info" %}
La autenticación a utilizar en este recurso es la misma que se utiliza en [Contacts API](https://developers.myperfit.com/contacts-api/autenticacion). Para obtener el API key de un usuario puedes revisar este artículo.
{% endhint %}

## /activity

<mark style="color:blue;">`GET`</mark> `https://api.myperfit.com/v2/:account/activity`

Devuelve un listado de los eventos utilizando los filtros indicados. La estructura de los objetos varía dependiendo del tipo de evento, como se indica en la sección Webhooks.

#### Path Parameters

| Name    | Type   | Description      |
| ------- | ------ | ---------------- |
| account | string | Nombre de cuenta |

#### Query Parameters

| Name                    | Type    | Description                                                                                                                                             |
| ----------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| filters.track\_type     | string  | Filtrado por tipo de evento, ej:  `track.mail.sent`, `track.mail.opened`, `track.mail.clicked`, ... Dejar vacío para recibir todo los tipos de eventos. |
| view                    | string  | Formato de salida: `full`(toda la info disponible), `default`(info básica) o `simple`(sólo email).                                                      |
| filters.timestamp.gtrel | string  | Fecha relativa de inicio de datos. Ej: `now-1h`, `now-5d`                                                                                               |
| filters.timestamp.gt    | boolean | Fecha absulta de inicio de datos. No puede indicarse en conjunto con gtrel. Ej: `2019-10-17T03:49:14Z`                                                  |
| q                       | string  | Dirección de email.                                                                                                                                     |

#### Headers

| Name           | Type   | Description                 |
| -------------- | ------ | --------------------------- |
| Authentication | string | API Key de cuenta en Perfit |

{% tabs %}
{% tab title="200 " %}

```javascript
{
    "paging": {
        "next": "",
        "total": 2,
        "results": 2
    },
    "data": [
        { ... },    
        { ... }        
    ],
}
```

{% endtab %}
{% endtabs %}

### Paginado

Para obtener las sucesivas páginas, se debe utilizar el link que aparece en `paging.next`. Si su contenido está vació significa que esa es la última págnia.