---
title: "The state of one accounting import"
method: GET
path: "/v1/imports/{job_id}"
tags: ["Analysis"]
---

# The state of one accounting import

`GET /v1/imports/{job_id}`

## Request

- Base URL: `https://carbonguru.io`
- URL: `https://carbonguru.io/v1/imports/{job_id}`
- Auth: HTTP bearer

The import's own record beside its session: the state, the counts, and whether the enriched copy of the caller's file can be downloaded. A job that is not the caller's answers 404, with no existence leak.

## Path parameters

- `job_id` string, required

## Response `200`

The import job.

- ImportJob
  - `job_id` string, required
  - `session_id` string, nullable: Present once the worker has created the analysis session. It is the job id.
  - `status` string, nullable, required: parsing, uploaded, processing, ready, failed, expired or cleaned.
  - `parser_id` string, nullable: The format the platform detected.
  - `error` string, nullable
  - `counts` object, required
    - `items` integer, nullable
    - `processed` integer, nullable
    - `failed` integer, nullable
  - `enriched_file` object, required
    - `available` boolean: Whether the download answers 200 right now.
    - `url` string
  - `links` object, required
    - `import` string
    - `session` string
    - `progress` string

## Other responses

- `401`: No valid credential. Every authentication failure returns this one document.
- `403`: A missing scope, an exhausted analysis allowance, or an object that is not the caller's.
- `404`: No such resource.
- `429`: The platform's rate limit. Retry-After carries its own stated wait.
- `503`: The platform is not serving this capability.

---

[API](https://skmtc.dev/carbonguru/apis/carbonguru-api.md) · [All operations](https://skmtc.dev/carbonguru/apis/carbonguru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonguru/apis/carbonguru-api/revisions/26dcbe7a8500?raw)