---
title: "Create trade"
method: POST
path: "/v1/businesses/{business_id}/trade_credit_line/trades"
tags: ["Business Trade Finance"]
---

# Create trade

`POST /v1/businesses/{business_id}/trade_credit_line/trades`

Creates a trade. Note that you must upload the documents related to the trade using the `POST Upload business document` endpoint and then attach them to the trade using the `POST Add document to trade` endpoint.

## Path parameters

- `business_id` string, required

## Request body

- CreateTradeRequest
  - `trade_purpose` string, required — Purpose of the trade.
  - `trade_origin_country` string, required — ISO 3166-1 alpha-2 code of the country of the seller.
  - `trade_company_website` string, required — Website of the seller.
  - `trade_company_registration` string, required — Registration of the seller.
  - `trade_company_name` string, required — Name of the seller.
  - `trade_company_address` string, required — Address of the seller.
  - `seller_bank_account_details` object, nullable — Seller bank account details
    - `iban` string — IBAN of the seller
    - `description` string — Description of the seller
  - `requested_trade_currency` string, nullable — Requested currency by the customer.
  - `requested_payout_amount` Money, required
    - `value` integer, required — The amount value
    - `unit` string, required — The unit of the given value
    - `currency` string, required — The currency of the given value
  - `reason_for_extension` string, nullable — Reason to postpone the payback.
  - `partner_score` 'A' | 'B', nullable — Score calculated by partner controlling auto-approval behaviour
  - `partner_reviewer` string, required — Person from the partner side who reviewed the trade.
  - `original_invoice_number` string, required — Alphanumeric identifier of the invoice generated by the seller.
  - `original_invoice_amount` Money, required
    - `value` integer, required — The amount value
    - `unit` string, required — The unit of the given value
    - `currency` string, required — The currency of the given value
  - `order_reference` string, nullable — Reference for partner to match trade with created order
  - `invoice_date` string, date, required — The date invoice should be paid.
  - `incoterm` 'EXW' | 'FCA' | 'CPT' | 'CIP' | 'DAT' | 'DAP' | 'DDP' | 'FAS' | 'FOB' | 'CFR' | 'CIF' | 'Other', required
  - `fx_rate` number, nullable — Foreign Exchange (FX) rate
  - `financing_term` integer, required — The number of days until pay back.
  - `business_trade_no` string, required — Serial number generated by the partner to identify the trade.

## Response `200`

The trade was successfully created.

- GetTradeResponse
  - `trade_purpose` string, required — Purpose of the trade.
  - `trade_origin_country` string, required — ISO 3166-1 alpha-2 code of the country of the seller.
  - `trade_company_website` string, required — Website of the seller.
  - `trade_company_registration` string, required — Registration of the seller.
  - `trade_company_name` string, required — Name of the seller.
  - `trade_company_address` string, required — Address of the seller.
  - `status_detail` string, nullable — Additional details about the trade's current status.
  - `status` string, required — The status of the trade.
  - `seller_bank_account_details` object, nullable — Seller bank account details
    - `iban` string — IBAN of the seller
    - `description` string — Description of the seller
  - `requested_trade_currency` string, nullable — Requested currency by the customer.
  - `requested_payout_amount` Money, required
    - `value` integer, required — The amount value
    - `unit` string, required — The unit of the given value
    - `currency` string, required — The currency of the given value
  - `reason_for_extension` string, nullable — Reason to postpone the payback.
  - `partner_score` 'A' | 'B', nullable — Score calculated by partner controlling auto-approval behaviour
  - `partner_reviewer` string, required — Person from the partner side who reviewed the trade.
  - `original_invoice_number` string, required — Alphanumeric identifier of the invoice generated by the seller.
  - `original_invoice_amount` Money, required
    - `value` integer, required — The amount value
    - `unit` string, required — The unit of the given value
    - `currency` string, required — The currency of the given value
  - `order_reference` string, nullable — Reference for partner to match trade with created order
  - `invoice_date` string, date, required — The date invoice should be paid.
  - `incoterm` 'EXW' | 'FCA' | 'CPT' | 'CIP' | 'DAT' | 'DAP' | 'DDP' | 'FAS' | 'FOB' | 'CFR' | 'CIF' | 'Other', required
  - `id` string, nullable, required — ID of the trade
  - `fx_rate` number, nullable — Foreign Exchange (FX) rate
  - `financing_term` integer, required — The number of days until pay back.
  - `documents` Document[], required — Array of documents attached to the trade.
    - `type` 'invoice' | 'other', required
    - `document_id` string, required
  - `business_trade_no` string, required — Serial number generated by the partner to identify the trade.
  - `beneficiary_id` string, nullable — ID of the benificiary of the trade

## Other responses

- `400` — Invalid request.
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/solarisgroup/apis/trade-finance.md) · [All operations](https://skmtc.net/solarisgroup/apis/trade-finance/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/trade-finance/revisions/42ed9890c4d2/schema)