T3 API
The best way to talk to Metrc

The T3 API is the developer-friendly way to work with Metrc—one modern REST interface for every Metrc state, with 490+ documented endpoints covering inventory, cultivation, manufacturing, transfers, lab testing, and labels.

GETRequest

URL

api.trackandtrace.tools/v2/packages/active/super

Query parameters

?licenseNumber=LIC-000123

&include=labResults

200 OKResponse

{
  "data": [
    {
      "label": "1A4000000000000000000001",
      "item": {
        "name": "Pineapple Express Flower"
      },
      "quantity": 1130.7,
      "unitOfMeasureAbbreviation": "g",
      "metadata": {
        "indexedLabResults": {
          "totalTHC": {
            "full": "Total THC: 22.4 %",
            "name": "Total THC",
            "value": 22.4,
            "unit": "%"
          },
          "totalCBD": {
            "full": "Total CBD: 0.1 %",
            "name": "Total CBD",
            "value": 0.1,
            "unit": "%"
          },
          "topTerpene1": {
            "full": "Myrcene: 1.2 %",
            "name": "Myrcene",
            "value": 1.2,
            "unit": "%"
          }
        }
      }
    }
  ]
}

GETRequest

URL

api.trackandtrace.tools/v2/packages/active/super/report

Query parameters

?licenseNumber=LIC-000123

&licenseNumber=LIC-000456

&columns=licenseNumber,label,locationName,item.name,item.strainName,quantity,unitOfMeasureAbbreviation

&filter=labTestingStateName__eq:TestPassed

&filter=quantity__gt:0

&filterLogic=and

&sort=quantity:desc

&rowLimit=1000

200 OKResponse

{
  "generatedAt": "2026-10-02T14:03:00+00:00",
  "licenseNumber": [
    "LIC-000123",
    "LIC-000456"
  ],
  "filters": [
    "labTestingStateName__eq:TestPassed",
    "quantity__gt:0"
  ],
  "filterLogic": "and",
  "sort": "quantity:desc",
  "data": [
    {
      "licenseNumber": "LIC-000123",
      "label": "1A4000000000000000000001",
      "locationName": "Vault A",
      "item": {
        "name": "Pineapple Express Flower",
        "strainName": "Pineapple Express"
      },
      "quantity": 1130.7,
      "unitOfMeasureAbbreviation": "g"
    },
    {
      "licenseNumber": "LIC-000123",
      "label": "1A4000000000000000000002",
      "locationName": "Vault A",
      "item": {
        "name": "Blue Dream Shake",
        "strainName": "Blue Dream"
      },
      "quantity": 862.4,
      "unitOfMeasureAbbreviation": "g"
    },
    {
      "licenseNumber": "LIC-000456",
      "label": "1A4000000000000000000101",
      "locationName": "Back Stock",
      "item": {
        "name": "Wedding Cake Pre-Roll",
        "strainName": "Wedding Cake"
      },
      "quantity": 420,
      "unitOfMeasureAbbreviation": "g"
    }
  ]
}

POSTRequest

URL

api.trackandtrace.tools/v2/labels/generate

Body

{
  "labelTemplateLayoutConfig": {
    "publicId": "tmpl_a1b2c3"
  },
  "labelContentDataList": [
    {
      "package": {
        "label": "1A4000000000000000000001"
      }
    },
    {
      "package": {
        "label": "1A4000000000000000000002"
      }
    },
    {
      "package": {
        "label": "1A4000000000000000000003"
      }
    }
  ]
}

200 OKResponse

labels.pdf4 labels

1A4000000000000000000001

Pineapple Express Flower

5 g · Test Passed

1A4000000000000000000002

Blue Dream Shake

3.5 g · Test Passed

1A4000000000000000000003

Wedding Cake Pre-Roll

1 g · Test Passed

1A4000000000000000000004

Sour Diesel Flower

5 g · Test Passed

Phase 1 · Create tag list

POSTRequest

URL

api.trackandtrace.tools/v2/tag-lists

Body

{
  "licenseNumber": "LIC-000123",
  "name": "Room A inventory",
  "entries": [
    {
      "handle": "1A4000000000000000000001"
    },
    {
      "handle": "1A4000000000000000000002"
    },
    {
      "handle": "1A4000000000000000000003"
    }
  ]
}

201 CreatedResponse

{
  "data": {
    "id": 42
  }
}

Phase 2 · Resolve to packages

GETRequest

URL

api.trackandtrace.tools/v2/tag-lists/42/resolve

Query parameters

?licenseNumber=LIC-000123

&endpoint=/v2/packages/active

200 OKResponse

