---
title: "Import Creditors"
method: POST
path: "/v1/matters/{matter_id}/creditors/actions/import"
tags: ["creditors"]
---

# Import Creditors

`POST /v1/matters/{matter_id}/creditors/actions/import`

## 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/actions/import`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body `multipart/form-data`

- ImportCreditors
  - `file` string, binary, required
  - `mapping` string, nullable
  - `ignored_columns` string, nullable
  - `number_format` 'auto' | 'decimal_point' | 'decimal_comma'
  - `skipped_rows` string, nullable
  - `cell_edits` string, nullable

## Response `200`

Successful Response

- CreditorImportResult
  - `contract` 'creditors.spreadsheet-import.result.v1', required
  - `import_id` string, uuid, required
  - `imported_count` integer, required
  - `review_count` integer, required
  - `skipped_count` integer, required
  - `replayed` boolean, 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)
