> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bulk CSV import (header row required; columns partner_item_id, upc, buyer_part,…

> Import applied

### Path parameters

**id** `string` *required*

Trading partner id

### Query parameters

**mode** `string`

merge (default) or replace

### Response

`ImportSummary`

**created** `integer` *required*

Minimum: `0`.

**removed** `integer` *required*

Rows removed because the import ran in `replace` mode. Minimum: `0`.

**rows** `integer` *required*

Minimum: `0`.

**total** `integer` *required*

Minimum: `0`.

**updated** `integer` *required*

Minimum: `0`.

### Status codes

| Code | Meaning |
| - | - |
| `200` | Import applied |
| `409` | Duplicate identifiers |
| `422` | Invalid CSV (row number in the message) or over the row cap |

### Using this contract

Read the [source OpenAPI document](/spec/edi.json) for declared schemas and alternatives.
This page also includes documented corrections from the [spec overlays](https://github.com/stateset/docs/tree/main/spec/overlays).
Example IDs and values are illustrative; replace them with records from your workspace.

```bash cURL theme={null}
curl --silent --show-error --fail-with-body --request POST \
  --url 'https://api.edi.stateset.com/v1/partners/{id}/xref/items/import' \
  --header "Authorization: Bearer $EDI_API_TOKEN"
```

```json 200 theme={null}
{
  "created": 1,
  "removed": 1,
  "rows": 1,
  "total": 102,
  "updated": 1
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.