$postData = [
  'preordercode' => '1|acrylic|da9',
  'bordercolorhex' => 'ffffff',
  'thanknotemsg' => 'Nullam sagittis molestie augue at dictum.',
];
        

$postData = [
  'preordercode' => '2|canvas|stretched|horizontal|30|24|303-12|semigloss|mirrorimage|c15|moulding|opt',
];
        

{
  "status": true,
  "msg": [],
  "worksheet": {
    "enabledDiscount": true,
    "price": {
      "list": {
        "main": 20.0604444444444,
        "cert": 5
      },
      "discount": {
        "main": 6.01813333333332,
        "cert": 1.5
      },
      "artistCommission": {
        "main": 25.0604444444444
      },
      "artistCommissionDiscount": {
        "main": 7.51813333333332
      },
      "subTotal": 35.08462222222215,
      "taxes": {
        "taxPercentage": 0.14975,
        "taxGST": 1.7542311111111077,
        "taxPST": 3.4996910666666596
      },
      "total": 40.33854439999992
    }
  }
}
        

$postData = [
  'preordercode' => '2|canvas|stretched|horizontal|30|24|303-12|semigloss|mirrorimage|c15|moulding|opt',
];
        

{
  "status": true,
  "msg": [],
  "data": {
    "productionLeadTime": 8
  }
}
        

$postData = [
  'delivery[firstname]' => 'Kathleen',
  'delivery[lastname]' => 'Bernal',
  'order[0][file]' => new CURLFile('/path/to/file.jpg') // Path to the file
];
        

{
  "status": true,
  "msg": [],
  "orderid": xxxxxx
}
        

{
  "status": false,
  "msg": {
    "error": [
      "PreOrder Code: 2|canvas|stretched|horizontal|30|24|303-12|semigloss|mirrorimage|c15|mouldin3g|opt is NOT valid."
    ]
  },
  "orderid": null
}
        

Provide either orderid or po. Results are always scoped to your API account.

// Search by Pictorem order ID
$postData = [
  'orderid' => '472174',
];

// — OR — search by your own PO number
$postData = [
  'po' => 'MY-PO-2026-001',
];

Success

{
  "status": true,
  "msg": [],
  "order": {
    "orderid": 472174,
    "po": "MY-PO-2026-001",
    "date": "2026-03-15 10:22:00",
    "order_status": "3",
    "order_status_label": "Shipped",
    "billing_status": "1",
    "billing_status_label": "Paid",
    "tracking_number": "1Z999AA10123456784",
    "tracking_carrier": "UPS",
    "total": 125.40,
    "currency": "USD",
    "delivery": {
      "firstname": "Kathleen",
      "lastname": "Bernal",
      "company": null,
      "address1": "3371 Sycamore Lake Road",
      "address2": null,
      "city": "Oshkosh",
      "province": "WI",
      "country": "USA",
      "postal": "54901"
    },
    "lines": [
      {
        "line_id": 889421,
        "status": "3",
        "status_label": "Shipped",
        "product": "canvas",
        "type": "stretched",
        "orientation": "horizontal",
        "width": "30",
        "height": "24",
        "qty": 1,
        "total": 125.40,
        "tracking": "1Z999AA10123456784"
      }
    ]
  }
}

Order Status Codes

Fail

{
  "status": false,
  "msg": {
    "error": ["Order not found."]
  }
}

$postData = [
  'preordercode' => '1|acrylic|da9',
];
        

{
  "status": true,
  "data": {
    "preordercode": "1|acrylic|da9",
    "preordersanitize": "1|acrylic|da8",
    "products": {
      ...
    }
  }
}
        

$ch = curl_init('https://www.pictorem.com/artflow/0.1/getartworklist/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['ArtFlowKey: YOUR_API_KEY']);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
  'userid' => 'ABC123',
  'page'   => '1',
  'limit'  => '48',
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
        

const body = new FormData();
body.append('userid', 'ABC123');
body.append('page',   '1');
body.append('limit',  '48');

fetch('https://www.pictorem.com/artflow/0.1/getartworklist/', {
  method:  'POST',
  headers: { 'ArtFlowKey': 'YOUR_API_KEY' },
  body:    body,
})
  .then(r => r.json())
  .then(data => console.log(data));
        

{
  "status": true,
  "data": {
    "total": 147,
    "page": 1,
    "limit": 48,
    "pages": 4,
    "artworks": [
      {
        "id": 2452666,
        "name": "Mona Lisa",
        "author": "Stock Photography",
        "keywords": "classical, portrait, renaissance",
        "description": "...",
        "categories": { "main": "12" },
        "url": "https://www.pictorem.com/2452666/Mona-Lisa.html",
        "s3migration": 1,
        "stats": { "rating": 4.5, "nbRating": 12, "views": 340 },
        "createdAt": "2024-01-15 10:22:00",
        "previews": {
          "artwork":          { "full": "https://s3.pictorem.com/...", "small": "...", "big": "..." },
          "gallerySmall":     "https://s3.pictorem.com/.../gallerysmall_2452666.jpg",
          "wallRoomPreview":  { "jpg": "...", "hires": "...", "small": "..." },
          "acrylicPrint":     { "view1": "...", "view1small": "...", "view4": "...", "view4small": "..." },
          "metalPrint":       { "view1": "...", "view2": "..." },
          "hdMetalPrint":     { "view1": "...", "view2": "...", "view3": "..." },
          "woodPrint":        { "view1": "...", "view2": "..." },
          "wallMurals":       { "view1": "...", "view2": "...", "view3": "..." },
          "framedPrint":      "https://s3.pictorem.com/.../pf_2452666.jpg",
          "canvasPrint":      { "view1": "...", "view2": "...", "view3": "..." },
          "splitPanels":      { "split3": "...", "split3cross": "...", "split5cross": "..." },
          "puzzle":           { "view1": "...", "view1small": "...", "view2": "..." },
          "decoFrame":        { "view1": "...", "preview": "..." }
        }
      }
    ]
  }
}
        

{
  "status": false,
  "error": "userid is required"
}
        

{
  "status": false,
  "error": "Access Denied"
}