List import jobs

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

List recent import jobs, newest first.

Returns import jobs of every origin, newest first, with their counters. Page with cursor: pass pagination.nextCursor until pagination.hasMore is false. Pagination sits next to data, not inside it.

Query parameters

Name Type Required

limit

Page size. Default 25, maximum 100.

Example: 25

integer

Optional

cursor

Opaque cursor: pass pagination.nextCursor of the previous response.

Example: Y3JlYXRlZF9hdDpkZXNjfDIwMjYtMDktMDhUMTQ6MTA6MDAuMDAwWnw3ZDljMTNlNA

string

No maximum

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 cursor`	400	The cursor is malformed or was not issued by this endpoint.
`Internal server error`	500	Unexpected server error. The JSON body includes correlationId. Retry with backoff.

Previous: Delete match Next: Get import job

Request

Requests in the examples call https://api.invunion.com/api/v1/import-jobs.

curl --request GET \
  --url https://api.invunion.com/api/v1/import-jobs?limit=25 \
  --header 'accept: application/json' \
  --header 'authorization: Bearer uk_live_YOUR_API_KEY'

import requests

url = "https://api.invunion.com/api/v1/import-jobs?limit=25"
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?limit=25")
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?limit=25", {
  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?limit=25", 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?limit=25", {
  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": "completed",
      "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"
    },
    {
      "id": "c2e16839-8f5b-44d6-1f58-65942072ea18",
      "type": "bulk_import",
      "file_name": "counterparties-september.json",
      "status": "completed",
      "total_rows": 18,
      "processed_rows": 18,
      "successful_rows": 18,
      "failed_rows": 0,
      "created_at": "2026-09-01T07:30:00.000Z",
      "completed_at": "2026-09-01T07:30:03.000Z",
      "entity": "counterparty"
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasMore": false
  }
}

List import jobs

See also

Query parameters

Errors