List All Users

The Nearby New User API is organized around REST. JSON will be returned in all responses from the API, including errors.

Endpoint


https://api.sidebox.com/users/list


Authentication

All calls made to the Nearby Now Users API require authentication.

You authenticate to the Nearby Now API by providing your Agency API key, and one of your client’s Account API keys in the request. Your agency API keys, and customer account API keys carry many privileges, so be sure to keep them secret.

Authentication to the API occurs via HTTP Basic Auth. Provide your agency API key as the basic auth username, and your client’s Account API key as the basic auth password.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail.

Errors

The Nearby Now API uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required parameter was missing, authentication information was missing, etc.), and codes in the 5xx range indicate an error with Nearby Now’s servers.

All requests, success or failure, will return a JSON response with a Users List Object and a success flag. A failed request will contain an error message string describing the problem.

Examples

Here’s an example cURL request that shows how simple it is to call the Nearby Now API, as well as an example success and error response:

curl  https://api.sidebox.com/users/list \
   -u 'agency_api_token:account_api_token'

Example Response:

{
    "obj": "users",
    "success": true,
    "data": [
        {
            "Email": "billy@nearbynow.co",
            "FullName": "Billy Coover",
            "CreatedAt": 1384455825
        },
        {...},
        {...}
    ]
}