Get import job

GET https://api.invunion.com/api/v1/import-jobs/:id ingest:write Markdown

Get the status, counters, and optionally the row results of one import job.

Status is pending, then processing, then completed, or failed when at least one row failed. counts breaks rows down into created, duplicates, failed, skipped, pending, and warnings.

Add rows=failed to read the failed rows with their error, or rows=all for every row and the id it created (result_id). Rows are paged by row number: pass nextAfter as after until it is null. Poll every few seconds while the job is pending or processing; the response is never cached. Row payloads are emptied when the job completes and rows are deleted 30 days later.

Path parameters

Name Type Required

id

Import job UUID, from Create import job or List import jobs.

Example: 6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d

string

No maximum

Required

Query parameters

Name	Type	Required
`rows` Include row results. Default none.	string No maximum	Optional
Allowed values`nonefailedall`
`limit` Rows per page when rows is set. Default 100, maximum 500. Example: 100	integer	Optional
`after` Return rows after this row number. Pass nextAfter of the previous response. Example: 0	integer	Optional

Errors

This operation can return the following errors in addition to generic HTTP failures.

Error	HTTP code	Description
`Missing Bearer token`	401	The Authorization header is missing or is not a Bearer token.
`Invalid or revoked API key`	401	The API key is unknown, malformed, expired, or has been revoked.
`API key is missing scope ingest:write`	403	The key does not include ingest:write. A write scope does not imply the matching read scope.
`Too many requests, please try again later`	429	More than 100 requests in one minute from this API key or IP address. Wait for the Retry-After header (seconds) and retry.
`Invalid job id`	400	The path is not a UUID.
`Import job not found`	404	No import job with this UUID exists in the authenticated tenant.
`Internal server error`	500	Unexpected server error. The JSON body includes correlationId. Retry with backoff.

Previous: List import jobs Next: Create import job

Request

Requests in the examples call https://api.invunion.com/api/v1/import-jobs/6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d.

curl --request GET \
  --url https://api.invunion.com/api/v1/import-jobs/6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d?rows=failed \
  --header 'accept: application/json' \
  --header 'authorization: Bearer uk_live_YOUR_API_KEY'

import requests

url = "https://api.invunion.com/api/v1/import-jobs/6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d?rows=failed"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY",
}
response = requests.get(url, headers=headers)
print(response.json())

require 'net/http'
require 'json'
require 'uri'

uri = URI("https://api.invunion.com/api/v1/import-jobs/6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d?rows=failed")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Accept'] = 'application/json'
request['Authorization'] = 'Bearer uk_live_YOUR_API_KEY'
response = http.request(request)
puts response.body

const response = await fetch("https://api.invunion.com/api/v1/import-jobs/6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d?rows=failed", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY"
  },
});
const data = await response.json();

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://api.invunion.com/api/v1/import-jobs/6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d?rows=failed", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Authorization", "Bearer uk_live_YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

const response = await fetch("https://api.invunion.com/api/v1/import-jobs/6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d?rows=failed", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer uk_live_YOUR_API_KEY"
  },
});
console.log(await response.json());

200

{
  "success": true,
  "data": {
    "id": "6a4deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
    "type": "bulk_import",
    "file_name": "transaction-api-import.json",
    "status": "failed",
    "total_rows": 2,
    "processed_rows": 2,
    "successful_rows": 1,
    "failed_rows": 1,
    "created_at": "2026-09-12T08:00:00.000Z",
    "completed_at": "2026-09-12T08:00:04.000Z",
    "entity": "transaction",
    "errors": null,
    "duplicate_rows": 0,
    "started_at": "2026-09-12T08:00:01.000Z",
    "result": null,
    "counts": {
      "created": 1,
      "duplicates": 0,
      "failed": 1,
      "skipped": 0,
      "pending": 0,
      "warnings": 0,
      "total": 2
    },
    "rows": [
      {
        "row_number": 2,
        "status": "failed",
        "result_id": null,
        "error": "amount: Expected number, received string",
        "warning": null
      }
    ],
    "nextAfter": null
  }
}