Subjects - Retrieve

Retrieves the details of a Subject.

ArgumentDescription
subject_uid
string
(required) The unique identifier of the Subject object to be retrieved

Retrieve Subject

GET /1/subjects/{subject_uid}
Host: https://api.cogniac.io

Example: Retrieve a Subject

curl -X GET https://api.cogniac.io/1/subjects/cat_123 \
-H "Authorization: Bearer abcdefg.hijklmnop.qrstuvwxyz"
import cogniac

# connect to the tenant
cc = cogniac.CogniacConnection(username="[email protected]", 
                               password="myPassword", 
                               tenant_id="63QhzFLc9tg4")

# retrieve the subject with subject_uid
subject = cc.get_subject("cat_123")

print subject.name
{
  "subject_uid": "cat_123",
  "name": "Cat",
  "description": "Domestic cats from catdoor camera"
  "created_at": 1463175250.216059,
  "modified_at": 1463175250.216059,
  "created_by": "[email protected]",
  "tenant_id": "lmulcvdfluyw"
}