DTM docs
HomeDor Traffic MinerMetagraphDTM AppMarketingAPI
API
API
  • Overview
  • Authentication
    • Basic Auth
    • Manually Creating Basic Auth Headers
  • Response Format
    • Successful Responses
    • Error Responses
  • Pagination
  • Datetimes
    • Datetime Formats
    • Datetimes Grouped by Local Time Zone
  • Rate Limiting
  • Syncing Data
    • Asynchronous Data
    • Querying by Update Timestamp
  • Data Validity
    • Validity
    • Completeness
  • Endpoints
    • Organizations
      • GET /organizations
      • GET /organizations/{org_id}
    • Locations
      • GET /locations
      • GET /locations/{location_id}
      • GET /locations/{location_id}/devices
      • POST /locations
      • DELETE /locations/{location_id}
    • Devices
      • GET /devices
      • GET /devices/{serial_number}
      • PUT /devices/{serial_number}
      • POST /devices/{serial_number}/install
      • POST /devices/{serial_number}/uninstall
      • GET /uninstalled-devices
    • Foot Traffic
      • GET /foot-traffic/locations
      • GET /foot-traffic/devices/{serial_number}
    • Schemas
      • Organization
      • Location
      • Address
      • Device
      • LocationMetric
      • Foot Traffic
Powered by GitBook
On this page
  1. Endpoints
  2. Devices

POST /devices/{serial_number}/install

Install a device at a location

PreviousPUT /devices/{serial_number}NextPOST /devices/{serial_number}/uninstall

Last updated 1 year ago

This endpoint allows you to associate a specific DTM device with a designated location.

Install a device at a location

post

Install a device at a location

Authorizations
Path parameters
serial_numberstringRequired

serial_number

Body
location_idstringRequiredExample: loc_xxxxx
Responses
200
Successful operation
application/json
400
Invalid parameters
404
Device not found or already installed
post
POST /dtm-api/v1/devices/{serial_number}/install HTTP/1.1
Host: api.getdor.com
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "location_id": "loc_xxxxx"
}
{
  "data": {
    "created_at": "2021-10-10T00:00:00Z",
    "deleted_at": "2021-10-10T00:00:00Z",
    "device": {
      "serial_number": "AA000000",
      "device_type_name": "DTM",
      "firmware_version_name": "1.0.0",
      "last_checkin_at": "2021-10-10T00:00:00Z"
    },
    "location": {
      "name": "AA000000",
      "id": "loc_xxxxx",
      "address": {
        "address_1": "1234 Demo Street",
        "address_2": "text",
        "city": "San Francisco",
        "administrative_area": "CA",
        "country": "United States",
        "postal_code": 94110
      }
    }
  },
  "meta": {}
}