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

# Run an import job

> The bulk loading path behind the import guides: create a job, upload a CSV or JSONL file, and read the results.

The Data Import Service is the bulk loading path used by Store Service, Offers and others. It validates, processes and imports data from external systems in a controlled, observable way — **asynchronously**, so a large load never blocks your call.

It handles tens of thousands of records or more, and applies back-pressure and throttling so a big import cannot overwhelm the service receiving it.

Use it to migrate from legacy systems, bulk load POS transactions, run scheduled synchronisations, or correct records in bulk.

## How an import runs

<Steps>
  <Step>
    ### Create the job

    Returns a `jobId` that identifies the operation from here on.
  </Step>

  <Step>
    ### Upload and validate

    The file is parsed and every record checked against business rules.
  </Step>

  <Step>
    ### Process valid records

    Validated data is passed to the target service.
  </Step>

  <Step>
    ### Read the results

    Processed, succeeded and failed counts, with detailed errors per failed row.
  </Step>
</Steps>

Poll the job status to follow progress. When rows fail validation, pull the errors, fix the source and re-run.

<Info>
  The **v2 API** creates the job and uploads the file in one request. Prefer it for new integrations — it removes a round trip and a whole class of half-created-job states.
</Info>

## File formats

Both formats require field names matching the target entity's schema.

| | CSV | JSONL |
| - | - | - |
| Encoding | UTF-8 | UTF-8 |
| Structure | Header row plus rows | One JSON object per line |
| Delimiters | Comma or semicolon | n/a |
| Suits | Exports from spreadsheets and ERPs | Streaming and high volumes — each line is processed independently |

A JSONL file looks like this:

```json theme={"system"}
{"id": "store-1", "name": "Main Store"}
{"id": "store-2", "name": "Second Store"}
```

## API reference

Endpoint documentation: [Data Import](/api-reference/data-import).

## Related

* [Retail Master Data](/integration/retail-master-data) — the data each import carries, and the order to run the imports in.


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