GetOrder

Retrieve a single order (including models and pricing information) by its orderId.

API Playground

Get a single order by its orderId, including line items, prices, shipping rate, and basic project information.

Token *Your authentication token will be sent as: Authorization: Bearer <token>

Query Parameters

orderId *(string)The GUID of the order you want to retrieve

Endpoint

GET https://devapi.marketiger3d.com/v2/Order/GetOrder?orderId={orderId}

Authentication

This endpoint requires a Bearer token. Include the token in the Authorization header:

Authorization: Bearer <your_access_token>

Query Parameters

Name	Type	Required	Description
orderId	string (GUID)	Yes	Unique identifier of the order to retrieve

Example Request

curl -X GET "https://devapi.marketiger3d.com/v2/Order/GetOrder?orderId=123e4567-e89b-12d3-a456-426614174000" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Success Response (200 OK)

Successful responses are wrapped in success/data, and order fields are camelCased by the API serializer:

{
  "success": true,
  "data": {
    "order": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "status": 1,
      "createdDate": "2024-01-01T10:00:00Z",
      "updated": "2024-01-01T10:15:00Z",
      "trackAndTrace": {
        "trackingNumber": "9876543210",
        "shippingMethodId": 3,
        "trackingUrl": "https://tracking.example.com/forward?carrier=dhl_express&code=9876543210&destination=US&lang=en-us&source=NL&type=parcel&verification=12345&servicepoint_verification=&shipping_product_code=dhl_express%3Aworldwide&created_at=2026-02-04&tracking_identifier=JD000000000000000000"
      },
      "shippingMethodId": 3,
      "projectName": "Example Project",
      "paymentLink": "https://payment.example.com/link",
      "shippingRate": 500,
      "orderModels": [
        {
          "poId": 123,
          "modelId": "223e4567-e89b-12d3-a456-426614174000",
          "modelName": "model.zip",
          "imageUrl": "https://cdn.example.com/thumb.png",
          "price": 1050,
          "status": 1,
          "bounds": "x:81.66 y:100 z:112.04",
          "quantity": 1
        }
      ]
    }
  }
}

Response Schema

Field	Type	Description
success	boolean	Indicates if the request succeeded
data	object	Container for the response payload
data.order	object	Order object
data.order.id	string (GUID)	Unique identifier of the order
data.order.status	integer	Order status code
data.order.createdDate	string (date-time)	Date and time when the order was created
data.order.updated	string (date-time)	Date and time when the order was last updated
data.order.trackAndTrace	object | null	Track-and-trace details (if available)
data.order.trackAndTrace.trackingNumber	string | null	Tracking code
data.order.trackAndTrace.shippingMethodId	integer	Shipping method ID
data.order.trackAndTrace.trackingUrl	string | null	Carrier tracking URL
data.order.shippingMethodId	integer	Shipping method ID
data.order.projectName	string	Name of the project the order belongs to
data.order.paymentLink	string	URL to complete payment for this order
data.order.shippingRate	number	Base shipping rate used for this order
data.order.orderModels	array of objects	Line items included in the order
data.order.orderModels[].poId	integer	Production order identifier
data.order.orderModels[].modelId	string (GUID)	ID of the ordered model
data.order.orderModels[].modelName	string	Display name of the model
data.order.orderModels[].imageUrl	string	URL of the model thumbnail (valid ~5 minutes)
data.order.orderModels[].price	number	Price per model
data.order.orderModels[].status	integer	Status code of the individual line item
data.order.orderModels[].bounds	string	Bounding box information (e.g. x:81.66 y:100 z:112.04; 2D cases may appear as x:0 y:0)
data.order.orderModels[].quantity	integer	Quantity ordered for this model

Note: Field names are camelCase in the API response due to JSON serialization settings.

Image availability: Thumbnail URLs (imageUrl) and any additional image URLs expire after ~5 minutes.

TrackAndTrace format: trackAndTrace is now an object. When tracking data is not available, this field is null.

Error Responses

400 Bad Request (No permission)

{
  "success": false,
  "error": {
    "type": "NO_PERMISSION",
    "message": "You are not allowed to view this order."
  }
}

Note: This error occurs when the authenticated user is not the owner of the order. Only order owners can view their orders.

400 Bad Request (No email claim)

{
  "success": false,
  "error": {
    "type": "NO_PERMISSION",
    "message": "No email claim present."
  }
}

400 Bad Request (Order not found)

{
  "success": false,
  "error": {
    "type": "NOT_FOUND",
    "message": "Order id not found"
  }
}

400 Bad Request (User not found)

{
  "success": false,
  "error": {
    "type": "NOT_FOUND",
    "message": "User not found."
  }
}