# Get order details

An order that has the given order id. Read more on Retrieving order details

Endpoint: GET /ordermanagement/v1/orders/{order_id}
Version: 1.0.0

## Path parameters:

  - `order_id` (string, required)
    Order id

## Header parameters:

  - `Klarna-Integrator` (string)

## Response 200 fields (application/json):

  - `billing_address` (object)
    Shipping address for the capture.

  - `billing_address.attention` (string)
    'Attn.' - optional parameter.
    Example: "Anders Exempelsson"

  - `billing_address.city` (string)
    City.
    Example: "Vetlanda"

  - `billing_address.country` (string)
    Country. ISO 3166 alpha-2.
    Example: "se"

  - `billing_address.email` (string)
    E-mail address.
    Example: "john.testsson@kustom.co"

  - `billing_address.family_name` (string)
    Family name.
    Example: "Testsson"

  - `billing_address.given_name` (string)
    Given name.
    Example: "John"

  - `billing_address.organization_name` (string)
    Organization name (if applicable). Only applicable for B2B customers.
    Example: "Kustom"

  - `billing_address.phone` (string)
    Phone number.
    Example: "1-555-555-5555"

  - `billing_address.postal_code` (string)
    Postcode. Validation according to [Universal Postal Union addressing system](https://www.upu.int/en/activities/addressing/postal-addressing-systems-in-member-countries.html).
    Example: 12345

  - `billing_address.region` (string)
    State/Region. Required for US.
    Example: "TN"

  - `billing_address.street_address` (string)
    First line of street address. Validation according to [Universal Postal Union addressing system](https://www.upu.int/en/activities/addressing/postal-addressing-systems-in-member-countries.html)
    Example: "Testgatan 10"

  - `billing_address.street_address2` (string)
    Second line of street address.
    Example: 1

  - `billing_address.title` (string)
    Title.
    Example: "Herr"

  - `captured_amount` (integer)
    The total amount of all captures. In minor units.

  - `captures` (array)
    List of captures for this order.

  - `captures.capture_id` (string)
    The capture id. Generated when the capture is created.
    Example: "4ba29b50-be7b-44f5-a492-113e6a865e22"

  - `captures.captured_amount` (integer)
    The captured amount in minor units.

  - `captures.captured_at` (string)
    The time of the capture. Specified in ISO 8601.
    Example: "2025-11-19T01:51:17Z"

  - `captures.description` (string)
    Description of the capture shown to the customer.
    Example: "Order has been shipped"

  - `captures.klarna_reference` (string)
    Customer friendly reference id, used as a reference when communicating with the customer.
    Example: "K4MADNY-1"

  - `captures.order_lines` (array)
    List of order lines for the capture shown to the customer.

  - `captures.order_lines.image_url` (string)
    URL to an image that can be embedded in communications between Klarna and the customer.
    Example: "https://yourstore.example/product/headphones.png"

  - `captures.order_lines.merchant_data` (string)
    Data about the order line.
    Example: "Some metadata"

  - `captures.order_lines.name` (string, required)
    Descriptive item name.

  - `captures.order_lines.product_identifiers` (object)
    product_identifiers

  - `captures.order_lines.product_identifiers.brand` (string)
    The product's brand name as generally recognized by consumers. If no brand is available for a product, do not supply any value. Maximum 70 characters. Example: Intel
    Example: "Intel"

  - `captures.order_lines.product_identifiers.category_path` (string)
    The product's category path as used in the merchant's webshop. Include the full and most detailed category and separate the segments with ' > '. Maximum 750 characters. Example: Electronics Store > Computers & Tablets > Desktops
    Example: "Electronics Store > Computers & Tablets > Desktops"

  - `captures.order_lines.product_identifiers.color` (string)
    Color to be shown to the end customer (max 64 characters). Example: Denim blue
    Example: "Denim blue"

  - `captures.order_lines.product_identifiers.global_trade_item_number` (string)
    The product's Global Trade Item Number (GTIN). Common types of GTIN are EAN, ISBN or UPC. Exclude dashes and spaces, where possible. Maximum 50 characters. Example: 735858293167
    Example: 735858293167

  - `captures.order_lines.product_identifiers.manufacturer_part_number` (string)
    The product's Manufacturer Part Number (MPN), which - together with the brand - uniquely identifies a product. Only submit MPNs assigned by a manufacturer and use the most specific MPN possible. Maximum 70 characters. Example: BOXNUC5CPYH
    Example: "BOXNUC5CPYH"

  - `captures.order_lines.product_identifiers.size` (string)
    Size to be shown to the end customer (max 64 characters). Example: 4
    Example: 4

  - `captures.order_lines.product_url` (string)
    URL to the product that can be used in communications between Klarna and the customer.
    Example: "https://yourstore.example/product/headphones"

  - `captures.order_lines.quantity` (integer, required)
    Item quantity.
    Example: 1

  - `captures.order_lines.quantity_unit` (string)
    Unit used to describe the quantity.
    Example: "pcs."

  - `captures.order_lines.reference` (string)
    Article number, SKU, or similar identifier on the product variant level.
    Example: 75001

  - `captures.order_lines.tax_rate` (integer)
    The tax rate in percent with two implicit decimals.

  - `captures.order_lines.total_amount` (integer, required)
    Total amount including tax and discounts (quantity * unit_price - total_discount_amount).

  - `captures.order_lines.total_discount_amount` (integer)
    The discount amount in minor units. Includes tax. Example: 1200 = $12. Max value: 200000000

  - `captures.order_lines.total_tax_amount` (integer)
    The total tax amount in minor units.

  - `captures.order_lines.type` (string)
    Order line type.
    Enum: "physical", "discount", "shipping_fee", "sales_tax", "store_credit", "gift_card", "digital", "surcharge", "return_fee", "package"

  - `captures.order_lines.unit_price` (integer, required)
    Unit price including tax without applying discounts in minor units.

  - `captures.reference` (string)
    Internal reference to the capture which will be included in the settlement files. Max length is 255 characters.

  - `captures.refunded_amount` (integer)
    Refunded amount for this capture in minor units.

  - `captures.shipping_address` (object)
    Shipping address for the capture.

  - `captures.shipping_info` (array)
    Shipping information for this capture.

  - `captures.shipping_info.return_shipping_company` (string)
    Name of the shipping company for the return shipment (as specific as possible). Maximum 100 characters. Example: 'DHL SE' and not only 'DHL'
    Example: "DHL SE"

  - `captures.shipping_info.return_tracking_number` (string)
    Tracking number for the return shipment. Maximum 100 characters.
    Example: 93456415674545680000

  - `captures.shipping_info.return_tracking_uri` (string)
    URL where the customer can track the return shipment. Maximum 1024 characters.
    Example: "http://shipping.example/findmypackage?93456415674545679888"

  - `captures.shipping_info.shipping_company` (string)
    Name of the shipping company (as specific as possible). Maximum 100 characters. Example: 'DHL SE' and not only 'DHL'
    Example: "DHL SE"

  - `captures.shipping_info.shipping_method` (string)
    Shipping method. Allowed values matches (PickUpStore|Home|BoxReg|BoxUnreg|PickUpPoint|Own|Postal|DHLPackstation|Digital|Undefined|PickUpWarehouse|ClickCollect|PalletDelivery)
    Example: "Home"

  - `captures.shipping_info.tracking_number` (string)
    Tracking number for the shipment. Maximum 100 characters.
    Example: 63456415674545680000

  - `captures.shipping_info.tracking_uri` (string)
    URI where the customer can track their shipment. Maximum 1024 characters.
    Example: "http://shipping.example/findmypackage?63456415674545679874"

  - `created_at` (string)
    The time for the purchase. Formatted according to ISO 8601.
    Example: "2025-11-29T10:25:40Z"

  - `customer` (object)
    Information about the customer placing the order.

  - `customer.date_of_birth` (string)
    The customer date of birth. ISO 8601.
    Example: "Sun Sep 06 02:00:00 CEST 1981"

  - `customer.national_identification_number` (string)
    The customer national identification number

  - `customer.vat_id` (string)
    The customer vat Id

  - `customer.type` (string)
    The customer type
    Enum: "person", "organization"

  - `customer.organization_entity_type` (string)
    The customer organization entity type
    Enum: "LIMITED_COMPANY", "PUBLIC_LIMITED_COMPANY", "ENTREPRENEURIAL_COMPANY", "LIMITED_PARTNERSHIP_LIMITED_COMPANY", "LIMITED_PARTNERSHIP", "GENERAL_PARTNERSHIP", "REGISTERED_SOLE_TRADER", "SOLE_TRADER", "CIVIL_LAW_PARTNERSHIP", "PUBLIC_INSTITUTION", "OTHER"

  - `customer.organization_registration_id` (string)
    The customer organization registration Id

  - `expires_at` (string)
    Order expiration time. The order can only be captured until this time. Formatted according to ISO 8601.
    Example: "2025-12-04T10:26:06Z"

  - `fraud_status` (string)
    Fraud status for the order. Either ACCEPTED, PENDING or REJECTED.
    Example: "ACCEPTED"

  - `initial_payment_method` (object)
    Initial payment method for this order

  - `initial_payment_method.description` (string)
    The description of the initial payment method.
    Example: "Slice it (Fixed Payments)"

  - `initial_payment_method.number_of_installments` (integer)
    The number of installments (if applicable).
    Example: 3

  - `initial_payment_method.type` (string)
    The type of the initial payment method. One of BANK_TRANSFER, CARD, FIXED_AMOUNT, INVOICE_BUSINESS, INVOICE, MOBILEPAY, PAY_BY_CARD, PAY_LATER_IN_PARTS, SWISH, APPLE_PAY_CARD, GOOGLE_PAY_CARD, CARTES_BANCAIRES, BLIK, TWINT, BANCONTACT, OTHER
    Example: "FIXED_AMOUNT"

  - `klarna_reference` (string)
    A Klarna generated reference that is shorter than the Klarna Order Id and is used as a customer friendly reference. It is most often used as a reference when Klarna is communicating with the customer with regard to payment statuses.
    Example: "K4MADNY"

  - `locale` (string)
    The customers locale. Specified according to RFC 1766.
    Example: "en-us"

  - `merchant_data` (string)
    Text field for storing data about the order. Set at order creation.
    Example: "Order metadata"

  - `merchant_reference1` (string)
    The order number that the merchant should assign to the order. This is how a customer would reference the purchase they made. If supplied, it is labeled as the Order Number within post purchase communications as well as the payment method related apps.
    Example: 10001

  - `merchant_reference2` (string)
    Can be used to store your internal reference to the order. This is generally an internal reference number that merchants use as alternate identifier that matches their internal ERP or Order Management system.
    Example: 501

  - `order_amount` (integer)
    The order amount in minor units. That is the smallest currency unit available such as cent or penny.

  - `order_id` (string)
    The unique order ID. Cannot be longer than 255 characters.
    Example: "f3392f8b-6116-4073-ab96-e330819e2c07"

  - `order_lines` (array)
    An array of order_line objects. Each line represents one item in the cart.

  - `original_order_amount` (integer)
    The original order amount. In minor units.

  - `purchase_country` (string)
    The purchase country. Formatted according to ISO 3166-1 alpha-2.
    Example: "us"

  - `purchase_currency` (string)
    The currency for this order. Specified in ISO 4217 format.
    Example: "usd"

  - `refunded_amount` (integer)
    The total amount of refunded for this order. In minor units.

  - `refunds` (array)
    List of refunds for this order.

  - `refunds.description` (string)
    Description of the refund shown to the customer. Max length is 255 characters.
    Example: "The item was returned and the order refunded."

  - `refunds.order_lines` (array)
    Order lines for the refund shown to the customer. Optional but increases the customer experience. Maximum 1000 order lines.

  - `refunds.reference` (string)
    Internal reference to the refund that is also included in the settlement files. Max length is 255 characters.

  - `refunds.refund_id` (string)
    The refund id. Generated when the refund is created.
    Example: "b2cb4f2e-2781-4359-80ad-555735ebb8d8"

  - `refunds.refunded_amount` (integer)
    Refunded amount in minor units.

  - `refunds.refunded_at` (string)
    The time of the refund. ISO 8601.
    Example: "2025-12-04T15:17:40Z"

  - `remaining_authorized_amount` (integer)
    The remaining authorized amount for this order. To increase the remaining_authorized_amount the order_amount needs to be increased.

  - `selected_shipping_option` (object)
    The shipping option selected by the user.

  - `selected_shipping_option.carrier` (string)
    The carrier for the selected shipping option

  - `selected_shipping_option.carrier_product` (object)
    The chosen timeslot of the selected shipping option

  - `selected_shipping_option.carrier_product.identifier` (string)
    Id of carrier product

  - `selected_shipping_option.carrier_product.name` (string)
    Name of carrier product

  - `selected_shipping_option.class` (string)
    The class of the selected shipping option

  - `selected_shipping_option.id` (string)
    The id of the selected shipping option as provided by the TMS

  - `selected_shipping_option.location` (object)
    The location of the selected shipping option

  - `selected_shipping_option.location.address` (object)
    Address for location

  - `selected_shipping_option.location.id` (string)
    The location id

  - `selected_shipping_option.location.name` (string)
    The display name of the location

  - `selected_shipping_option.location.price` (integer)
    The price for this location

  - `selected_shipping_option.method` (string)
    The method of the selected shipping option

  - `selected_shipping_option.name` (string)
    The display name of the selected shipping option

  - `selected_shipping_option.price` (integer)
    The price of the selected shipping option

  - `selected_shipping_option.selected_addons` (array)
    Array consisting of add-ons selected by the consumer, may be empty

  - `selected_shipping_option.selected_addons.external_id` (string)
    The ID provided by the TMS

  - `selected_shipping_option.selected_addons.price` (integer, required)
    The price of the add-on

  - `selected_shipping_option.selected_addons.type` (string, required)
    The type of the add-on, e.g. sms or entry-code

  - `selected_shipping_option.selected_addons.user_input` (string)
    The text provided by the user

  - `selected_shipping_option.tax_amount` (integer)
    The tax amount of the selected shipping option

  - `selected_shipping_option.tax_rate` (integer)
    The tax rate of the selected shipping option

  - `selected_shipping_option.timeslot` (object)
    The chosen timeslot of the selected shipping option

  - `selected_shipping_option.timeslot.cutoff` (string)
    Cutoff time for delivery

  - `selected_shipping_option.timeslot.end` (string)
    End of the timeslot

  - `selected_shipping_option.timeslot.id` (string)
    The timeslot id

  - `selected_shipping_option.timeslot.price` (integer)
    Price

  - `selected_shipping_option.timeslot.start` (string)
    Start of the timeslot

  - `selected_shipping_option.tms_reference` (string)
    The shipment_id provided by the TMS

  - `selected_shipping_option.type` (string)
    The type of the selected shipping option

  - `shipping_info` (array)
    Shipping information for this order.

  - `status` (string)
    The order status.
    Enum: "AUTHORIZED", "PART_CAPTURED", "CAPTURED", "CANCELLED", "EXPIRED", "CLOSED"

## Response 404 fields (application/json):

  - `correlation_id` (string)
    Correlation id. For searching logs.
    Example: "66782175-ae05-44fc-9eb3-eeceadbad271"

  - `error_code` (string)
    Error code
    Example: "NO_SUCH_ORDER"

  - `error_messages` (array)
    Error messages