Skip to main content
GET
List Import Attempts

Authorizations

Authorization
string
header
required

User-principal OAuth 2.0 Bearer authentication. Send a user-scoped Auth0 access token (audience = the app API audience) as Authorization: Bearer <jwt>. The request resolves to the user's identity and is authorized by their Role on the {companyId} in the path — the same role-based permissions the web app enforces. This is the path the MCP connector uses to act on a user's behalf; endpoints that accept it list both BearerAuth and ApiKeyAuth.

Path Parameters

companyId
string<uuid>
required

Company identifier

Query Parameters

jobId
string<uuid>

Select attempts produced by this transformation job.

page
integer
default:1

1-based page number. Defaults to the first page. A page above 9007199254740991, or a page and pageSize whose product skips past that many rows, is a 400.

Required range: 1 <= x <= 9007199254740991
pageSize
integer
default:50

Number of attempts per page (default 50, maximum 100). A pageSize above 100 is silently clamped to 100 rather than rejected; read the returned pageSize. Each attempt carries its transformations, guards and results, so pages stay small.

Required range: 1 <= x <= 100
importBatch
string

Only attempts on import rows sent with this importBatch.

Minimum string length: 1
attemptBatch
string

Only attempts recorded with this attemptBatch.

Minimum string length: 1
importRowId
string<uuid>

Only attempts on this import row.

entityType
enum<string>

Only attempts importing this entity type. A type you may not import is a 403.

Available options:
Event,
Exposure,
Quote,
Submission,
Person,
Organization,
Policy
action
enum<string>

Only attempts that created, or updated, an entity. An attempt whose transformations failed before the entity existed has no action and matches neither.

Available options:
create,
update

Response

One page of the company's import attempts

One page of a company's import attempts, newest first.

items
object[]
required

The attempts on this page, newest first.

totalCount
integer
required

How many attempts match the filters, ignoring the pagination.

page
integer
required

The effective one-based page number.

Required range: x >= 1
pageSize
integer
required

The effective page size, default 50 and clamped to 100.

Required range: 1 <= x <= 100