---
title: "List history imports"
method: GET
path: "/v1/projects/{projectId}/geo/traffic/imports"
tags: ["GEO"]
---

# List history imports

`GET /v1/projects/{projectId}/geo/traffic/imports`

## Request

- Base URL: `https://api.usenotra.com`
- URL: `https://api.usenotra.com/v1/projects/{projectId}/geo/traffic/imports`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/usenotra/apis/notra-api/docs/v1/projects/:projectId/geo/traffic/imports/get.ts> (a function with typed inputs; its response is checked against the schema)

Imports of earlier analytics from Plausible, Cloudflare or Vercel and their progress, newest first. Connections and their credentials are never returned; start imports in the dashboard.

## Path parameters

- `projectId` string, required

## Response `200`

Imports fetched successfully

- GeoAnalyticsImportsResponse
  - `imports` object[], required
    - `id` string, required
    - `projectId` string, required
    - `provider` 'plausible' | 'plausible_csv' | 'vercel' | 'cloudflare' | 'cloudflare_rum' | 'rybbit' | 'databuddy', required
    - `kind` 'web' | 'geo', required: web: page views; geo: AI crawler requests.
    - `sourceLabel` string, required
    - `host` string, required
    - `status` 'pending' | 'running' | 'waiting_rate_limit' | 'completed' | 'failed' | 'deleting' | 'deleted', required
    - `startDay` string, nullable, required
    - `endDay` string, nullable, required
    - `cutoffDay` string, nullable, required: First day of native tracking; imports stop before it.
    - `chunksTotal` integer, required
    - `chunksDone` integer, required
    - `pageviewsImported` integer, required
    - `rowsWritten` integer, required
    - `capabilities` object, required
      - `visitors` boolean, required
      - `visits` boolean, required
      - `bounces` boolean, required
      - `utm` boolean, required
      - `entryPages` boolean, required
      - `sampled` boolean, required
    - `lastError` string, nullable, required
    - `retryAt` string, nullable, required
    - `createdAt` string, required
    - `completedAt` string, nullable, required
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `402`: GEO plan or available AI credits required
- `403`: Forbidden
- `404`: Organization, project or resource not found
- `409`: Conflict
- `500`: Internal server error
- `503`: Authentication or billing service unavailable

## Changes

- **2026-11-10** `607f9fffb6c7`: 2 warning
  - added the new `databuddy` enum value to the `imports/items/provider` response property for the response status `200`
  - added the new `rybbit` enum value to the `imports/items/provider` response property for the response status `200`
- **2026-11-08** `41d74f2b285c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/projects/:projectId/geo/traffic/imports/get.md)

---

[API](https://skmtc.dev/usenotra/apis/notra-api.md) - [All operations](https://skmtc.dev/usenotra/apis/notra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usenotra/apis/notra-api/revisions/f07268f0bc6a?raw)