---
title: "Get Order Details"
method: GET
path: "/orders/{id}"
tags: ["Order Management"]
---

# Get Order Details

`GET /orders/{id}`

**Purpose:**

Retrieves full information about an order.

**Preconditions:** 

- `id`: The unique identifier of the order

**Success:** 

- Response Code: `HTTP 200`

## Path parameters

- `id` string, uuid, required

## Response `200`

Order details

- Order
  - `external_code` string, nullable
  - `uuid` string, uuid
  - `state` 'pre_waiting' | 'authorized' | 'waiting' | 'created' | 'declined' | 'shipped' | 'partially_shipped' | 'complete' | 'canceled'
  - `decline_reason` 'risk_policy' | 'risk_scoring_failed' | 'debtor_not_identified' | 'debtor_address' | 'risk_scoring_failed' | 'debtor_limit_exceeded'
  - `amount` TaxedMoney
    - `gross` number, float, required — Value greater than 0, with max. 2 decimals. It should equal to net + tax.
    - `net` number, float, required — Value greater than 0, with max. 2 decimals.
    - `tax` number, float, required — Value greater than or equal to 0, with max. 2 decimals.
  - `unshipped_amount` TaxedMoney
    - `gross` number, float, required — Value greater than 0, with max. 2 decimals. It should equal to net + tax.
    - `net` number, float, required — Value greater than 0, with max. 2 decimals.
    - `tax` number, float, required — Value greater than or equal to 0, with max. 2 decimals.
  - `duration` integer
  - `created_at` string, date-time
  - `delivery_address` Address
    - `house_number` string
    - `street` string, required
    - `postal_code` string, required
    - `city` string, required
    - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
  - `debtor` Debtor
    - `name` string
    - `company_address` Address
      - `house_number` string
      - `street` string, required
      - `postal_code` string, required
      - `city` string, required
      - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
    - `billing_address` Address
      - `house_number` string
      - `street` string, required
      - `postal_code` string, required
      - `city` string, required
      - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
    - `bank_account` BankAccount
      - `iban` string
      - `bic` string
    - `external_data` DebtorExternalData
      - `merchant_customer_id` string
      - `name` string
      - `industry_sector` string, nullable
      - `address` Address
        - `house_number` string
        - `street` string, required
        - `postal_code` string, required
        - `city` string, required
        - `country` string, required — ISO 3166-1 alpha-2 country code (two letters: DE, AT, etc.). See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
  - `invoices` OrderInvoiceResponse[]
    - `uuid` string, uuid
    - `invoice_number` string, nullable
    - `state` string, nullable
    - `payout_amount` number, float, nullable
    - `amount` number, float
    - `amount_net` number, float
    - `amount_tax` number, float
    - `outstanding_amount` number, float, nullable
    - `pending_merchant_payment_amount` number, float, nullable
    - `pending_cancellation_amount` number, float, nullable
    - `fee_amount` number, float, nullable
    - `fee_rate` number, float, nullable
    - `due_date` string, date
    - `created_at` string, date
  - `selected_payment_method` 'bank_transfer' | 'direct_debit', nullable
  - `payment_methods` PaymentMethod[]
    - `type` 'bank_transfer' | 'direct_debit'
    - `data` object — Payment method details
      - `iban` string
      - `bic` string
      - `bank_name` string, nullable — Name of the Bank entity
      - `bank_giro` string, nullable — Bank giro number (Sweden only)
      - `sort_code` string, nullable — Bank sort code (GB only)
      - `account_number` string, nullable — Bank account number (GB, NL and NO)
      - `bank_account_owner` string — Bank account owner entity
      - `mandate_reference` string, nullable — Direct Debit SEPA Mandate Reference (for Direct Debit only)
      - `mandate_execution_date` string, date-time
      - `creditor_identification` string, nullable — Creditor Identification Code (for Direct Debit only)

## Other responses

- `400` — Invalid Request Data
- `401` — Unauthorized request or invalid credentials
- `404` — Resource Not Found
- `500` — Unexpected Server Error

---

[API](https://skmtc.net/billie/apis/billie-direct-api.md) · [All operations](https://skmtc.net/billie/apis/billie-direct-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/billie/billie-direct-api/versions/8cce15617825/schema)