GET api/v2/tags/{id}

Get tag by unique identificator (EPC)

Request Information

URI Parameters

Name	Description	Type	Additional information
id	Tag EPC	string	Required

Body Parameters

None.

Response Information

Resource Description

Tag details object

TagDetails

Name	Description	Type	Additional information
last-seen-time	Last time this tag was observed	date	None.
last-seen-location	Last location where this tag was observed	LocationSimple	None.
previous-location	Previous location of this tag (this may be only meaningful when a movement has happened)	LocationSimple	None.
tag-status-user	Last location where this tag was observed	UserSimple	None.
enrolled-by	Last location where this tag was observed	UserSimple	None.
latitude	Last known Geo latitude of this item	decimal number	None.
longitude	Last known Geo longitude of this item	decimal number	None.
disposition	Should be 'inventory' to indicate that this is inventory operation	TagDisposition	None.
type	Tag type	TagType	None.
create-date	Update date (sync)	date	None.
update-date	Update date (sync)	date	None.
entity	Entity associated with the tag	TagvueEntity	None.
status	Status (active or not)	TagvueEntityStatus	None.
entity-id	Identifying entity-id of the entity, this is expected to be unique	string	None.

Response Formats

application/xml, text/xml

Sample:

<tag entity-id="sample string 3" xmlns="urn:tagvue:am">
  <status>inactive</status>
  <last-seen-time>2025-05-30T19:26:20.2255589-07:00</last-seen-time>
  <last-seen-location entity-id="sample string 2">
    <name>sample string 1</name>
  </last-seen-location>
  <previous-location entity-id="sample string 2">
    <name>sample string 1</name>
  </previous-location>
  <tag-status-user entity-id="sample string 1">
    <name>sample string 2</name>
    <email>sample string 3</email>
    <employee-id>sample string 4</employee-id>
    <phone>sample string 5</phone>
  </tag-status-user>
  <enrolled-by entity-id="sample string 1">
    <name>sample string 2</name>
    <email>sample string 3</email>
    <employee-id>sample string 4</employee-id>
    <phone>sample string 5</phone>
  </enrolled-by>
  <latitude>1.1</latitude>
  <longitude>1.1</longitude>
  <disposition>unknown</disposition>
  <type>Barcode</type>
  <create-date>2025-05-30T19:26:20.2255589-07:00</create-date>
  <update-date>2025-05-30T19:26:20.2255589-07:00</update-date>
  <entity entity-id="sample string 1" type="None" />
</tag>

application/json, text/json

Sample:

{
  "last-seen-time": "2025-05-30T19:26:20.2255589-07:00",
  "last-seen-location": {
    "name": "sample string 1",
    "entity-id": "sample string 2"
  },
  "previous-location": {
    "name": "sample string 1",
    "entity-id": "sample string 2"
  },
  "tag-status-user": {
    "entity-id": "sample string 1",
    "name": "sample string 2",
    "email": "sample string 3",
    "employee-id": "sample string 4",
    "phone": "sample string 5"
  },
  "enrolled-by": {
    "entity-id": "sample string 1",
    "name": "sample string 2",
    "email": "sample string 3",
    "employee-id": "sample string 4",
    "phone": "sample string 5"
  },
  "latitude": 1.1,
  "longitude": 1.1,
  "disposition": 0,
  "type": 0,
  "create-date": "2025-05-30T19:26:20.2255589-07:00",
  "update-date": "2025-05-30T19:26:20.2255589-07:00",
  "entity": {
    "Id": "sample string 1",
    "Type": 0
  },
  "status": 0,
  "entity-id": "sample string 3"
}