Skip to content

Order by ID

The Order by ID API allows retrieval of a specific order or shipment based on its unique shipment identifier. This is useful for obtaining detailed information about a single order, including its current status, shipment details, lock status, and associated customer and logistics documents.

Request Type: GET
Scheme: HTTPS
Endpoint: https://{{host}}/oms/v3/shipment

Try out Fynd Konnect's Order by ID Endpoint


Common Request Header

HeaderMandatoryDescription
x-access-tokenYesAccess token used for authenticating API requests to Fynd Konnect

Query

orderIdstringrequired

Fetch a particular order by its shipment identifier

Success Resposne

idstring

Unique shipment identifier

forwardIdstring

Forward shipment ID (same as id for forward orders, a unique shipment id is created for returns and cancellations)

marketplaceOrderIdstring

Marketplace-specific order identifier

marketplaceReturnIdstring or null

Marketplace-specific return identifier (null for forward orders)

marketplaceInvoiceNumberstring or null

Marketplace-provided invoice number

shippingAddressobject

Customer's shipping address details

billingAddressobject

Customer's billing primary address

multiPackShipmentboolean

Indicates if the shipment contains multiple packages

packagesArray of objects

Package dimensions and weight information

fulfillmentTypestring

Fulfillment type

sellerInvoicedboolean

Indicates if the seller has generated an invoice

courierNamestring or null

Name of the assigned courier partner

courierCodestring or null

Courier partner code

awbNumberArray of strings

List of Air Waybill numbers for tracking

additionalInfostring

Additional information or notes about the order

orderPriceobject

Order pricing details

orderItemsArray of objects(OrderItem)

List of items in the order

orderStatusstring

Current status of the entire order (e.g., CREATED, CONFIRMED, PROCESSING, DELIVERED)

orderDatestring(date-time)

Timestamp when the order was placed

modifiedDatestring

Last status modified timestamp of the shipment

paymentTypestring

Payment method (e.g., COD, Prepaid)

taxExemptedboolean

Indicates if the shipment is tax-exempted

gstinstring or null

GST Identification Number (IRN) for B2B orders

packAfterDatestring or null

Date after which the order should be packed

packByDatestring or null

Date by which the order must be packed

pickUpSlotsArray of objects

Available pickup time slots

orderingChannelstring

Sales channel name for webstore or marketplace

labelPdfUrlstring or null

URL for the shipping label PDF (A4 size)

labelA6PdfUrlstring or null

URL for the shipping label PDF (A6 size)

purchaseOrderPdfUrlstring or null

URL for the purchase order PDF

invoiceNumberstring or null

Invoice number generated for the shipment either by Fynd or the Seller

returnInvoiceNumberstring or null

Credit note/return invoice number generated for the shipment either by Fynd or the Seller

irnNumberstring or null

Invoice Reference Number (IRN) for e-invoicing

invoiceQrCodestring or null

QR code data for the invoice

signedInvoicestring or null

Digitally signed invoice data

orderBusinessTypestring

Business type (e.g., B2C, B2B)

lockStatusboolean

Indicates if the order is locked for processing

fulfillmentPrioritystring or null

Priority level for order fulfillment

journeyTypestring

Order journey type (e.g., forward, return)

invoiceGenerationDatestring(date-time)

Timestamp when the invoice was generated

shipmentTagsArray of strings

Tags or labels associated with the shipment

slastring

Service Level Agreement - Order processing Turn Around Time (TAT)

cformProvidedboolean

Indicates if C-Form has been provided for inter-state sales

channel_bag_idstring

Channel-specific bag identifier

channel_shipment_idstring

Channel-specific shipment identifier

A4invoicePdfUrlstring or null

URL for the invoice PDF (A4 size)

A6invoicePdfUrlstring or null

URL for the invoice PDF (A6 size)

is_returnlessboolean

Indicates if the order is non-returnable

is_self_shipboolean

Indicates if this is a self-ship order (seller manages logistics)

API Call Example

curl -i -X GET \
  'https://fyndkonnect.konnect.uat.fyndx1.de/oms/v3/shipment?orderId=string&orderingChannel=string&orderStatus=CREATED&pageNumber=0&pageSize=0&locationCode=string&orderDateFrom=2019-08-24&orderDateTo=2019-08-24' \
  -H 'x-access-token: YOUR_API_KEY_HERE'