Asgard API
Comprehensive Documentation

POST /api/token/
Content-Type: application/json

{
  "username": "your_username",
  "password": "your_password"
}

{
  "access":  "eyJhbGci...",   // <-- use this one, expires after 5 min
  "refresh": "eyJhbGci..."    // <-- for refreshing, valid for 1 day
}

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

GET  /api/products-index/             // list of all
GET  /api/products-index/ABC-123/      // single product by index
Authorization: Bearer <token>

GET  /api/client-products/AP800001-01/?qty=100
Authorization: Bearer <token>

// Response:
{
  "id":                 142,
  "index":              "AP800001-01",
  "quantity":           4520,
  ... // all fields as in products-index
  "currency":           "PLN",
  "catalogue_price":    "10.00",   // net catalogue price
  "purchase_price":     "7.90",   // your net purchase price
  "price_source":       "individual",
  "no_discount":        true,
  "discount_percent": "10.00"
}

GET  /api/stock-info/
Authorization: Bearer <token>

// Response:
{
  "count":    1250,
  "next":     "/api/stock-info/?page=2",
  "previous": null,
  "results": [
    { "index": "ABC-123", "quantity": 450 },
    { "index": "XYZ-007", "quantity": 0 },
    ...
  ]
}

// Products from category ID=5 with a discount
GET  /api/products-index/?category=5&discount_prices=true

// New arrivals - page 2
GET  /api/products-index/?new_product=true&page=2

// Search by partial index
GET  /api/products-index/?search=ABC

// Categories and subcategories
GET  /api/categories/
GET  /api/subcategories/

{
  "id":              142,
  "index":         "ABC-123",
  "quantity":      450,
  "active":        true,
  "new_product":   false,
  "promotion":     false,
  "sale":          false,
  "discount_prices": true,
  "category":      5,
  "subcategory":   12,

  "names": [
    { "id": 1, "language": "name_pl", "title": "Kubek termiczny 350ml" },
    { "id": 2, "language": "name_en", "title": "Thermal mug 350ml" }
  ],

  "prices": [
    { "pln": "24.90", "eur": "5.80", "chf": "5.50", "czk": "138.00" }
  ],

  "image": [
    { "url": "https://cdn.example.com/products/abc-123-1.jpg" },
    { "url": "https://cdn.example.com/products/abc-123-2.jpg" }
  ],

  "future_delivery": [
    { "quantity": 200, "date": "2026-03-15" }
  ],

  "additional": [
    { "item": "dimensions", "value": "8.5 x 8.5 x 12 cm" },
    { "item": "weight",    "value": "210g" }
  ],

  "marking_data": [ /* see the Marking section */ ],

  // ... names, descriptions, madeof, marking (text)
}

// Step 1 — find the product ID
GET  /api/products-index/ABC-123/
// → the response contains "id": 142 and nested "marking_data"

// Step 2 — or directly via marking-data
GET  /api/marking-data/?product=142

// Response (nested):
{
  "id":                    18,
  "product":              142,
  "default_marking_code": "TS-F1",
  "marking_place": [
    {
      "id":      55,
      "code":   "F1",
      "name_pl": "Przód",
      "marking_option": [
        {
          "id":            201,
          "marking_code":  "TS-F1",
          "option_code":   "TS",          // technique code
          "price_code":    7,           // ID → /api/marking-price/
          "max_colors":    4,
          "realisation_time_id": 3,
          "marking_variant": []
        }
      ]
    }
  ],
  "additional_service": [
    { "service_id": "SETUP", "service_price_pln": "35.00" }
  ]
}

GET  /api/marking-price/?code=P3

// Response:
{
  "id":   7,
  "code": "P3",
  "main_marking_price": [
    { "from_qty": 25,  "to_qty": 49,  "price_pln": "2.80" },
    { "from_qty": 50,  "to_qty": 99,  "price_pln": "2.20" },
    { "from_qty": 100, "to_qty": 249, "price_pln": "1.60" },
    { "from_qty": 250, "to_qty": 499, "price_pln": "1.10" }
  ]
}

GET  /api/my-prices/AP800001-01/?qty=100
Authorization: Bearer <token>

