GetOrders

Retrieve a paginated list of orders for the authenticated user.

API Playground

Get a paginated list of orders for the currently authenticated user.

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

Query Parameters

page *(integer)Page number to request (1-based index)

Endpoint

GET https://devapi.marketiger3d.com/v2/Order/GetOrders?page={page}&pageSize={pageSize}

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
page	integer	Yes	Page number to retrieve (>= 1)
pageSize	integer	No	Number of orders per page (defaults to 8)

If pageSize is not provided, the page size defaults to 8 orders per page.

Example Request

curl -X GET "https://devapi.marketiger3d.com/v2/Order/GetOrders?page=1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Success Response (200 OK)

When orders are present on the requested page, the response is wrapped in success/data and uses camelCase field names:

{
  "success": true,
  "data": {
    "orders": [
      {
        "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": "example.zip",
            "imageUrl": "https://cdn.example.com/thumb.png",
            "price": 1050,
            "status": 1,
            "bounds": "x:81.66 y:100 z:112.04",
            "quantity": 1
          }
        ]
      }
    ],
    "totalPages": 4,
    "pageSize": 8,
    "currentPage": 1,
    "totalRecords": 25
  }
}

Response Schema

Field	Type	Description
success	boolean	Indicates if the request succeeded
data	object	Container for the response payload
data.orders	array of objects	List of orders on the requested page
data.totalPages	integer	Total number of available pages
data.pageSize	integer	Number of orders per page (fixed 8)
data.currentPage	integer	Current page number
data.totalRecords	integer	Total number of orders for the user
data.orders[].id	string (GUID)	Order ID
data.orders[].status	integer	Order status code
data.orders[].createdDate	string (date-time)	When the order was created
data.orders[].updated	string (date-time)	When the order was last updated
data.orders[].trackAndTrace	object | null	Track-and-trace details (if available)
data.orders[].trackAndTrace.trackingNumber	string | null	Tracking code
data.orders[].trackAndTrace.shippingMethodId	integer	Shipping method ID
data.orders[].trackAndTrace.trackingUrl	string | null	Carrier tracking URL
data.orders[].shippingMethodId	integer	Shipping method ID
data.orders[].projectName	string	Name of the associated project
data.orders[].paymentLink	string	URL to complete the payment (only for certain statuses)
data.orders[].shippingRate	number	Base shipping rate used for this order
data.orders[].orderModels	array of objects	Line items in the order
data.orders[].orderModels[].poId	integer	Production order identifier
data.orders[].orderModels[].modelId	string (GUID)	ID of the ordered model
data.orders[].orderModels[].modelName	string	Display name of the model
data.orders[].orderModels[].imageUrl	string	URL of the model thumbnail (valid ~5 minutes)
data.orders[].orderModels[].price	number	Price per model
data.orders[].orderModels[].status	integer	Status code of the individual line item
data.orders[].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.orders[].orderModels[].quantity	integer	Quantity ordered for this model

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

Empty Page Response

If the requested page is valid but contains no orders, the response omits the success wrapper and returns paging metadata with an empty data array:

{
  "totalRecords": 0,
  "currentPage": 2,
  "pageSize": 8,
  "totalPages": 1,
  "data": []
}

Error Responses

{
  "success": false,
  "error": {
    "type": "AUTHENTICATION",
    "message": "user not found"
  }
}

400 Bad Request (Invalid page parameter)

When page is less than or equal to 0, or pageSize is provided and is less than or equal to 0, the endpoint returns a JSON error:

{
  "success": false,
  "error": {
    "type": "OPERATION_FAILED",
    "message": "Page and pageSize must be greater than 0."
  }
}