---
title: "POST /business/data/batch-upload"
method: POST
path: "/business/data/batch-upload"
tags: ["Sharing business data"]
---

# POST /business/data/batch-upload

`POST /business/data/batch-upload`

Create a batch to upload data about a particular business.

This endpoint returns an <code>id</code> that should be put into all /business/data/XXX endpoints.

**Why use batch?**
- with the batch, you can send accounts transactions in chunks instead of sending them all in a single API call
- with the batch, you can share more <code>context</code> (see parameter below) with us which enables us to update credit lines more accurately

## Request body

- APICreateBatchUpload
  - `auto_cancel_ongoing_batch_for_business` boolean
  - `business_identifier` BusinessIdentifierRequired, required
    - `identifier` string, required
    - `identifier_type` 'belgium_registration_number' | 'bsn' | 'cif' | 'hr_nummer' | 'kvk' | 'name' | 'nif' | 'siren' | 'siret' | 'steuernummer' | 'vat_number', required
  - `content` APIBatchUploadContent, required
    - `account_transactions` BatchUploadContentAccountTransactionsOneAccount[], nullable
      - `account` string, required
      - `end_date` string, date-time, required
      - `start_date` string, date-time, required
    - `accounts` BatchUploadContentAccounts
      - `total_count` integer, required
    - `invoices` BatchUploadContentInvoices
      - `total_count` integer, required
    - `shared_data_types` string[]
  - `context` 'BORROWER_CREATION' | 'DATA_REFRESH', required

## Response `201`

Created

---

[API](https://skmtc.net/getdefacto/apis/api-reference.md) · [All operations](https://skmtc.net/getdefacto/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdefacto/api-reference/revisions/0a9c1f8784f2/schema)