---
title: "Start Rocap Import"
method: POST
path: "/v1/matters/{matter_id}/creditors/rocap-imports"
tags: ["creditors"]
---

# Start Rocap Import

`POST /v1/matters/{matter_id}/creditors/rocap-imports`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/creditors/rocap-imports`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- StartRocapImport
  - `document_id` string, uuid, required

## Response `200`

Successful Response

- RocapImportView
  - `run_id` string, uuid, required
  - `document_id` string, uuid, required
  - `filename` string, required
  - `status` 'pending' | 'running' | 'ready' | 'completed' | 'cancelled' | 'failed', required
  - `rows` RocapRowOutput[], required
    - `creditor_name` string, required
    - `row_kind` 'creditor' | 'employee', required
    - `source_page` integer, required
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
    - `email` string, nullable, required
    - `postal_address` string, nullable, required
    - `creditor_class` 'unsecured' | 'secured' | 'priority' | 'employee', required
    - `relationship_status` 'unknown' | 'not_related' | 'related', required
    - `rocap_amount` string, decimal, nullable, required
    - `secured_asset_details` string, nullable, required
    - `ppsr_registration` string, nullable, required
    - `start_date` string, date, nullable, required
    - `wages` string, decimal, nullable, required
    - `annual_leave` string, decimal, nullable, required
    - `long_service_leave` string, decimal, nullable, required
    - `superannuation` string, decimal, nullable, required
    - `redundancy` string, decimal, nullable, required
    - `other` string, decimal, nullable, required
    - `review_notes` string, nullable, required
  - `snapshot_id` string, nullable, required
  - `matches` RocapMatch[], required
    - `row_number` integer, required
    - `candidates` RocapCandidate[], required
      - `creditor_id` string, uuid, required
      - `version` string, required
      - `current_values` object, required
      - `claims` RocapClaimOption[], required
        - `revision_id` string, uuid, required
        - `amount` string, decimal, required
  - `safe_issue_code` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)