API referenceAssets
Get an asset
Preview· P9
GET
One asset and who holds it. One the key can't see doesn't exist for it.
Scope: assets:read
header
AuthorizationBearer <token>Send Authorization: Bearer <token> on every request. The token is one of:
| Prefix | What it is | Where it may be used |
|---|---|---|
agoo_sk_live_ | Secret key, live mode | Your servers only |
agoo_sk_test_ | Secret key, test mode | Your servers only |
agoo_pk_live_ | Publishable key, live mode | Browsers and apps: create pre-registrations and bookings, read public booking types (with their intake questions) and their free slots, read the visit types open for pre-registration with their public forms. Never lists people. |
agoo_pk_test_ | Publishable key, test mode | As above, in test mode |
agoo_rk_live_ | Agoo Reviews key, live mode: a business on Agoo Reviews on its own, on Reviews Business | Your servers only: the Reviews operations, for that business and the branches the key names |
agoo_rk_test_ | Agoo Reviews key, test mode | As above, on any level: it reads the business's reviews and checks every write without saving it |
agoo_ck_live_ | Check API key, live mode, for a Check API partner | Your servers only: the Checks operations (checks:read), billed per check |
agoo_ck_test_ | Check API key, test mode | As above, answering only the published test values, never billed |
Admins create keys in Console → Developers → API keys and choose each key's scopes; a business on Agoo Reviews on its own creates its keys in its business area on agoo.reviews, under Developers; a Check API partner creates its keys in its partner area on agoo.reviews. A key is shown once. Never put a secret key in a URL, a browser or a mobile app.
Scope: assets:read
asset_id*stringMatch
^asset_[0-7][0-9a-hjkmnp-tv-z]{25}$The asset.
application/json- response
id*stringname*stringtag*stringbarcode?stringserial?stringimei?stringstatus*stringValue in
"in_stock""assigned""in_repair""lost""retired"condition*stringValue in
"new""good""fair""poor""damaged"category*site?room?stringsupplier?stringpurchase_date?stringFormat
datewarranty_until?stringFormat
dateinsurance_until?stringFormat
dateshared?booleanholder?value_minor?integerWhole minor units, with assets.value_read.
value_currency?stringcustom?version*integercreated_at*stringFormat
date-timeupdated_at*stringFormat
date-timecurl -X GET 'https://api.agoohq.com/v1/assets/string'{ "id": "string", "name": "string", "tag": "string", "barcode": "string", "serial": "string", "imei": "string", "status": "in_stock", "condition": "new", "category": { "id": "string", "name": "string", "is_ppe": true }, "site": { "id": "string", "name": "string" }, "room": "string", "supplier": "string", "purchase_date": "2019-08-24", "warranty_until": "2019-08-24", "insurance_until": "2019-08-24", "shared": true, "holder": { "id": "string", "asset_id": "string", "holder_kind": "person", "person": { "id": "string", "name": "string" }, "site": { "id": "string", "name": "string" }, "team": { "id": "string", "name": "string" }, "pool_name": "string", "condition_out": "new", "expected_return_on": "2019-08-24", "assigned_at": "2019-08-24T14:15:22Z", "ack_state": "not_needed", "returned_at": "2019-08-24T14:15:22Z", "condition_in": "new", "version": 0 }, "value_minor": 0, "value_currency": "string", "custom": {}, "version": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z"}