{
  "data": [
    {
      "label": "1A4000000000000000000001",
      "item": {
        "name": "Pineapple Express Flower"
      },
      "quantity": 1130.7,
      "unitOfMeasureAbbreviation": "g"
    },
    {
      "label": "1A4000000000000000000002",
      "item": {
        "name": "Blue Dream Shake"
      },
      "quantity": 862.4,
      "unitOfMeasureAbbreviation": "g"
    },
    {
      "label": "1A4000000000000000000003",
      "item": {
        "name": "Wedding Cake Pre-Roll"
      },
      "quantity": 420,
      "unitOfMeasureAbbreviation": "g"
    }
  ]
}

POSTRequest

URL

api.trackandtrace.tools/v2/transfers/create

Query parameters

?licenseNumber=LIC-000123

Body

[
  {
    "destinations": [
      {
        "recipientId": 123456,
        "transferTypeId": 8,
        "plannedRoute": "I-5 North to Portland",
        "estimatedDepartureDateTime": "2026-10-03T09:00:00",
        "estimatedArrivalDateTime": "2026-10-03T14:30:00",
        "packages": [
          {
            "label": "1A4000000000000000000001"
          },
          {
            "label": "1A4000000000000000000002"
          },
          {
            "label": "1A4000000000000000000003"
          }
        ]
      }
    ]
  }
]

200 OKResponse

Transfer Manifest#0000123456

From: LIC-000123
To: LIC-000456
Type: Transfer
Route: I-5 North to Portland
Depart: 2026-10-03 09:00
Arrive: 2026-10-03 14:30

Packages (3)

…00001Pineapple Express Flower1,130.7 g

…00002Blue Dream Shake862.4 g

…00003Wedding Cake Pre-Roll420.0 g

Lab result keys are normalized across every state: "Total THC" and "Total Delta-9 THC" both come back as totalTHC.

Read the API Docs Get API Access

490+

Documented endpoints

8,000+

Licenses using T3

States with businesses using T3

Report formats: JSON, CSV, Excel, Google Sheets

Case study

How Nuthera Calculates the True Cost of Every Metrc Tag with the T3 API

When a data-entry role went unfilled, Nuthera automated its Metrc reconciliation with the T3 API and Google Sheets. Then it went further, tracing the true cost of every Metrc tag it has ever created, down to the batch.

Read the Nuthera case study →

“With T3, I completed something no other ERP company in cannabis has shown me: the true input and output cost of every Metrc tag we have ever made.”

Taylor McKnight

Director of Information Technology, Nuthera

The raw Metrc API vs. the T3 API

Building directly on the Metrc API means handling per-state differences, credentials, and data stitching yourself. The T3 API gives you programmatic access to the same Metrc data without any of that.

Raw Metrc API

T3 API

Endpoints

Metrc: A separate API host for each state

T3: One base URL for every Metrc state

Authentication

Metrc: A vendor API key plus a user API key on every request

T3: One T3 secret key or bearer token

Bulk data

Metrc: Date-filtered queries limited to short time windows, paged by hand

T3: Entire datasets in a single report request

Related data

Metrc: Separate calls per resource, joined in your own code

T3: Super Reports join related records with include=

Lab results

Metrc: Test names vary by lab and by state

T3: Normalized keys like totalTHC in every state

Output formats

Metrc: JSON

T3: JSON, CSV, Excel, or straight to Google Sheets

Labels

Metrc: No label generation

T3: Print-ready compliance label PDFs

Documentation

Metrc: Separate documentation for each state

T3: One interactive OpenAPI reference

The T3 API is independent of the Metrc API: it does not use Metrc API keys and is not affiliated with Metrc.

Make your first call in minutes

The T3 API is plain REST and JSON, so it works from any language. Python developers can also use the t3api and t3api-utils libraries.

1
Create an account
Sign up on the T3 dashboard at dash.trackandtrace.tools.
2
Generate a secret key
Create a T3 secret key and store it as T3_API_KEY.
3
Make a request
Call any endpoint. Responses are paginated JSON with page, pageSize, total, and data.

curl "https://api.trackandtrace.tools/v2/packages/active?licenseNumber=LIC-000123" \
  -H "X-T3-API-Key: $T3_API_KEY"

Why build on the T3 API

Metrc's own API is difficult to work with: inconsistent across states, thin on documentation, and tedious to page through. The T3 API is an independent alternative that makes working with your Metrc data fast and predictable.

One API, every Metrc state

Metrc behaves differently in every state it operates in. The T3 API normalizes those differences behind a single, consistent REST interface, so the integration you build works the same whether a license lives in California, Michigan, or anywhere else Metrc runs.

Documentation built for developers

Interactive OpenAPI documentation with real request and response examples for every endpoint, predictable JSON shapes, consistent pagination, and standard bearer or secret-key authentication. Developers can go from reading a page to a working call in minutes.

Complete Metrc coverage

