Skip to content
/
RFID API Guide
Last updated

RFID API Guide

Purpose

Yellow Dog supports RFID capabilities through third-party integration partners. To enable accurate interpretation of RFID tags printed by Yellow Dog, we expose the identifier values used as the basis for EPC (Electronic Product Code) generation.

This guide explains the epcGTIN property now available through our Item API endpoints.

What is epcGTIN?

Each RFID label printed by Yellow Dog contains an EPC value encoded into the RFID tag’s EPC memory bank.

A key component of that EPC is the GTIN payload.

The API field:

  • epcGTIN represents the list of GTIN14 values associated with an item.

This includes:

  • The current GTIN used for newly printed RFID labels
  • Any historical GTIN values previously used for that same item

Integrators should use this value when decoding EPCs read from Yellow Dog RFID tags.

Important Notes

GTIN14 is Not the Yellow Dog SKU

The GTIN14 value uniquely identifies each unit of an item in the Yellow Dog database.

  • Depending on the Yellow Dog system configuration, the generated GTIN-14 value may match the Yellow Dog item SKU
  • It is used specifically as part of RFID EPC generation

API Availability

  • The epcGTIN field is available in api responses from fetch API version 3.27.0 and above (Feb 2026).
  • The epcGTIN field is available only for database version 377 and above with a build code ≥ 2025.12.24.
  • This is the first release where the GTIN schema exists.

Supported API Endpoints

The following endpoints now return epcGTIN property with an array of strings when the expand=GTIN is included in the request:

  • GET /stores/:id/items
  • GET /items
  • GET /items/:id

Response Format

The API returns epcGTIN as an array of GTIN14 strings.

Example

[
  {
    "id""description": "abcdx0":,
    "itemDesc abcdx0",

    ... additional prexisting fields

    "epcGTIN": [
      "10001000012457"
    ]
  },
  {
    "id": "beefx0",
    "description": "itemDesc beefx0",

    ... additional prexisting fields

    "epcGTIN": [
      "10001000012487",
      "10000000045687"
    ]
  }
]

How Yellow Dog EPC Tags Use GTIN

Yellow Dog RFID tags are generated using:

  • A GTIN payload (epcGTIN)
  • A serial/sequence number to uniquely identify each tag instance

Example

  • GTIN: 10000000017999
  • Serial/sequence number: 100000000004

The resulting EPC memory bank value will be encoded as:

  • HEX: 30340000006369d74876e

This corresponds to the EPC URI:

  • urn:epc:tag:sgtin-96:1.0000000.101799.

Integration Workflow

When interacting with Yellow Dog-generated RFID tags, integrators should:

  1. Read the EPC memory bank from the RFID tag
  2. Decode the EPC into its URI or component fields
  3. Extract the GTIN value
  4. Look up that GTIN in the integrator’s system mapping
  5. Resolve it back to the Yellow Dog ItemID or SKU
  6. Use other Yellow Dog API endpoints for item-level operations

Summary

The epcGTIN field enables integrators to correctly interpret Yellow Dog RFID tags by exposing the GTIN payloads used in EPC creation.

This ensures consistent mapping between RFID reads and Yellow Dog item identities across all supported API endpoints.


Previous page
Next page