> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Détails d'une personne

> Récupérer une personne avec ses sessions et sa heatmap d'activité

Renvoie une personne (visiteur) avec son profil, la liste de ses sessions sur la plage, et une
heatmap d'activité quotidienne. Les réponses sont toujours recalculées (non mises en cache).

**Requête :**

```bash cURL theme={null}
curl -X GET 'https://taap.it/api/v1/radar/people/details?visitorId=v_8a1c2d&start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z' \
  -H 'Authorization: Bearer taapit_votre_cle_api_ici'
```

**Réponse :**

```json theme={null}
{
  "data": {
    "visitor": {
      "visitorId": "v_8a1c2d",
      "name": "Quiet Fox",
      "email": "jane@example.com",
      "status": "identified",
      "countryCode": "FR",
      "countryName": "France",
      "source": "google",
      "browser": "Chrome",
      "device": "desktop",
      "revenue": 120.0,
      "sessions": 4,
      "firstSeen": "2026-01-03T09:12:00.000Z",
      "lastSeen": "2026-01-28T17:42:00.000Z"
    },
    "sessions": [
      {
        "sessionId": "s_5f2a",
        "startTime": "2026-01-28T17:10:00.000Z",
        "endTime": "2026-01-28T17:42:00.000Z",
        "durationSeconds": 1920,
        "referrer": "google",
        "device": "desktop",
        "browser": "Chrome",
        "os": "macOS"
      }
    ],
    "heatmap": [
      { "date": "2026-01-28", "events": 12 }
    ]
  }
}
```

## Autorisation

<ParamField header="Authorization" type="string" required>
  Jeton Bearer avec votre clé API Radar. Format : `Bearer taapit_...`
</ParamField>

## Paramètres de requête

<ParamField query="visitorId" type="string" required>
  L'identifiant du visiteur renvoyé par l'endpoint [Personnes](/fr/api-reference/radar/people).
</ParamField>

<ParamField query="start" type="string" required>
  Début de la plage, ISO 8601 (UTC).
</ParamField>

<ParamField query="end" type="string" required>
  Fin de la plage, ISO 8601 (UTC).
</ParamField>

## Champs de réponse

<ResponseField name="data.visitor" type="object">
  Le profil de la personne (même forme qu'une ligne de l'endpoint Personnes).
</ResponseField>

<ResponseField name="data.sessions" type="array">
  Sessions sur la plage.

  <Expandable title="Session">
    <ResponseField name="sessionId" type="string">Identifiant de session.</ResponseField>
    <ResponseField name="startTime" type="string">Début de session, ISO 8601.</ResponseField>
    <ResponseField name="endTime" type="string">Fin de session, ISO 8601.</ResponseField>
    <ResponseField name="durationSeconds" type="number">Durée de la session en secondes.</ResponseField>
    <ResponseField name="referrer" type="string">Source / référent de la session.</ResponseField>
    <ResponseField name="device" type="string">Type d'appareil.</ResponseField>
    <ResponseField name="browser" type="string">Navigateur.</ResponseField>
    <ResponseField name="os" type="string">Système d'exploitation.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="data.heatmap" type="array">
  Activité quotidienne, chaque entrée avec `date` (YYYY-MM-DD) et le nombre d'`events`.
</ResponseField>

<ResponseExample>
  ```json 404 Not Found theme={null}
  {
    "error": "Visitor not found"
  }
  ```
</ResponseExample>