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. Response Format

Error Responses

PreviousSuccessful ResponsesNextPagination

Last updated 1 year ago

Errors in the 4xx and 5xx range return a standard JSON format indicating the reason for the error along with additional contextual information.

For requests that fail with a response code of 400, the invalid key will have more information about which parameter(s) caused the request to fail.

{
    "code": "400",
    "type": "INVALID_REQUEST_ERROR",
    "message": "The request was invalid.",
    "invalid": [{
        "name": "limit",
        "reason": "Limit must be less than 500."
    }]
}

Error Codes

Code
Type
Reason

400

INVALID_REQUEST_ERROR

The request was invalid. Check the invalid key for information about which parameters caused the error.

402

PAYMENT_REQUIRED_ERROR

The credentials used are valid but the account is canceled or unpaid. Contact for more info.

403

AUTHENTICATION_ERROR

Your credentials are invalid. See for more info.

404

NOT_FOUND_ERROR

The requested URI was not found. Check the request and try again.

429

RATE_LIMIT_ERROR

You have exceeded the allowed number of requests. See for more info.

500

SERVER_ERROR

An unexpected error occurred on the server. Please try again later.

support
Authentication
Rate Limiting