Get status

POST /v1/get_status

Returns the current status of an order, including its tracking number once shipped.

Request

Send username, password and secretkey along with a data object. See Making requests.

Request bodycURL

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "secretkey": "YOUR_SECRET_KEY",
  "data": {
    "xid": "23542123",
    "order_id": "1001"
  }
}

curl -X POST https://gatewaybeta.marcofinearts.com/v1/get_status \
  -H "Content-Type: application/json" \
  -d '{
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD",
    "secretkey": "YOUR_SECRET_KEY",
    "data": {
      "xid": "23542123",
      "order_id": "1001"
    }
  }'

data fields

Field	Required	Validation	Notes
xid	Conditional		Your order number. Required if order_id is not passed.
order_id	Conditional		Marco Fine Arts order ID. Required if xid is not passed.

Response

SuccessError

{
  "res": "success",
  "order_id": "123456",
  "order_status": "Shipped",
  "update_date": "2026-08-28 11:50:00",
  "trackingno": "34523452345234"
}

{
  "res": "error",
  "code": "000",
  "message": "Error message."
}

Error codes

Code	Error	Description
901	Authentication failed	Your account is invalid or does not have API access. Check username, password and secretkey.
902	Missing field	One or more required fields are missing.
914	Missing field	order_id or xid is required.
915	Invalid data	Invalid order_id or xid.