maddoxdocs
API reference/List Templates

List Templates

GET /v1/templates — the Templates visible to your tenant: global templates plus your tenant overlays, with tenant overlays shadowing globals of the same id.

cURL
curl "https://api.maddoxapi.dev/v1/templates?scope=all" \
  -H "Authorization: Bearer $MADDOX_API_KEY"

Query Parameters#

QueryValuesDefaultDescription
scopeall · tenant · globalallWhich templates to list.

Response#

Response
{
  "templates": [
    {
      "id": "asset_label",
      "scope": "tenant",
      "name": "Asset Label",
      "width_dots": 812,
      "height_dots": 1218,
      "source_dpi": 203,
      "version": 3,
      "created_at": "2026-06-01T10:00:00.000Z",
      "field_map": { "asset_id": 1, "asset_id_barcode": 2 }
    }
  ]
}

Each entry carries the Template's id, scope, dimensions, current version, and its field_map — enough to render it by name with POST /v1/labels/from-data.

Templates & Field Maps

What a Template is and how scope resolves.

Synthesize a Template

Generate a Template draft from legacy ZPL.