This documentation is no longer actively supported and may be out of date. Going forward, please visit and bookmark our new site (https://docs.phunware.com/) for up-to-date documentation.
MARS API Architecture
Request / Response Format
JSON is used for the request and response format. JSON is a lightweight and portable format that maintains human-readability.
When making POST or PUT requests, the request parameters MUST be JSON-encoded and placed in the request body. When making GET requests, the request parameters MUST be JSON-encoded, then URI-encoded and placed directly in the query string.
Clients should expect JSON-encoded responses for every request, even those that result in an error.
Each method defines the HTTP method required depending on what the usage is. For example, if the method is used to simply get data, the HTTP method would be GET. If the method is used to delete data it uses DELETE.
Date / Time Format
The date and time MUST be expressed in RFC 3339 format: YYYY-MM-DDThh:mm:ssZ
All times must be in the UTC time zone and indicated with a "Z". This is done to mitigate issues regarding Daylight Saving Time (DST).