// Response:
{
  "index":               "AP800001-01",
  "currency":            "PLN",
  "qty":                 100,
  "price":               "7.90",   // applicable net unit price
  "source":              "individual",   // base | discount | individual | promo
  "no_discount":         true,   // final price
  "base_price":          "10.00",
  "discount_percent":    "10.00",
  "discounted_price":    "9.00",
  "individual_price":    "7.90",
  "promo_price":         null,
  "individual_tiers": [
    { "from_qty": 1,   "to_qty": 99,   "price": "8.40" },
    { "from_qty": 100, "to_qty": null, "price": "7.90" }
  ],
  "promo_tiers": []
}

GET  /api/promo-prices/                  // all current promotions
GET  /api/promo-prices/ABC-123/          // one promotion by index
GET  /api/promo-prices/?index=ABC-123,XYZ-007
Authorization: Bearer <token>

// Response:
{
  "index":       "ABC-123",
  "active":      true,
  "date_from":   "2026-10-01",
  "date_to":     "2026-12-31",
  "is_current":  true,
  "no_discount": true,          // no discount on this price
  "tiers": [
    { "from_qty": 1,   "to_qty": 99,   "qty_label": "1–99",    "pln": "10.00", "eur": "2.40", "chf": null, "czk": null },
    { "from_qty": 100, "to_qty": null, "qty_label": "100+",    "pln": "8.50",  "eur": "2.05", "chf": null, "czk": null }
  ],
  "updated_at":  "2026-10-01T10:15:00+02:00"
}

GET  /api/promo-prices/ABC-123/price/?qty=150&currency=PLN

// Response:
{
  "index":       "ABC-123",
  "qty":         150,
  "currency":    "PLN",
  "unit_price":  "8.50",
  "total":       "1275.00",
  "tier":        "100+",
  "no_discount": true
}

{
  "username":       "company_abc",
  "email":          "office@company.com",
  "can_order":        true,           // false = POST /api/orders/ will return 403
  "discount_percent": 10.00,          // % discount on products with discount_prices=true
  "currency":         "PLN",          // currency used in orders
  "payment_method":   "banktransfer", // payment method used in orders
  "language":         "pl"
}

POST /api/orders/
Authorization: Bearer <access_token>
Content-Type:  application/json

{
  // Your own order number (optional)
  "client_reference": "MOJ-NR-2024/001",

  "notes": "Please issue a VAT invoice",  // optional

  // List of products — at least one item
  "items": [
    { "product_index": "ABC-123", "quantity": 50 },
    { "product_index": "XYZ-007", "quantity": 10 }
  ]
}

// Currency and payment method come from the user's profile — no need to provide them.

POST /api/orders/
Authorization: Bearer <token>
Content-Type:  application/json

{
  // ... orderer and address fields ...

  "items": [
    {
      "product_index":      "20820-14",
      "quantity":           100,
      "marking_place_code": "M02",        // Back
      "marking_option_code":"C1",         // DTF 60x50mm
      "marking_info":       "Company logo, design attached"
    },
    {
      "product_index":      "20820-14",
      "quantity":           50,
      "marking_place_code": "M02",
      "marking_option_code":"S1",         // Screen printing 300x250mm
      "marking_colors":     2,            // max_colors=3
      "marking_info":       "2-color PMS logo"
    }
  ]
}

# Step 1 — place the order, note the order id and item id
# In the response items[0].id = 99 (item id)

# Step 2 — send the design file
curl -X POST https://developers.bluecollection.eu/api/orders/42/items/99/design \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@/path/to/logo.pdf"

// Response 201:
{
  "id":          7,
  "file":        "/media/order_item_designs/42/logo.pdf",
  "uploaded_at": "2026-06-25T11:30:00.000Z"
}

POST /api/orders/42/attachments/
Authorization: Bearer <token>
Content-Type:  multipart/form-data

// Form field: file

// cURL:
curl -X POST https://developers.bluecollection.eu/api/orders/42/attachments/ \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@/path/to/template.pdf"

// Response 201:
{
  "id":          1,
  "file":        "/media/order_attachments/2026/06/wzor.pdf",
  "uploaded_at": "2026-06-25T11:00:00.000Z"
}

GET  /api/orders/?status=new
Authorization: Bearer <token>