Hundreds of endpoints spanning the entire Metrc data model—not just the handful most tools expose. Read inventory, write transfers, generate labels, pull lab results, and automate workflows that previously required manual data entry in the Metrc UI.

Bulk export and Super Reports

Pull entire Metrc datasets in a single request instead of paging through hundreds of calls. Super Reports join related records—packages with items, harvests with their packages—into clean, flat tables ready for analysis, and Spreadsheet Sync keeps Google Sheets and Excel up to date automatically.

Full coverage of the Metrc data model

If Metrc tracks it, the T3 API can reach it. Endpoints span every major area of the platform:

Cultivation

Plants, plant batches, and harvests across every growth phase.

Manufacturing

Processing jobs, package creation, and testing workflows.

Transfers

Incoming, outgoing, rejected, and hub transfers with manifests.

Lab Testing

Lab results, testing states, and result documents.

Inventory

Active, inactive, in-transit, and on-hold packages.

Items & Strains

Full product catalog and strain database.

Labels

Generate print-ready label PDFs on demand.

Built to solve business problems

The T3 API turns Metrc from a compliance chore into programmable infrastructure. A few of the things teams build with it:

Automate compliance reporting

Pull the exact datasets auditors ask for on a schedule, instead of exporting spreadsheets by hand.

Sync inventory with other systems

Keep ERP, POS, and internal databases in step with Metrc inventory in near real time.

Power dashboards and BI

Feed live Metrc data into reporting tools to track yield, sales, and movement across licenses.

Build custom integrations

Create transfers, generate labels, and write back to Metrc from the tools teams already use.

API access comes with T3+

A limited set of endpoints is free for anyone with a Metrc login. Full API access, Super Reports, and Spreadsheet Sync are included with a T3+ subscription. Explore the tiers to find the right fit.

View T3+ Plans

Metrc API FAQ

Common questions about working with the Metrc API.

What is the Metrc API?

The Metrc API is the programmatic interface for reading and writing cannabis track-and-trace data in Metrc. The T3 API is a separate, developer-friendly alternative: it gives you programmatic access to the Metrc data available to you on metrc.com, with consistent JSON responses and interactive documentation across every Metrc state. It does not use Metrc API keys and is not affiliated with Metrc.

Does Metrc have a REST API?

Metrc offers its own API for third-party software integrators. The T3 API is an independent REST API that reaches the same Metrc data without Metrc API keys, so one integration works the same regardless of which state a license operates in.

How do I connect to Metrc programmatically?

Generate a T3 secret key and send it in the X-T3-API-Key header, or exchange your credentials for a short-lived bearer token. From there you can pull inventory, create transfers, generate labels, and read lab results with a single REST call. Full examples are in the interactive API documentation.

Does the T3 API work in every Metrc state?

Yes. The T3 API covers every state where Metrc operates and normalizes per-state differences behind one consistent interface, so your code does not change from state to state.

What can I build with the Metrc API?

Teams use the T3 API to automate compliance reporting, sync Metrc inventory with ERP and POS systems, power BI dashboards, generate compliance labels, and build custom integrations that read from and write back to Metrc.

Is the T3 API free?

A limited set of T3 API endpoints is free for anyone with a Metrc login. Full access to the T3 API, Super Reports, and Spreadsheet Sync is included with a T3+ subscription.

Get Started

Browse the interactive API documentation to see every endpoint with live examples.
Work through the Metrc API guides: getting API credentials, calling the API from Python, exporting Metrc data, and reading lab results.
Read the T3 API wiki for authentication, Super Reports, and Spreadsheet Sync.
Sign up to generate a secret key and make your first call.

T3 APIThe best way to talk to Metrc

The T3 API is the developer-friendly way to work with Metrc—one modern REST interface for every Metrc state, with 490+ documented endpoints covering inventory, cultivation, manufacturing, transfers, lab testing, and labels.

How Nuthera Calculates the True Cost of Every Metrc Tag with the T3 API

The raw Metrc API vs. the T3 API

Make your first call in minutes

Create an account

Generate a secret key

Make a request

Why build on the T3 API

One API, every Metrc state

Documentation built for developers

Complete Metrc coverage

Bulk export and Super Reports

Full coverage of the Metrc data model

Cultivation

Manufacturing

Transfers

Lab Testing

Inventory

Items & Strains

Tags

Labels

Built to solve business problems

Automate compliance reporting

Sync inventory with other systems

Power dashboards and BI

Build custom integrations

API access comes with T3+

Metrc API FAQ

What is the Metrc API?

Does Metrc have a REST API?

How do I connect to Metrc programmatically?

Does the T3 API work in every Metrc state?

What can I build with the Metrc API?

Is the T3 API free?

Get Started

T3 API
The best way to talk to Metrc