# Fetch a stretch of a Matomo's reports

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/post-sites-site-imports-matomo

`POST /api/v1/sites/{site}/imports/matomo`

Fetch a stretch of a Matomo's reports. The answer is a file: check it and import it like any other, with `source=matomo`. The token is used for this one request and not kept.

## Parameters

- `site` (in path, needed): The site's id or name

## What to send

`MatomoFetch`: Which Matomo to ask for its reports, and for which days. The token is used for the one request this is and is never kept.

- `id_site` (integer): Matomo's number for the site: `idSite` in its address.
- `since` (string or null): The first day, `2025-01-03`. Left out: a year before the last.
- `token` (string): A token of Matomo's with view access to that site.
- `until` (string or null): The last day. Left out: yesterday.
- `url` (string): Where Matomo answers: `https://matomo.example.org`.

## The answer

200, `string`

## Asking

```sh
curl -X POST https://tidekeeper.eu/api/v1/sites/example.org/imports/matomo \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{}'
```