---
title: "Get import"
method: GET
path: "/v1/projects/{projectSlug}/imports/{importId}"
tags: ["Imports"]
---

# Get import

`GET /v1/projects/{projectSlug}/imports/{importId}`

Returns a single import, including its recent run history.

## Path parameters

- `projectSlug` string, required — Project slug (human-readable identifier)
- `importId` string, required — Import id.

## Response `200`

Import

- ImportDetail
  - `id` string, required — Stable import identifier.
  - `organizationId` string, required — Organization that owns this import.
  - `projectId` string, required — Latitude project the traces are imported into.
  - `source` 'langfuse' | 'langsmith' | 'braintrust', required — Observability platform the import reads from.
  - `status` 'created' | 'queued' | 'running' | 'succeeded' | 'capped' | 'cancelled' | 'failed', required — Lifecycle state. `created`/`queued`/`running` are in flight; `succeeded` finished cleanly; `capped` stopped at a ceiling with everything before it kept; `cancelled` and `failed` can be retried.
  - `config` ImportConfig, required — What the import was asked to bring in, snapshotted when it was created.
    - `sourceProjectId` string, required — Id of the project on the platform the import reads from.
    - `sourceProjectName` string, required — Name of the platform project, as shown in Latitude.
    - `sourceRegion` string, required — Platform region the import runs against.
    - `rangeFrom` string, required — ISO-8601 start of the imported time range (inclusive).
    - `rangeTo` string, required — ISO-8601 end of the imported time range (exclusive).
    - `maxTraces` integer, required — Most traces this import will bring in, newest first.
    - `sessionMetadataKey` string, nullable, required — LangSmith only: run metadata key that groups traces into sessions. `null` elsewhere.
  - `stats` ImportStats, required — What the import has brought in so far.
    - `recordsFetched` integer, required — Rows read from the platform, including spans later skipped.
    - `sessionsImported` integer, required — Distinct sessions among the imported traces.
    - `tracesImported` integer, required — Traces imported. One imported trace bills one credit.
    - `spansImported` integer, required — Spans written across all imported traces.
    - `spansSkipped` integer, required — Spans skipped because they carried no usable trace or span id.
  - `error` string, nullable, required — Why the import did not finish cleanly, or which ceiling stopped a `capped` one. `status` alone says whether it failed.
  - `cancelledAt` string, nullable, required — ISO-8601 timestamp at which cancellation was requested, or `null`.
  - `startedAt` string, nullable, required — ISO-8601 timestamp at which a worker picked the import up, or `null`.
  - `finishedAt` string, nullable, required — ISO-8601 timestamp at which the import ended, or `null` while in flight.
  - `createdAt` string, required — ISO-8601 timestamp of creation.
  - `updatedAt` string, required — ISO-8601 timestamp of the last update.
  - `runs` ImportRun[], required — Recent pages the import processed, newest first. Bounded, so old pages fall off.
    - `status` 'succeeded' | 'failed', required — Whether this page of the import was written.
    - `stats` object, required — What this page alone brought in.
      - `recordsFetched` integer, required — Rows read from the platform, including spans later skipped.
      - `sessionsImported` integer, required — Distinct sessions among the imported traces.
      - `tracesImported` integer, required — Traces imported. One imported trace bills one credit.
      - `spansImported` integer, required — Spans written across all imported traces.
      - `spansSkipped` integer, required — Spans skipped because they carried no usable trace or span id.
    - `error` string, nullable, required — Why this page failed, or `null`.
    - `startedAt` string, required — ISO-8601 timestamp at which the page started.
    - `finishedAt` string, required — ISO-8601 timestamp at which the page ended.

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/latitude-dev/apis/latitude.md) · [All operations](https://skmtc.net/latitude-dev/apis/latitude/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude-dev/latitude/versions/6a8789c59a5c/schema)