# Retrieve a trade

Returns the Trade Finance application specified in the request URL. Use this endpoint to display the status of the application to the customer.

Endpoint: GET /v1/businesses/{business_id}/trade_credit_line/trades/{id}
Version: 1.0

## Path parameters:

  - `business_id` (string, required)
    ID of the business who requested the trade.

  - `id` (string, required)
    ID of the trade.

## Response 200 fields (application/json):

  - `id` (string,null, required)
    ID of the trade
    Example: "722e12c6f2254972a1b70de6b07f6dacbtra"

  - `status` (string, required)
    The status of the trade.
    Example: "approved"

  - `documents` (array, required)
    Array of documents attached to the trade.
    Example: [{"type":"invoice","document_id":"string","created_at":"2018-10-18T15:57:01.000000Z"}]

  - `documents.document_id` (string, required)
    Example: "string"

  - `documents.type` (string, required)
    Enum: "invoice", "other"

  - `business_trade_no` (string, required)
    Serial number generated by the partner to identify the trade.
    Example: "f8978c7d14f7495f802a6cfd5c04fba7"

  - `financing_term` (integer, required)
    The number of days until pay back.
    Example: 30

  - `incoterm` (string, required)
    Enum: "EXW", "FCA", "CPT", "CIP", "DAT", "DAP", "DDP", "FAS", "FOB", "CFR", "CIF", "Other"

  - `invoice_date` (string, required)
    The date invoice should be paid.
    Example: "2019-08-24"

  - `original_invoice_amount` (object, required)
    The original invoice amount
    Example: {"value":1000,"unit":"cents","currency":"EUR"}

  - `original_invoice_amount.value` (integer, required)
    The amount value
    Example: 1000

  - `original_invoice_amount.currency` (string, required)
    The currency of the given value
    Example: "EUR"

  - `original_invoice_amount.unit` (string, required)
    The unit of the given value
    Example: "cents"

  - `original_invoice_number` (string, required)
    Alphanumeric identifier of the invoice generated by the seller.
    Example: "ABC123"

  - `partner_reviewer` (string, required)
    Person from the partner side who reviewed the trade.
    Example: "Partner Reviewer"

  - `requested_payout_amount` (object, required)
    The requested payout amount
    Example: {"value":1000,"unit":"cents","currency":"EUR"}

  - `trade_company_address` (string, required)
    Address of the seller.
    Example: "Fake street 1A, 10178 Berlin"

  - `trade_company_name` (string, required)
    Name of the seller.
    Example: "Acme"

  - `trade_company_registration` (string, required)
    Registration of the seller.
    Example: "ACME-123"

  - `trade_company_website` (string, required)
    Website of the seller.
    Example: "example.com"

  - `trade_origin_country` (string, required)
    ISO 3166-1 alpha-2 code of the country of the seller.
    Example: "DE"

  - `trade_purpose` (string, required)
    Purpose of the trade.
    Example: "Buy machinery"

  - `status_detail` (string,null)
    Additional details about the trade's current status.

  - `seller_bank_account_details` (object,null)
    Seller bank account details

  - `seller_bank_account_details.iban` (string)
    IBAN of the seller
    Example: "DE82110101004206642492"

  - `seller_bank_account_details.description` (string)
    Description of the seller
    Example: "seller description"

  - `requested_trade_currency` (string,null)
    Requested currency by the customer.
    Example: "USD"

  - `reason_for_extension` (string,null)
    Reason to postpone the payback.
    Example: "A reason"

  - `partner_score` (string,null)
    Score calculated by partner controlling auto-approval behaviour
    Enum: "A", "B"

  - `order_reference` (string,null)
    Reference for partner to match trade with created order
    Example: "32b4ad38e6984b65808c83c6633a5758"

  - `fx_rate` (number,null)
    Foreign Exchange (FX) rate
    Example: 10.32

  - `beneficiary_id` (string,null)
    ID of the benificiary of the trade
    Example: "ABCDEF"

## Response 403 fields (application/json):

  - `errors` (array, required)

  - `errors.id` (string, required)
    A UUID, preferably the request ID

  - `errors.status` (integer, required)
    The HTTP status

  - `errors.code` (string, required)
    some_computer_friendly_string

  - `errors.title` (string, required)
    Some short human friendly string

  - `errors.detail` (string, required)
    Some human friendly-ish detail: field is required

  - `errors.source` (object,null)
    Optional computer-friendly error source description
    Example: {"message":"is_required","field":"name"}

  - `errors.source.field` (string, required)
    Example: "name"

  - `errors.source.message` (string, required)
    Example: "is_required"

  - `errors.backtrace` (array,null)
    Optional array of backtrace lines

## Response 404 fields (application/json):

  - `errors` (array, required)

  - `errors.id` (string, required)
    A UUID, preferably the request ID

  - `errors.status` (integer, required)
    The HTTP status

  - `errors.code` (string, required)
    some_computer_friendly_string

  - `errors.title` (string, required)
    Some short human friendly string

  - `errors.detail` (string, required)
    Some human friendly-ish detail: field is required

  - `errors.source` (object,null)
    Optional computer-friendly error source description
    Example: {"message":"is_required","field":"name"}

  - `errors.source.field` (string, required)
    Example: "name"

  - `errors.source.message` (string, required)
    Example: "is_required"

  - `errors.backtrace` (array,null)
    Optional array of backtrace lines