---
title: "Create a transaction upload job"
method: POST
path: "/uploads"
tags: ["Transaction Upload"]
---

# Create a transaction upload job

`POST /uploads`

Creates a new user and associates it with the products and transactions received in the body of the request.

## Request body

- object
  - `accounts` object[]
    - `balance` Amount — unresolved $ref
    - `balance_date` EndedAt — unresolved $ref
    - `currency` Currency — unresolved $ref
    - `iban` Iban, required — unresolved $ref
    - `bic` Bic — unresolved $ref
    - `owner` string — Name of the account holder.
    - `transactions` object[]
      - `iban` Iban, required — unresolved $ref
      - `bic` Bic — unresolved $ref
      - `amount` Amount, required — unresolved $ref
      - `booking_text` string — Booking text further describing the type of transaction.
      - `creditor_id` CreditorId — unresolved $ref
      - `currency` Currency — unresolved $ref
      - `end_to_end_reference` EndToEndReference — unresolved $ref
      - `mandate_reference` MandateReference — unresolved $ref
      - `name` string — Name of the counterparty.
      - `purpose` string, required — Purpose of the transaction potentially including other structured SEPA information (e.g. `EREF+`, `MREF+`).
      - `sepa_purpose_code` SepaPurposeCode — unresolved $ref
      - `booked_at` EndedAt, required — unresolved $ref
      - `settled_at` EndedAt — unresolved $ref

## Response `200`

- object
  - `id` string, UUID, required — finX ID of transaction upload operation
  - `status` 'QUEUED' | 'RUNNING' | 'FAILED' | 'AWAIT_AUTH' | 'COMPLETED', required — The processing state that the work item currently is in.
  - `created_at` EndedAt, required — unresolved $ref
  - `ended_at` string, date-time
  - `started_at` EndedAt — unresolved $ref
  - `access_token` string, required — The access token for the current user as JSON Web Token according to RFC7519. It has a variable length and it is highly advised to not limit the size of the database field in your storage backend. If you have to specify a size for the corresponding database field a choice of at least 2048 bytes is highly recommended.

## Other responses

- `401` — unresolved $ref

---

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