Blockchain Traceability - Basic

The Blockchain Traceability API provides users the ability to record, retrieve and track their scan, print, and read events on a secure blockchain ledger.

Getting Started

Sample Use Cases

  • A retail grocer customer scans the barcode of a batch of romaine lettuce at each point in the supply chain and records that information to the blockchain. If some of those batches are recalled for contamination, only the food from those batches is removed from the shelves.

Device Specifications

  • No device is required to consume this API.

Service Level Agreements (SLAs)

  • Throughput: Based on pricing plan selected. Basic = 1 call per second
  • Uptime: 99%
  • Response Time: Average is < 500ms. Can take up to 30 seconds.

Tags

Action, Search, Blockchain

Authentication

A Zebra Savanna application key is required for using and testing this API. See the Getting Started Guide for instructions on obtaining a key.

Read

Method
Description

GET

Retrieve Read Transaction

https://api.zebra.com/v2/zebra-blockchain/read/transaction/{id}

Retrieves an RFID read transaction by transaction ID

GET

Retrieve Read Transactions

https://api.zebra.com/v2/zebra-blockchain/read

Retrieves a list of all read transactions

POST

Record Read Transaction

https://api.zebra.com/v2/zebra-blockchain/read

Records a new read transaction to the blockchain

GET

Retrieve Read Transactions by Reader

https://api.zebra.com/v2/zebra-blockchain/read/device/{id}

Retrieves a list of transactions for an RFID reader device

GET

Retrieve Read Transactions by EPC

https://api.zebra.com/v2/zebra-blockchain/read/{epchex}

Retrieves a list of transactions for an EPC value

Scan

Method
Description

GET

Retrieve Transaction Summary by Device

https://api.zebra.com/v2/zebra-blockchain/scan/device/{id}

Retrieves a list of transactions for a scanner device

GET

Retrieve Scan Transaction

https://api.zebra.com/v2/zebra-blockchain/scan/transaction/{id}

Retrieves a specific scan transaction by transaction ID

GET

Retrieve Scan Transaction Summary

https://api.zebra.com/v2/zebra-blockchain/scan

Retrieves a list of all scan transactions

POST

Record Scan Transaction

https://api.zebra.com/v2/zebra-blockchain/scan

Records a new scan transaction to the blockchain

GET

Retrieve Transaction Summary by Barcode

https://api.zebra.com/v2/zebra-blockchain/scan/{barcode}

Retrieves a list of transactions for a barcode

Print

Method
Description

GET

Retrieve Print Transactions

https://api.zebra.com/v2/zebra-blockchain/print

Retrieves a list of all print transactions

GET

Retrieve Print Transactions by Printer

https://api.zebra.com/v2/zebra-blockchain/print/device/{id}

Retrieves a list of transactions for a printer device

GET

Retrieve Print Transaction

https://api.zebra.com/v2/zebra-blockchain/print/transaction/{id}

Retrieves a specific print transaction by transaction ID

POST

Record Print Transaction

https://api.zebra.com/v2/zebra-blockchain/print

Records a new print transaction to the blockchain