Simple In/Out API v4 Documentation

Welcome to the Simple In/Out API! You can use our API to access Simple In/Out data. You can request both read and write access.

The Simple In/Out v4 API is a RESTful (mostly) API protected by OAuth 2.

Rate Limiting

APIv4 is protected by daily rate limits. Currently, your application can access APIv4 up to 10,000 times per 24 hour period. Every request to APIv4 will return with two headers: X-RateLimit-Limit and X-RateLimit-Remaining. X-RateLimit-Limit will indicate the total number of requests that can be made against APIv4 over a 24 hour period (always 10,000 for now). X-RateLimit-Remaining will indicate how many requests you have left.

When you’ve run out of requests, APIv4 will return a HTTP status of 429 indicating Too Many Requests.

Expansions

Some of our APIs allow you to include additional information. This saves on API calls, as you can retrieve related information in the primary call and avoid additional requests.

When an API supports including additional information, it does so via the expand query parameter. This is a comma-delimited list of resources to include. We support expansions via embedding directly into the payload.

The Meta object

Most API payloads include a meta object to provide additional details about the requested resource(s). This includes paging most often, and sometimes additional information about the user making the request. For some payloads there may be additional items in the meta.

Here’s an example of a meta object

{"meta": {
  "paging": {
    "page": 1,
    "page_size": 25,
    "page_count": 2,
    "count": 47,
    "previous_page": null,
    "next_page": 2,
    "first_href": "https://www.simpleinout.com/api/v4/beacons",
    "last_href": "https://www.simpleinout.com/api/v4/beacons?page=2",
    "previous_href": null,
    "next_href": "https://www.simpleinout.com/api/v4/beacons?page=2"
  },
  "last_updated_at": {
    "announcements": 1435258926,
    "beacons": 1435250484,
    "favorites": 1437151284,
    "fences": 1436546484,
    "groups": 1436287284,
    "networks": 1436287284,
    "settings": 1439916084
  },
  emergency: nil
}}

Pagination

Pagination occurs when requesting multiple objects. Information about this appears in the meta object.

Name Description
page the page number currently being returned
page_size the number of results per page
page_count the total number of pages available
count the total number of results
previous_page the number of the previous page
next_page the number of the next page
first_href the URL of the API call for the first page of results
last_href the URL of the API call for the last page of results
previous_href the URL of the API call for the page of results prior to the current page
next_href the URL of the API call for the page of results after the current page

Last Update At

The last_updated_at attribute in the meta object returns the epoch time indicating the last time certain resources have been updated. This applies to the authorized user’s company. By storing these dates, you can discover when resources have been updated without having to poll those resources on a regular basis.

If Modified Since and If None Match

Most of the GET requests to the API support the If-Modified-Since and If-None-Match headers. If these two headers are present, the GET request will only return a payload if the relevant data has been updated since the time specified in the If-Modified-Since header and the ETag in the If-None-Match header. If it has been updated since, the payload will be the same as usual. If the data has not been updated, the return will be empty with a HTTP status of 304 (Not Modified). The format of the time is in the HTTP specification, while the ETag should be the same as that returned when a request has been made previously.

When a GET API returns data, the Last-Modified header will be present providing the exact time it’s been modified. This date should be used for future If-Modified-Since requests. The ETag header will be present providing the hash value representing the returned payload. This hash should be used for future If-None-Match requests.

Range Searching

Some integer or date/time fields can be searched by using operators. This permits exact searches, as well as less than, greater than, or between. For these fields, you have an array of options.

  • For exact matches, simply include the value. Date/time fields use epoch time, so it’s almost impossible to get an exact match to the second. Examples are 18 or 1524168783.
  • For ranges based on a single value, you may prepend a symbol to the front of the value. The symbols <, >, <=, or >= are supported. Examples are <18 or >=1524168783.
  • For between range searches, the .. operator is used in between the two values. This includes the values on both ends, as well as those in between. Examples are 9..18 or 1523854800..1524459599.

Sorting

When requesting multiple objects, most of the time you’ll have some sorting options available. Sorting occurs by passing in the sort query parameter. The value is a comma-delimited string of fields in the order you wish them to be sorted. By default, all fields will sort in ascending fashion, but you can sort in descending fashion by including a - sign before the field. An example of this would be sort=name,-begin_at.

Errors

Error objects in Simple In/Out consist of three parts: code, message, and details.

  • code corresponds with those listed below. These provide context as to what type of error occurred.
  • message is an English plain-text reading of what happened. This should be used for further developer debugging, but should not be relied on to remain consistent over time. While these messages can be displayed to end-users, it is highly discouraged as they can change without notice and they are always going to be in English.
  • details provides an array of information in the case of validation failures. This will typically be populated with 5005 validation errors, though they also can appear with improperly formatted status updates (2002). The format of the objects in the array are key: value pairs, whereby key is the name of a field and value is one of a number of possible strings to indicated more specifically what was invalid with the input. Please note that while the key will typically be a parameter on the object, it can occasionally be base for errors that fail validation but don’t apply to a particular field.

An example of an error payload:

{
  "code": 5005,
  "message": "Validation Failure: Name can't be blank, UUID is invalid, Beacons exceed company limit of 100",
  "details": [
    { "name": "blank" },
    { "uuid": "invalid" },
    { "base": "greater_than" }
  ]
}

Error Codes

1002: Company is Disabled

Either the user’s company was on a trial and the trial has expired or the company has let their subscription to Simple In/Out expire. This error will present itself on almost all APIs and will return with the status code 403.


2002: Status Failure

The status update could not be completed.


5001: Bad Range

The integer or date value/range is invalid.


5002: Unknown Sort

The sort requested does not exist. The full message of this error will provide more explanation.


5003: Unknown Expansion

The expansion requested does not exist. The full message of this error will provide more explanation.


5005: Validation Failure

When attempting to create/update/delete the object, some data was either missing or invalid. The full message of this error will provide more explanation.


5007: Parameters Missing

A required parameter for this API was missing.


5008: Array Required

A parameter which is required to be an array was passed something other than an array.


5009: Unknown Only

The only field requested does not exist. The full message of this error will provide more explanation.


5010: Invalid Float

The floating point number is invalid.


5012: Invalid JSON

The posted JSON body is invalid.


5013: Invalid Page Size of Zero

The page_size parameter cannot be zero.


5014: Invalid mime-type requested

An invalid mime-type was requested.

Error Details

taken

The attribute is not unique

inclusion

The attribute is not in the list of acceptable values

invalid

The attribute is not valid

empty

The attribute cannot be empty

blank

The attribute cannot be blank

too_long

The attribute is too long

not_a_hex

The attribute is not a valid hex color code

not_a_number

The attribute is not a number

not_an_integer

The attribute is not an integer

greater_than

The attribute is greater than a predefined limit

greater_than_or_equal_to

The attribute is greater than or equal to a predefined limit

less_than

The attribute is less than a predefined floor

less_than_or_equal_to

The attribute is greater than or equal to a predefined floor

too_long

The attribute is longer than allowed

too_short

The attribute is shorter than allowed

Forbidden Requests (403)

When the user is authenticated, but doesn’t have the necessary permissions to perform an action, the server will respond with the status code of 403 and include the user’s privileges in the payload.

Example payload:

{
  "company": {
    "id": "1",
    "scheduled_statuses": true
  },
  "user": {
    "id": "5",
    "roles": {
      "name": "Regular User",
      "billing": false
      "followed_users": false,
      "reminders": false,
      "safeties": false,
      "user_board": true,
      "manage_company_and_users": false,
      "manage_groups_and_memberships": false,
      "manage_others_archives": false,
      "manage_others_futures": false,
      "manage_others_status": false,
      "manage_own_archives": false,
      "manage_own_futures": true,
      "manage_own_status": true,
      "view_others_archives": true,
      "view_others_futures": true,
      "view_others_reports": false,
      "view_user_board_updated_at": true,
      "member_board": false,
      "manage_member_archives": false,
      "manage_member_futures": false,
      "manage_member_status": false,
      "view_member_archives": false,
      "view_member_futures": false,
      "view_member_reports": false,
      "created_at": 1506268448,
      "updated_at": 1506269853
    }
  }
}

The privileges payload may not exist on all forbidden responses. In the cases when an error code is used, such as when a company is disabled, only the code and message will be returned.

Web Hooks

Web Hooks are a great way to be notified when something happens inside Simple In/Out. When you add a Web Hook URL to Simple In/Out, we’ll send a request to that URL with JSON in the body to tell you about things that have happened.

Currently, this applies to only three event types: status.new, status.schedule, and status.destroy, though many may be added in the future. It is strongly advised that you code against the type attribute on the root of the JSON object to avoid new event types being added in the future having unexpected impacts on your code.

The root JSON keys define the basics and out of the box are compatible with Slack’s incoming webhooks. This also means that the text with be formatted in Markdown. Within the data object is much of the information specific to Simple In/Out, including ids that can be used in combination with APIv4 to request further information.

{
  "username": "Bojack Horseman",
  "email": "[email protected]",
  "icon_url": "http://bojackhorseman.com/avatar.gif",
  "text": "*In*: In Hollywoo",
  "type": "status.new",
  "data": {
    "user_id": "34858",
    "status": "in",
    "comment": "In Hollywoo",
    "created_at": 1448046759,
    "admin": {
      "id": "2844", "name": "Princess Carolyn"
    },
    "application": {
      "id": "84774", "name": "Simple In/Out iOS"
    }
  }
}



Announcements

Create a announcement

Creates a new announcement. Once this announcement is created, it will appear in the company’s announcements within the Simple In/Out apps. Users must have a role that permits managing announcements to create announcements. Companies are limited to 100 announcements.

Endpoint

POST /api/v4/announcements

Parameters

Name Description
announcement[message] required (string) the name of the announcement
announcement[push] (boolean) whether this announcement should trigger a push notification to users, defaults to false
announcement[group_id] (string) restrict the announcement to a specific group, defaults to no restrictions
announcement[expires_at] (integer) the epoch time when the announcement should expire, defaults to no expiration
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user'

Request

Route

POST /api/v4/announcements

Headers

Content-Type: application/json
Authorization: Bearer 8Hv-ZMHT5kXrq1aolabPUuCl-pVkYhjupwzU6G9nbu8

Body

{
  "announcement": {
    "message": "Evacuate the building",
    "push": false,
    "group_id": "58602",
    "expires_at": 1739462016
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/announcements" -d '{"announcement":{"message":"Evacuate the building","push":false,"group_id":"58602","expires_at":1739462016}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer 8Hv-ZMHT5kXrq1aolabPUuCl-pVkYhjupwzU6G9nbu8"

Response

Simulated Response

Response Fields

Name Description
announcements (object) the newly created announcement attributes

Status

201

Headers

ETag: W/"99ce23047397e977742733fdefb5c29e"

Body

{
  "announcements": {
    "id": "1754",
    "group_id": "58602",
    "user_id": "941640",
    "message": "Evacuate the building",
    "push": false,
    "expires_at": null,
    "created_at": 1739375616,
    "updated_at": 1739375616
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1739375616,
      "beacons": 1737215616,
      "desktop_presences": 1735660416,
      "favorites": 1736265216,
      "fences": 1737993216,
      "groups": 1739375616,
      "networks": 1736870016,
      "roles": 1739375616,
      "settings": 1739375616
    },
    "emergency": null
  }
}

Delete an announcement

Deletes an existing announcement. Users must have a role that permits managing the announcements to delete announcements.

Endpoint

DELETE /api/v4/announcements/:id

Request

Route

DELETE /api/v4/announcements/1757

Headers

Content-Type: application/json
Authorization: Bearer kjJMNheaAZ7SI7sC8oEa3acHnQfoKhkhBA_7Kjza5Vo

cURL

curl "https://www.simpleinout.com/api/v4/announcements/1757" -d '' -X DELETE \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer kjJMNheaAZ7SI7sC8oEa3acHnQfoKhkhBA_7Kjza5Vo"

Response

Simulated Response

Status

204

List all announcements

Return a list of all the announcements belonging to the company.

Endpoint

GET /api/v4/announcements

Parameters

Name Description
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'name'
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user'

Request

Route

GET /api/v4/announcements

Headers

Content-Type: application/json
Authorization: Bearer 1UL7ZW4t84KS3c_lTZ_JfNGqIIfaAMg2fxBlCGDpYj8

cURL

curl -g "https://www.simpleinout.com/api/v4/announcements" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer 1UL7ZW4t84KS3c_lTZ_JfNGqIIfaAMg2fxBlCGDpYj8"

Response

Simulated Response

Response Fields

Name Description
announcements (array) an array of announcements

Status

200

Headers

ETag: W/"4ac4518c6329e9b1ba7aa658d9748aef"
Last-Modified: Wed, 12 Feb 2025 15:53:36 GMT

Body

{
  "announcements": [
    {
      "id": "1755",
      "group_id": null,
      "user_id": "941642",
      "message": "Non vitae quisquam voluptas.",
      "push": false,
      "expires_at": 1739462016,
      "created_at": 1739375616,
      "updated_at": 1739375616
    },
    {
      "id": "1756",
      "group_id": null,
      "user_id": "941642",
      "message": "Inventore quisquam non quia.",
      "push": false,
      "expires_at": 1739462016,
      "created_at": 1739375616,
      "updated_at": 1739375616
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 2,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/announcements",
      "last_href": "http://example.org/api/v4/announcements",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1739375616,
      "beacons": 1732722816,
      "desktop_presences": 1734796416,
      "favorites": 1737647616,
      "fences": 1734191616,
      "groups": 1732895616,
      "networks": 1731858816,
      "roles": 1739375616,
      "settings": 1739375616
    },
    "emergency": null
  }
}

Authentication

Authorization

Authorization is required to access the Simple In/Out API. This results in a HTTP 302 redirect to simpleinout.com. There, Simple In/Out will ask the user for their credentials and verify they wish to grant your application permission to act on their behalf. If they allow it, Simple In/Out will send a request to your redirect_uri with a code that you can use in the Authorization Code grant to have access and refresh tokens to access the API.

Endpoint

GET /oauth/authorize

Parameters

Name Description
response_type required (string) the type of authorization to use, in this case always 'code'
client_id required (string) your API client key
redirect_uri required (string) the URI to return the user to after authenticating, must match those registered with Simple In/Out
scope required (string) requested scope, either 'read' or 'write', by default 'read'
locale (string) the language for authorization. Available locales: en, en-au, en-ca, en-gb, es, fr, fr-ca. Defaults to 'en'

Request

Route

GET /oauth/authorize?response_type=code&client_id=PLACE_YOUR_API_CLIENT_ID_HERE&redirect_uri=https%3A%2F%2Fwww.simplymadeapps.com%2Fredirect%2Furl&scope=write&locale=en

Headers

Content-Type: application/json

Query Parameters

response_type=code
client_id=PLACE_YOUR_API_CLIENT_ID_HERE
redirect_uri=https://www.simplymadeapps.com/redirect/url
scope=write
locale=en

cURL

curl -g "https://www.simpleinout.com/oauth/authorize?response_type=code&client_id=PLACE_YOUR_API_CLIENT_ID_HERE&redirect_uri=https%3A%2F%2Fwww.simplymadeapps.com%2Fredirect%2Furl&scope=write&locale=en" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json"

Response

Simulated Response

Status

302

Body

<html><body>You are being <a href="http://example.org/oauth/authorize?client_id=PLACE_YOUR_API_CLIENT_ID_HERE&amp;redirect_uri=https%3A%2F%2Fwww.simplymadeapps.com%2Fredirect%2Furl&amp;response_type=code&amp;scope=write&amp;user_confirmed=true&amp;locale=en">redirected</a>.</body></html>

Authorization Code grant

Authorization Code should be used for accessing the API on behalf of a particular user. This is useful for pulling information about the user, or customizing the return of some APIs by the user’s preference.

The first step here is to have your user authorize your app for use. To do this, send your user to our site as noted to the left, passing your client_id and your redirect_uri. We’ll handle asking for the user, authenticating they are who they say they are, and handling the authorization (asking the user for permission on your behalf).

Once your user successfully authorizes your application, they will be redirected back to you. In this response will be a code in the form of a query string. Use this code to request tokens from Simple In/Out. You’ll then receive an access token and refresh token.

Endpoint

POST /oauth/token

Parameters

Name Description
grant_type required (string) type of grant to use
client_id required (string) your API client key
client_secret required (string) your API client secret
code required (string) if using Authorization Code grant, this is the code that is returned from Simple In/Out
redirect_uri required (string) the URI to return the user to after authenticating, must match those registered with Simple In/Out
scope (string) requested scope, either 'read' or 'write', defaults to 'read'

Request

Route

POST /oauth/token

Headers

Content-Type: application/json

Body

{
  "grant_type": "authorization_code",
  "client_id": "YOUR_API_CLIENT_ID",
  "client_secret": "YOUR_API_CLIENT_SECRET",
  "code": "Whygqe11Bew8fIw9tGqKrGZhoG6o7Zegnt8O5h_J2Jw",
  "redirect_uri": "https://www.simplymadeapps.com/redirect/url"
}

cURL

curl "https://www.simpleinout.com/oauth/token" -d '{"grant_type":"authorization_code","client_id":"YOUR_API_CLIENT_ID","client_secret":"YOUR_API_CLIENT_SECRET","code":"Whygqe11Bew8fIw9tGqKrGZhoG6o7Zegnt8O5h_J2Jw","redirect_uri":"https://www.simplymadeapps.com/redirect/url"}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json"

Response

Simulated Response

Response Fields

Name Description
access_token (string) the access token used to make API requests
refresh_token (string) used with the Refresh Token grant type to request a new token
token_type (string) identifies the type of token
expires_in (integer) length of time, in seconds, that the token will be honored
scope (string) the scope of the token, either 'read' or 'write'
created_at (integer) the time the token was issued
user (object) the authenticated user's id, company id, and role.

Status

200

Headers

ETag: W/"de9152d0947af5c2fc0454c813e4b9d2"

Body

{
  "access_token": "cCQdPwF4_goKpzKCWfPFJv9W1fLncyRPTM61pqWF4js",
  "token_type": "Bearer",
  "expires_in": 7200,
  "refresh_token": "OhPg1cxGhMHuUzAZ6LQ1nVWyCPRGVQzN0bso6Ale1s8",
  "scope": "write",
  "created_at": 1739375619,
  "user": {
    "id": "941760",
    "company_id": "514847",
    "roles": {
      "id": "2283809",
      "name": "Administrator",
      "billing": true,
      "followed_users": true,
      "reminders": true,
      "safeties": true,
      "user_board": true,
      "manage_company_and_users": true,
      "manage_groups_and_memberships": true,
      "manage_others_archives": true,
      "manage_others_futures": true,
      "manage_others_status": true,
      "manage_own_archives": true,
      "manage_own_futures": true,
      "manage_own_status": true,
      "view_others_archives": true,
      "view_others_futures": true,
      "view_others_reports": true,
      "view_user_board_updated_at": true,
      "member_board": false,
      "manage_member_archives": false,
      "manage_member_futures": false,
      "manage_member_status": false,
      "view_member_archives": false,
      "view_member_futures": false,
      "view_member_reports": false,
      "created_at": 1739375619,
      "updated_at": 1739375619
    }
  }
}

Refresh Token grant

Refresh Token should be used to renew your access token in the event that it has expired. This is useful for regaining access without again having to as the user for credentials.

Endpoint

POST /oauth/token

Parameters

Name Description
grant_type required (string) type of grant to use, in this case always 'refresh_token'
client_id required (string) your API client key
client_secret required (string) your API client secret
refresh_token required (string) your refresh token

Request

Route

POST /oauth/token

Headers

Content-Type: application/json

Body

{
  "grant_type": "refresh_token",
  "client_id": "YOUR_API_CLIENT_ID",
  "client_secret": "YOUR_API_CLIENT_SECRET",
  "refresh_token": "ph71eka1m9urmnjw0x9m8zvcumgir0yh"
}

cURL

curl "https://www.simpleinout.com/oauth/token" -d '{"grant_type":"refresh_token","client_id":"YOUR_API_CLIENT_ID","client_secret":"YOUR_API_CLIENT_SECRET","refresh_token":"ph71eka1m9urmnjw0x9m8zvcumgir0yh"}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json"

Response

Simulated Response

Response Fields

Name Description
access_token (string) the access token used to make API requests
refresh_token (string) used with the Refresh Token grant type to request a new token
token_type (string) identifies the type of token
expires_in (integer) length of time, in seconds, that the token will be honored
scope (string) the scope of the token, either 'read' or 'write'
created_at (integer) the time the token was issued
user (object) the authenticated user's id and role.

Status

200

Headers

ETag: W/"724e042f82d54f3d29a8ca0f557c17a1"

Body

{
  "access_token": "d0No5s8WafnYhLlD2QoVZRVRWAXyFNUfPhQck2Ze2nM",
  "token_type": "Bearer",
  "expires_in": 604800,
  "refresh_token": "8pJcahmG5wVsV7XbOqA-WnAmFIv5z90hP8Nzwv13H74",
  "scope": "write",
  "created_at": 1739375619,
  "user": {
    "id": "941764",
    "company_id": "514850",
    "roles": {
      "id": "2283821",
      "name": "Administrator",
      "billing": true,
      "followed_users": true,
      "reminders": true,
      "safeties": true,
      "user_board": true,
      "manage_company_and_users": true,
      "manage_groups_and_memberships": true,
      "manage_others_archives": true,
      "manage_others_futures": true,
      "manage_others_status": true,
      "manage_own_archives": true,
      "manage_own_futures": true,
      "manage_own_status": true,
      "view_others_archives": true,
      "view_others_futures": true,
      "view_others_reports": true,
      "view_user_board_updated_at": true,
      "member_board": false,
      "manage_member_archives": false,
      "manage_member_futures": false,
      "manage_member_status": false,
      "view_member_archives": false,
      "view_member_futures": false,
      "view_member_reports": false,
      "created_at": 1739375619,
      "updated_at": 1739375619
    }
  }
}

Revoke a token

Revokes a token, rendering it invalid.

Endpoint

POST /oauth/revoke

Parameters

Name Description
client_id required (string) your API client key
client_secret required (string) your API client secret
token required (string) the token to revoke

Request

Route

POST /oauth/revoke

Headers

Content-Type: application/json

Body

{
  "client_id": "6510783471040",
  "client_secret": "1421078260575",
  "token": "OjRv9Li66dtq9HH8hvdYEM4rBfvlR498vnU1lmQGs2k"
}

cURL

curl "https://www.simpleinout.com/oauth/revoke" -d '{"client_id":"6510783471040","client_secret":"1421078260575","token":"OjRv9Li66dtq9HH8hvdYEM4rBfvlR498vnU1lmQGs2k"}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json"

Response

Simulated Response

Status

200

Headers

ETag: W/"44136fa355b3678a1146ad16f7e8649e"

Body

{}

Token information

Provides details about the OAuth token.

Endpoint

GET /oauth/token/info

Request

Route

GET /oauth/token/info

Headers

Content-Type: application/json
Authorization: Bearer 74ecKbOH_62K8lQA_FYH0BQwOhWTBg_AmUkTtO9HYiA

cURL

curl -g "https://www.simpleinout.com/oauth/token/info" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer 74ecKbOH_62K8lQA_FYH0BQwOhWTBg_AmUkTtO9HYiA"

Response

Simulated Response

Response Fields

Name Description
resource_owner_id (integer) the id of the user
scopes (array) the scopes this token is authorized to use
expires_in_seconds (integer) the number of seconds until the token expires
application (object) information about the application
created_at (integer) the time the token was issued

Status

200

Headers

ETag: W/"2d620440018c4e1fecfae36c912a570d"

Body

{
  "resource_owner_id": 941762,
  "scope": [
    "read"
  ],
  "expires_in": 604800,
  "application": {
    "uid": "6176710777892"
  },
  "created_at": 1739375619
}

Beacons

Create a beacon

Creates a new beacon. Once this beacon is created, it will appear in the company’s beacons within the Simple In/Out apps. The UUID can then be added to a hardware beacon to broadcast. Users must have a role that permits managing the company to create beacons. Companies are limited to 100 Beacons.

Endpoint

POST /api/v4/beacons

Parameters

Name Description
beacon[name] required (string) the name of the beacon
beacon[uuid] (string) the unique beacon identifier
beacon[comment_on_entry] (string) the comment applied to status updates on entry, defaults to 'In at {name}'
beacon[comment_on_exit] (string) the comment applied to status updates on exit, defaults to 'Left {name}'
beacon[status_on_entry] (string) the status to apply on entry: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'in'
beacon[status_on_exit] (string) the status to apply on exit: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'out'

Request

Route

POST /api/v4/beacons

Headers

Content-Type: application/json
Authorization: Bearer B_XxBqOQe7zqqHMUgyuNyY109tw-UPelzwv9Nl-nf9s

Body

{
  "beacon": {
    "name": "My Office",
    "uuid": "6EA4801F-4D41-4114-AFA7-7EC977C81B41"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/beacons" -d '{"beacon":{"name":"My Office","uuid":"6EA4801F-4D41-4114-AFA7-7EC977C81B41"}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer B_XxBqOQe7zqqHMUgyuNyY109tw-UPelzwv9Nl-nf9s"

Response

Simulated Response

Response Fields

Name Description
beacons (object) the newly created beacon attributes

Status

201

Headers

ETag: W/"2312a70c0fcbc1967abc91610a9c83fd"

Body

{
  "beacons": {
    "id": "26070",
    "name": "My Office",
    "uuid": "6EA4801F-4D41-4114-AFA7-7EC977C81B41",
    "comment_on_entry": "In at My Office",
    "comment_on_exit": "Left My Office",
    "entry": true,
    "exit": true,
    "status_on_entry": "in",
    "status_on_exit": "out",
    "created_at": 1739375619,
    "updated_at": 1739375619
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1738079619,
      "beacons": 1739375619,
      "desktop_presences": 1734882819,
      "favorites": 1734450819,
      "fences": 1737302019,
      "groups": 1733327619,
      "networks": 1734882819,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null
  }
}

Delete a beacon

Deletes an existing beacon. Users must have a role that permits managing the company to delete beacons.

Endpoint

DELETE /api/v4/beacons/:id

Request

Route

DELETE /api/v4/beacons/26071

Headers

Content-Type: application/json
Authorization: Bearer lxtp01X5mb_STHQMViYurTJyI0MKexilkE_AjItSdr4

cURL

curl "https://www.simpleinout.com/api/v4/beacons/26071" -d '' -X DELETE \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer lxtp01X5mb_STHQMViYurTJyI0MKexilkE_AjItSdr4"

Response

Simulated Response

Status

204

List all beacons

Return a list of all the beacons belonging to the company.

Endpoint

GET /api/v4/beacons

Parameters

Name Description
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'name'
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results

Request

Route

GET /api/v4/beacons

Headers

Content-Type: application/json
Authorization: Bearer -v55Tnahwb-SdVWZ3QSfNkyA0IKD4AMAWLYakh3e_jw

cURL

curl -g "https://www.simpleinout.com/api/v4/beacons" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer -v55Tnahwb-SdVWZ3QSfNkyA0IKD4AMAWLYakh3e_jw"

Response

Simulated Response

Response Fields

Name Description
beacons (array) an array of beacons

Status

200

Headers

ETag: W/"579ce8117c396d03238e51d7c008c5d7"
Last-Modified: Wed, 12 Feb 2025 15:53:39 GMT

Body

{
  "beacons": [
    {
      "id": "26067",
      "name": "2 - East Reyton",
      "uuid": "969C3BF9-CBE6-4835-91AA-3DBF79835FC5",
      "comment_on_entry": "In at 2 - East Reyton",
      "comment_on_exit": "Left 2 - East Reyton",
      "entry": true,
      "exit": true,
      "status_on_entry": "in",
      "status_on_exit": "out",
      "created_at": 1739375619,
      "updated_at": 1739375619
    },
    {
      "id": "26068",
      "name": "3 - West Westonview",
      "uuid": "68F4E094-6500-4A08-BBD6-0F99FCB808FB",
      "comment_on_entry": "In at 3 - West Westonview",
      "comment_on_exit": "Left 3 - West Westonview",
      "entry": true,
      "exit": true,
      "status_on_entry": "in",
      "status_on_exit": "out",
      "created_at": 1739375619,
      "updated_at": 1739375619
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 2,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/beacons",
      "last_href": "http://example.org/api/v4/beacons",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1732031619,
      "beacons": 1739375619,
      "desktop_presences": 1738338819,
      "favorites": 1731426819,
      "fences": 1736178819,
      "groups": 1734969219,
      "networks": 1735142019,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null
  }
}

Update a beacon

Updates an existing beacon. Please note that if the UUID of the beacon is updated, any corresponding hardware must also be updated to broadcast the new UUID. Users must have a role that permits managing the company to update beacons.

Endpoint

PATCH /api/v4/beacons/:id

Parameters

Name Description
beacon[name] (string) the name of the beacon
beacon[uuid] (string) the unique beacon identifier
beacon[comment_on_entry] (string) the comment applied to status updates on entry, defaults to 'In at {name}'
beacon[comment_on_exit] (string) the comment applied to status updates on exit, defaults to 'Left {name}'
beacon[status_on_entry] (string) the status to apply on entry: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'in'
beacon[status_on_exit] (string) the status to apply on exit: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'out'

Request

Route

PATCH /api/v4/beacons/26069

Headers

Content-Type: application/json
Authorization: Bearer zEjgmyDWD-nzhA2xBWVfzPGv_lbRGWSEbHakgYNBsxo

Body

{
  "beacon": {
    "name": "My Renamed Office"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/beacons/26069" -d '{"beacon":{"name":"My Renamed Office"}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer zEjgmyDWD-nzhA2xBWVfzPGv_lbRGWSEbHakgYNBsxo"

Response

Simulated Response

Response Fields

Name Description
beacons (object) the newly updated beacon attributes

Status

200

Headers

ETag: W/"72a6f1f57a131d3ed178c54c29140a8f"

Body

{
  "beacons": {
    "id": "26069",
    "name": "My Renamed Office",
    "uuid": "EF1CB2EB-2539-4C34-A32F-FA77635DB234",
    "comment_on_entry": "In at 4 - East Felishaborough",
    "comment_on_exit": "Left 4 - East Felishaborough",
    "entry": true,
    "exit": true,
    "status_on_entry": "in",
    "status_on_exit": "out",
    "created_at": 1739375619,
    "updated_at": 1739375619
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1734710019,
      "beacons": 1739375619,
      "desktop_presences": 1739116419,
      "favorites": 1735574019,
      "fences": 1735055619,
      "groups": 1733241219,
      "networks": 1738252419,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null
  }
}

Companies

Retrieve the current company

Return the company the authorized user belongs to.

Endpoint

GET /api/v4/companies/my

Parameters

Name Description
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'billing', 'beacons', 'fences', 'groups', 'favorites', 'networks', 'roles'

Request

Route

GET /api/v4/companies/my

Headers

Content-Type: application/json
Authorization: Bearer 7E-SqnHxK0Xnk3KAbn6csOzGr58qrfem04XNzJKYIdw

cURL

curl -g "https://www.simpleinout.com/api/v4/companies/my" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer 7E-SqnHxK0Xnk3KAbn6csOzGr58qrfem04XNzJKYIdw"

Response

Simulated Response

Response Fields

Name Description
companies[name] (string) the authorized user's company name
companies[logo_url] (string) url of an image to be used as a fullscreen logo
companies[default_role_id] (string) the unique identifier for the default role
companies[scheduled_statuses] (boolean) whether Scheduled Statuses feature is enabled
companies[available_statuses] (array) the statuses that are available to the company
companies[created_at] (integer) epoch time the company was created

Status

200

Headers

ETag: W/"1bf6a00987c1020ff49270bfd2e38c37"
Last-Modified: Wed, 12 Feb 2025 15:53:39 GMT

Body

{
  "companies": {
    "id": "514835",
    "available_statuses": [
      "in",
      "out"
    ],
    "name": "Daniel, Schneider and Shields",
    "scheduled_statuses": true,
    "default_role_id": "2283759",
    "logo_url": null,
    "created_at": 1739375619
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1736697219,
      "beacons": 1731167619,
      "desktop_presences": 1739289219,
      "favorites": 1738425219,
      "fences": 1734969219,
      "groups": 1735228419,
      "networks": 1731945219,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null
  }
}

Futures

Delete a future status

Deletes an existing scheduled status. The company must have scheduled statuses turned on. Users must have a role that permits managing their own scheduled statuses to delete one of their scheduled statuses. Users must have a role that permits managing the scheduled statuses of others to delete another user’s scheduled status.

Endpoint

DELETE /api/v4/futures/:id

Request

Route

DELETE /api/v4/futures/30095

Headers

Content-Type: application/json
Authorization: Bearer looQGY_McSC7OyAJRy7ugjYKL5MRfAzUJNdGb4YQY98

cURL

curl "https://www.simpleinout.com/api/v4/futures/30095" -d '' -X DELETE \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer looQGY_McSC7OyAJRy7ugjYKL5MRfAzUJNdGb4YQY98"

Response

Simulated Response

Status

204

List future statuses

List all the scheduled statuses. The company must have scheduled statuses turned on. Users must have a role that permits viewing the scheduled statuses of others or only the authorized user’s scheduled statuses will be returned.

Endpoint

GET /api/v4/futures

Parameters

Name Description
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results
status (string) the status: 'in', 'remote', 'busy', 'break', 'out', 'sick', or 'vacation'
comment (string) the comment, case sensitive, included with the status change
apply_at (string) a date range string for the time this status will be added
user_id (string) the ID of a particular user
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'apply_at', 'status', 'comment'"
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'changed_by_user'

Request

Route

GET /api/v4/futures

Headers

Content-Type: application/json
Authorization: Bearer Cc9NP8EYJM8on4OQ_v9JoQXdsIuB7uRMPXL-l5xkGDw

cURL

curl -g "https://www.simpleinout.com/api/v4/futures" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer Cc9NP8EYJM8on4OQ_v9JoQXdsIuB7uRMPXL-l5xkGDw"

Response

Simulated Response

Response Fields

Name Description
futures (array) an array of matching future statuses

Status

200

Headers

ETag: W/"1ec1dc113e52a55d6639c7a30f2d6771"
Last-Modified: Wed, 12 Feb 2025 15:53:37 GMT

Body

{
  "futures": [
    {
      "id": "30093",
      "status": "out",
      "comment": "On Vacation, back Monday",
      "completed": false,
      "apply_at": 1741788000,
      "end_at": 1742220000,
      "user_id": "941679",
      "changed_by_user_id": null
    },
    {
      "id": "30094",
      "status": "out",
      "comment": "At the conference this week",
      "completed": false,
      "apply_at": 1755007200,
      "end_at": null,
      "user_id": "941679",
      "changed_by_user_id": null
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 2,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/futures",
      "last_href": "http://example.org/api/v4/futures",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1737993217,
      "beacons": 1735314817,
      "desktop_presences": 1732636417,
      "favorites": 1732722817,
      "fences": 1734796417,
      "groups": 1732722817,
      "networks": 1736006017,
      "roles": 1739375617,
      "settings": 1739375617
    },
    "emergency": null
  }
}

Geofences

Create a fence

Creates a new fence. Once this fence is created, it will appear in the company’s fences within the Simple In/Out apps and website. Users must have a role that permits managing the company to create fences. Companies are limited to 150 Geofences.

Endpoint

POST /api/v4/fences

Parameters

Name Description
fence[name] required (string) the name of the fence
fence[latitude] required (float) the latitude of the center point of the fence
fence[longitude] required (float) the longitude of the center point of the fence
fence[radius] required (integer) the radius of the fence, in meters
fence[comment_on_entry] (string) the comment applied to status updates on entry, defaults to 'In at {name}'
fence[comment_on_exit] (string) the comment applied to status updates on exit, defaults to 'Left {name}'
fence[status_on_entry] (string) the status to apply on entry: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'in'
fence[status_on_exit] (string) the status to apply on exit: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'out'

Request

Route

POST /api/v4/fences

Headers

Content-Type: application/json
Authorization: Bearer FKBz7_XU7CLo6RxcvLCtHk2_ReWrqyBOFBTcbNFxlBw

Body

{
  "fence": {
    "name": "My Office",
    "latitude": 46.877931,
    "longitude": -96.787459,
    "radius": 150
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/fences" -d '{"fence":{"name":"My Office","latitude":46.877931,"longitude":-96.787459,"radius":150}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer FKBz7_XU7CLo6RxcvLCtHk2_ReWrqyBOFBTcbNFxlBw"

Response

Simulated Response

Response Fields

Name Description
fences (object) the newly created fence attributes

Status

201

Headers

ETag: W/"b91d8b601590495d38593529e58d2e97"

Body

{
  "fences": {
    "id": "9205",
    "name": "My Office",
    "latitude": "46.877931",
    "longitude": "-96.787459",
    "radius": 150,
    "comment_on_entry": "In at My Office",
    "comment_on_exit": "Left My Office",
    "entry": true,
    "exit": true,
    "status_on_entry": "in",
    "status_on_exit": "out",
    "created_at": 1739375620,
    "updated_at": 1739375620
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1732636420,
      "beacons": 1739030020,
      "desktop_presences": 1737215620,
      "favorites": 1737820420,
      "fences": 1739375620,
      "groups": 1732895620,
      "networks": 1732895620,
      "roles": 1739375620,
      "settings": 1739375620
    },
    "emergency": null
  }
}

Delete a fence

Deletes an existing fence. Users must have a role that permits managing the company to delete fences.

Endpoint

DELETE /api/v4/fences/:id

Request

Route

DELETE /api/v4/fences/9203

Headers

Content-Type: application/json
Authorization: Bearer yiuWlby80luFgDnKxiyFPsbPtpoNcElsKadYH_TH3gI

cURL

curl "https://www.simpleinout.com/api/v4/fences/9203" -d '' -X DELETE \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer yiuWlby80luFgDnKxiyFPsbPtpoNcElsKadYH_TH3gI"

Response

Simulated Response

Status

204

List all fences

Return a list of all the fences belonging to the company.

Endpoint

GET /api/v4/fences

Parameters

Name Description
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'name', 'radius
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results

Request

Route

GET /api/v4/fences

Headers

Content-Type: application/json
Authorization: Bearer pnXTlBPVnW-YxbfHvEEATR42SvHYTkLbTIo13emZ698

cURL

curl -g "https://www.simpleinout.com/api/v4/fences" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer pnXTlBPVnW-YxbfHvEEATR42SvHYTkLbTIo13emZ698"

Response

Simulated Response

Response Fields

Name Description
fences (array) an array of fences

Status

200

Headers

ETag: W/"e1c01a8243c08c986919deafdb0fd1e3"
Last-Modified: Wed, 12 Feb 2025 15:53:40 GMT

Body

{
  "fences": [
    {
      "id": "9206",
      "name": "3 - New Wilfredo",
      "latitude": "-47.0642475029",
      "longitude": "73.420999787",
      "radius": 8027,
      "comment_on_entry": "In at 3 - New Wilfredo",
      "comment_on_exit": "Left 3 - New Wilfredo",
      "entry": true,
      "exit": true,
      "status_on_entry": "in",
      "status_on_exit": "out",
      "created_at": 1739375620,
      "updated_at": 1739375620
    },
    {
      "id": "9207",
      "name": "4 - East Londa",
      "latitude": "-22.0226639949",
      "longitude": "-31.1079815617",
      "radius": 17318,
      "comment_on_entry": "In at 4 - East Londa",
      "comment_on_exit": "Left 4 - East Londa",
      "entry": true,
      "exit": true,
      "status_on_entry": "in",
      "status_on_exit": "out",
      "created_at": 1739375620,
      "updated_at": 1739375620
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 2,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/fences",
      "last_href": "http://example.org/api/v4/fences",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1733241220,
      "beacons": 1735228420,
      "desktop_presences": 1730822020,
      "favorites": 1739116420,
      "fences": 1739375620,
      "groups": 1734191620,
      "networks": 1732550020,
      "roles": 1739375620,
      "settings": 1739375620
    },
    "emergency": null
  }
}

Update a fence

Updates an existing fence. Users must have a role that permits managing the company to update fences.

Endpoint

PATCH /api/v4/fences/:id

Parameters

Name Description
fence[name] (string) the name of the fence
fence[latitude] (float) the latitude of the center point of the fence
fence[longitude] (float) the longitude of the center point of the fence
fence[radius] (integer) the radius of the fence, in meters
fence[comment_on_entry] (string) the comment applied to status updates on entry, defaults to 'In at {name}'
fence[comment_on_exit] (string) the comment applied to status updates on exit, defaults to 'Left {name}'
fence[status_on_entry] (string) the status to apply on entry: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'in'
fence[status_on_exit] (string) the status to apply on exit: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'out'

Request

Route

PATCH /api/v4/fences/9204

Headers

Content-Type: application/json
Authorization: Bearer u79OV1pFdYU5DE6yCVBZGQ3dmgSZq0_xaq_Y9nBHLqg

Body

{
  "fence": {
    "name": "My Renamed Geofence"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/fences/9204" -d '{"fence":{"name":"My Renamed Geofence"}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer u79OV1pFdYU5DE6yCVBZGQ3dmgSZq0_xaq_Y9nBHLqg"

Response

Simulated Response

Response Fields

Name Description
fences (object) the newly updated fence attributes

Status

200

Headers

ETag: W/"26ef8bf0e377dc3c8015fee2fc07fb09"

Body

{
  "fences": {
    "id": "9204",
    "name": "My Renamed Geofence",
    "latitude": "45.5289315599",
    "longitude": "135.408680416",
    "radius": 12688,
    "comment_on_entry": "In at 2 - West Edton",
    "comment_on_exit": "Left 2 - West Edton",
    "entry": true,
    "exit": true,
    "status_on_entry": "in",
    "status_on_exit": "out",
    "created_at": 1739375620,
    "updated_at": 1739375620
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1738684420,
      "beacons": 1734450820,
      "desktop_presences": 1738857220,
      "favorites": 1734710020,
      "fences": 1739375620,
      "groups": 1731167620,
      "networks": 1738338820,
      "roles": 1739375620,
      "settings": 1739375620
    },
    "emergency": null
  }
}

Groups

Create a group

Creates a new group. Once this group is created, it will appear in the company’s groups within the Simple In/Out apps and website. Users must have a role that permits managing groups/memberships to create groups. Companies are limited to 100 Groups.

Endpoint

POST /api/v4/groups

Parameters

Name Description
group[name] required (string) the name of the group

Request

Route

POST /api/v4/groups

Headers

Content-Type: application/json
Authorization: Bearer YxsflFIR-lb2XDvJvWqOtANyUESIovJxp7oSkrmrecs

Body

{
  "group": {
    "name": "New Department"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/groups" -d '{"group":{"name":"New Department"}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer YxsflFIR-lb2XDvJvWqOtANyUESIovJxp7oSkrmrecs"

Response

Simulated Response

Response Fields

Name Description
groups (object) the newly created group attributes

Status

201

Headers

ETag: W/"5227d33ab69efd82af7b5e5769663578"

Body

{
  "groups": {
    "id": "58604",
    "name": "New Department"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1734969217,
      "beacons": 1736956417,
      "desktop_presences": 1733846017,
      "favorites": 1734450817,
      "fences": 1733241217,
      "groups": 1739375617,
      "networks": 1733327617,
      "roles": 1739375617,
      "settings": 1739375617
    },
    "emergency": null
  }
}

Delete a group

Deletes an existing group. Users must have a role that permits managing groups/memberships to delete groups.

Endpoint

DELETE /api/v4/groups/:id

Request

Route

DELETE /api/v4/groups/58605

Headers

Content-Type: application/json
Authorization: Bearer ye4G8Ka38s0H7Fdo-i5gf6er6JHz1C96tuoBD0rQu0Y

cURL

curl "https://www.simpleinout.com/api/v4/groups/58605" -d '' -X DELETE \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer ye4G8Ka38s0H7Fdo-i5gf6er6JHz1C96tuoBD0rQu0Y"

Response

Simulated Response

Status

204

List all groups

Return a list of all the groups belonging to the company.

Endpoint

GET /api/v4/groups

Parameters

Name Description
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'name'
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results

Request

Route

GET /api/v4/groups

Headers

Content-Type: application/json
Authorization: Bearer JyauTHR5jpoW_cJEWBzKcX7058l0mBhCp9GGckb4PMQ

cURL

curl -g "https://www.simpleinout.com/api/v4/groups" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer JyauTHR5jpoW_cJEWBzKcX7058l0mBhCp9GGckb4PMQ"

Response

Simulated Response

Response Fields

Name Description
groups (array) an array of groups

Status

200

Headers

ETag: W/"95bae87284e8a2115c7cb9bd0cbe50af"
Last-Modified: Wed, 12 Feb 2025 15:53:37 GMT

Body

{
  "groups": [
    {
      "id": "58606",
      "name": "Walsh, Kuhic and Osinski4"
    },
    {
      "id": "58607",
      "name": "Blick-Hayes5"
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 2,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/groups",
      "last_href": "http://example.org/api/v4/groups",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1739030017,
      "beacons": 1732895617,
      "desktop_presences": 1735487617,
      "favorites": 1739116417,
      "fences": 1733068417,
      "groups": 1739375617,
      "networks": 1733327617,
      "roles": 1739375617,
      "settings": 1739375617
    },
    "emergency": null
  }
}

Update a group

Updates an existing group. Users must have a role that permits managing groups/memberships to update groups.

Endpoint

PATCH /api/v4/groups/:id

Parameters

Name Description
group[name] (string) the name of the group

Request

Route

PATCH /api/v4/groups/58603

Headers

Content-Type: application/json
Authorization: Bearer j4WU2YaBJbsqJeNjqkJASrNMV2KHjVj9kj5b3vn7z64

Body

{
  "group": {
    "name": "Renamed Department"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/groups/58603" -d '{"group":{"name":"Renamed Department"}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer j4WU2YaBJbsqJeNjqkJASrNMV2KHjVj9kj5b3vn7z64"

Response

Simulated Response

Response Fields

Name Description
groups (object) the newly updated group attributes

Status

200

Headers

ETag: W/"73a39cc8b3b5836062cdffa13e49e3ea"

Body

{
  "groups": {
    "id": "58603",
    "name": "Renamed Department"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1736870017,
      "beacons": 1731340417,
      "desktop_presences": 1737993217,
      "favorites": 1734710017,
      "fences": 1732118017,
      "groups": 1739375617,
      "networks": 1732982017,
      "roles": 1739375617,
      "settings": 1739375617
    },
    "emergency": null
  }
}

Networks

Create a network

Creates a new network. Once this network is created, it will appear in the company’s networks within the Simple In/Out apps. Users must have a role that permits managing the company to create networks. Companies are limited to 100 Networks.

Endpoint

POST /api/v4/networks

Parameters

Name Description
network[name] required (string) the name of the network, no longer than 44 characters
network[ssid] required (string) the unique network identifier, no longer than 250 characters
network[comment_on_entry] (string) the comment applied to status updates on entry, defaults to 'In at {name}'
network[comment_on_exit] (string) the comment applied to status updates on exit, defaults to 'Left {name}'
network[status_on_entry] (string) the status to apply on entry: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'in'
network[status_on_exit] (string) the status to apply on exit: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'out'

Request

Route

POST /api/v4/networks

Headers

Content-Type: application/json
Authorization: Bearer ANsLkLY-PGe0bVd1PFZLQ0vF95VH9wcddxv8W0UBqgY

Body

{
  "network": {
    "name": "My Office",
    "ssid": "Office WiFi Hotspot"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/networks" -d '{"network":{"name":"My Office","ssid":"Office WiFi Hotspot"}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer ANsLkLY-PGe0bVd1PFZLQ0vF95VH9wcddxv8W0UBqgY"

Response

Simulated Response

Response Fields

Name Description
networks (object) the newly created network attributes

Status

201

Headers

ETag: W/"5de24d71e3251a7d083167c7590795a3"

Body

{
  "networks": {
    "id": "8449",
    "name": "My Office",
    "ssid": "Office WiFi Hotspot",
    "comment_on_entry": "In at My Office",
    "comment_on_exit": "Left My Office",
    "entry": true,
    "exit": true,
    "status_on_entry": "in",
    "status_on_exit": "out",
    "created_at": 1739375620,
    "updated_at": 1739375620
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1737302019,
      "beacons": 1732204419,
      "desktop_presences": 1735401219,
      "favorites": 1732290819,
      "fences": 1732636419,
      "groups": 1732895619,
      "networks": 1739375620,
      "roles": 1739375620,
      "settings": 1739375620
    },
    "emergency": null
  }
}

Delete a network

Deletes an existing network. Users must have a role that permits managing the company to delete networks.

Endpoint

DELETE /api/v4/networks/:id

Request

Route

DELETE /api/v4/networks/8450

Headers

Content-Type: application/json
Authorization: Bearer nNkIBkYbpiSANOKiWpxPWkh2ln_QYoWMXEChY31h4NM

cURL

curl "https://www.simpleinout.com/api/v4/networks/8450" -d '' -X DELETE \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer nNkIBkYbpiSANOKiWpxPWkh2ln_QYoWMXEChY31h4NM"

Response

Simulated Response

Status

204

List all networks

Return a list of all the networks belonging to the company.

Endpoint

GET /api/v4/networks

Parameters

Name Description
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'name'
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results

Request

Route

GET /api/v4/networks

Headers

Content-Type: application/json
Authorization: Bearer zGvFn5YKFf84q7lEan-Nm4ezYKNpOnkfU5ukUDyQNw0

cURL

curl -g "https://www.simpleinout.com/api/v4/networks" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer zGvFn5YKFf84q7lEan-Nm4ezYKNpOnkfU5ukUDyQNw0"

Response

Simulated Response

Response Fields

Name Description
networks (array) an array of networks

Status

200

Headers

ETag: W/"5da3c87f02fef54724383d885e984cbb"
Last-Modified: Wed, 12 Feb 2025 15:53:40 GMT

Body

{
  "networks": [
    {
      "id": "8451",
      "name": "3 - East Bobshire",
      "ssid": "nhnz4zyavbjyd8w8vyi0xsd110nuub95",
      "comment_on_entry": "In at 3 - East Bobshire",
      "comment_on_exit": "Left 3 - East Bobshire",
      "entry": true,
      "exit": true,
      "status_on_entry": "in",
      "status_on_exit": "out",
      "created_at": 1739375620,
      "updated_at": 1739375620
    },
    {
      "id": "8452",
      "name": "4 - Heribertoshire",
      "ssid": "gbjijy6lw92njhh511siihl7xhy9r9y4",
      "comment_on_entry": "In at 4 - Heribertoshire",
      "comment_on_exit": "Left 4 - Heribertoshire",
      "entry": true,
      "exit": true,
      "status_on_entry": "in",
      "status_on_exit": "out",
      "created_at": 1739375620,
      "updated_at": 1739375620
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 2,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/networks",
      "last_href": "http://example.org/api/v4/networks",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1733068420,
      "beacons": 1738079620,
      "desktop_presences": 1738511620,
      "favorites": 1733586820,
      "fences": 1736870020,
      "groups": 1731686020,
      "networks": 1739375620,
      "roles": 1739375620,
      "settings": 1739375620
    },
    "emergency": null
  }
}

Update a network

Updates an existing network. Please note that if the SSID of the network is updated, any corresponding hardware must also be updated to broadcast the new SSID. Users must have a role that permits managing the company to update networks.

Endpoint

PATCH /api/v4/networks/:id

Parameters

Name Description
network[name] (string) the name of the network, no longer than 44 characters
network[ssid] (string) the unique network identifier, no longer than 250 characters
network[comment_on_entry] (string) the comment applied to status updates on entry, defaults to 'In at {name}'
network[comment_on_exit] (string) the comment applied to status updates on exit, defaults to 'Left {name}'
network[status_on_entry] (string) the status to apply on entry: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'in'
network[status_on_exit] (string) the status to apply on exit: 'in', 'remote', 'busy', 'break', 'out', 'sick', 'vacation', or 'off', defaults to 'out'

Request

Route

PATCH /api/v4/networks/8448

Headers

Content-Type: application/json
Authorization: Bearer bua2bwecg1kShZ1FteXPaJw2Uf47Kw8oSgdq7OeOq7U

Body

{
  "network": {
    "name": "My Renamed Office"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/networks/8448" -d '{"network":{"name":"My Renamed Office"}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer bua2bwecg1kShZ1FteXPaJw2Uf47Kw8oSgdq7OeOq7U"

Response

Simulated Response

Response Fields

Name Description
networks (object) the newly updated network attributes

Status

200

Headers

ETag: W/"7799d64a5d0bf9855360303678d34b07"

Body

{
  "networks": {
    "id": "8448",
    "name": "My Renamed Office",
    "ssid": "fqlm1qhbfv2p9bjjeouyr68ncrafslmq",
    "comment_on_entry": "In at 1 - Teshaton",
    "comment_on_exit": "Left 1 - Teshaton",
    "entry": true,
    "exit": true,
    "status_on_entry": "in",
    "status_on_exit": "out",
    "created_at": 1739375619,
    "updated_at": 1739375619
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1734278019,
      "beacons": 1731599619,
      "desktop_presences": 1730994819,
      "favorites": 1736351619,
      "fences": 1732550019,
      "groups": 1732722819,
      "networks": 1739375619,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null
  }
}

Ok

Make sure things are Ok

This API is only used to verify you’ve successfully authorized.

Endpoint

GET /api/v4/ok

Parameters

Name Description
meta (string) if any value included, will return meta information instead of a 204 No Content response

Request

Route

GET /api/v4/ok

Headers

Content-Type: application/json
Authorization: Bearer AvK_o8fiiNKicmhrs6xfNlPIJ8_eRfk6OZ08KNMSFTw

cURL

curl -g "https://www.simpleinout.com/api/v4/ok" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer AvK_o8fiiNKicmhrs6xfNlPIJ8_eRfk6OZ08KNMSFTw"

Response

Simulated Response

Status

204

Roles

Create a role

Creates a new role. Once this role is created, it will be available to assign to users within the Simple In/Out apps and website. Users must have a role that permits managing the company to create roles. Companies are limited to 100 Roles.

Endpoint

POST /api/v4/roles

Parameters

Name Description
role[name] required (string) the name of the role, no longer than 255 characters, must be unique for the company
role[billing] (boolean) these users can change the company's plan, credit card, and invoice email/information.
role[followed_users] (boolean) these users can receive notifications on their devices when another user updates their status.
role[reminders] (boolean) these users can manage notifications sent to other users reminding them to update their status.
role[safeties] (boolean) these users can receive notifications when another user hasn't updated their status.
role[user_board] (boolean) these users can see all other users and their current status.
role[manage_groups_and_memberships] (boolean) these users can manage groups and which users are assigned to each group.
role[manage_others_archives] (boolean) these users can change the past statuses of all others by adding and deleting status updates.
role[manage_others_futures] (boolean) these users can schedule future status updates for all other users.
role[manage_others_status] (boolean) these users can change the current status of all users.
role[manage_own_archives] (boolean) these users can change their own past statuses by adding and deleting status updates.
role[manage_own_futures] (boolean) these users can schedule future status updates for themselves.
role[manage_own_status] (boolean) these users can update their own status from any device or the website. If a user is not allowed to update their own status, they can only update their status from a common device running FrontDesk or TimeClock.
role[view_others_archives] (boolean) these users can view the past status updates made by all other users.
role[view_others_futures] (boolean) these users can view the scheduled status updates for all users.
role[view_others_reports] (boolean) these users can run reports on the status history of all other users.
role[view_user_board_updated_at] (boolean) these users can view the time that status updates were made on the board.
role[member_board] (boolean) these users can see other users within the same groups and their current status.
role[manage_member_archives] (boolean) these users can change the past statuses of users within the same groups by adding and deleting status updates.
role[manage_member_futures] (boolean) these users can schedule future status updates for users within the same groups.
role[manage_member_status] (boolean) these users can change the current status of users within the same groups.
role[view_member_archives] (boolean) these users can view the past status updates made by users within the same groups.
role[view_member_futures] (boolean) these users can view the scheduled status updates for users within the same groups.
role[view_member_reports] (boolean) these users can run reports on the status history of users within the same groups.

Request

Route

POST /api/v4/roles

Headers

Content-Type: application/json
Authorization: Bearer dgnIvHMMBGpQ-I3wUStBK1FkB_hr4Dn0Yk_QgyMNWUM

Body

{
  "role": {
    "name": "Billing Role",
    "billing": true,
    "followed_users": false,
    "reminders": false,
    "safeties": false,
    "user_board": false,
    "manage_groups_and_memberships": false,
    "manage_others_archives": false,
    "manage_others_futures": false,
    "manage_others_status": false,
    "manage_own_archives": false,
    "manage_own_futures": false,
    "manage_own_status": false,
    "view_others_archives": false,
    "view_others_futures": false,
    "view_others_reports": false,
    "view_user_board_updated_at": false,
    "member_board": false,
    "manage_member_archives": false,
    "manage_member_futures": false,
    "manage_member_status": false,
    "view_member_archives": false,
    "view_member_futures": false,
    "view_member_reports": false
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/roles" -d '{"role":{"name":"Billing Role","billing":true,"followed_users":false,"reminders":false,"safeties":false,"user_board":false,"manage_groups_and_memberships":false,"manage_others_archives":false,"manage_others_futures":false,"manage_others_status":false,"manage_own_archives":false,"manage_own_futures":false,"manage_own_status":false,"view_others_archives":false,"view_others_futures":false,"view_others_reports":false,"view_user_board_updated_at":false,"member_board":false,"manage_member_archives":false,"manage_member_futures":false,"manage_member_status":false,"view_member_archives":false,"view_member_futures":false,"view_member_reports":false}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer dgnIvHMMBGpQ-I3wUStBK1FkB_hr4Dn0Yk_QgyMNWUM"

Response

Simulated Response

Response Fields

Name Description
roles (object) the newly created role attributes

Status

201

Headers

ETag: W/"81e5d72b83edf3434f5fffcc49f902f9"

Body

{
  "roles": {
    "id": "2283800",
    "name": "Billing Role",
    "billing": true,
    "followed_users": false,
    "reminders": false,
    "safeties": false,
    "user_board": false,
    "manage_company_and_users": false,
    "manage_groups_and_memberships": false,
    "manage_others_archives": false,
    "manage_others_futures": false,
    "manage_others_status": false,
    "manage_own_archives": false,
    "manage_own_futures": false,
    "manage_own_status": false,
    "view_others_archives": false,
    "view_others_futures": false,
    "view_others_reports": false,
    "member_board": false,
    "manage_member_archives": false,
    "manage_member_futures": false,
    "manage_member_status": false,
    "view_member_archives": false,
    "view_member_futures": false,
    "view_member_reports": false,
    "view_user_board_updated_at": false,
    "created_at": 1739375619,
    "updated_at": 1739375619
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1736438019,
      "beacons": 1736092419,
      "desktop_presences": 1733673219,
      "favorites": 1730822019,
      "fences": 1738252419,
      "groups": 1735401219,
      "networks": 1737042819,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null
  }
}

Delete a role

Deletes an existing role. Users must have a role that permits managing the company to delete roles.

Endpoint

DELETE /api/v4/roles/:id

Request

Route

DELETE /api/v4/roles/2283790

Headers

Content-Type: application/json
Authorization: Bearer GkqqInXUZ8BBdACJ_CgWRIwICheXf8ZqIq84tLtIcXM

cURL

curl "https://www.simpleinout.com/api/v4/roles/2283790" -d '' -X DELETE \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer GkqqInXUZ8BBdACJ_CgWRIwICheXf8ZqIq84tLtIcXM"

Response

Simulated Response

Status

204

List all roles

Return a list of all the roles belonging to the company.

Endpoint

GET /api/v4/roles

Parameters

Name Description
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'name'
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results

Request

Route

GET /api/v4/roles

Headers

Content-Type: application/json
Authorization: Bearer Js6m9HV9esTBhAdnNJtGijysPNXyEoB9oyuelYWLaPE

cURL

curl -g "https://www.simpleinout.com/api/v4/roles" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer Js6m9HV9esTBhAdnNJtGijysPNXyEoB9oyuelYWLaPE"

Response

Simulated Response

Response Fields

Name Description
roles (array) an array of roles

Status

200

Headers

ETag: W/"03263d5cb9b754048197db3cfb6f9525"
Last-Modified: Wed, 12 Feb 2025 15:53:39 GMT

Body

{
  "roles": [
    {
      "id": "2283778",
      "name": "Manager",
      "billing": false,
      "followed_users": false,
      "reminders": false,
      "safeties": false,
      "user_board": true,
      "manage_company_and_users": false,
      "manage_groups_and_memberships": false,
      "manage_others_archives": false,
      "manage_others_futures": true,
      "manage_others_status": true,
      "manage_own_archives": false,
      "manage_own_futures": true,
      "manage_own_status": true,
      "view_others_archives": true,
      "view_others_futures": true,
      "view_others_reports": true,
      "member_board": false,
      "manage_member_archives": false,
      "manage_member_futures": false,
      "manage_member_status": false,
      "view_member_archives": false,
      "view_member_futures": false,
      "view_member_reports": false,
      "view_user_board_updated_at": true,
      "created_at": 1739375619,
      "updated_at": 1739375619
    },
    {
      "id": "2283780",
      "name": "Limited User",
      "billing": false,
      "followed_users": false,
      "reminders": false,
      "safeties": false,
      "user_board": true,
      "manage_company_and_users": false,
      "manage_groups_and_memberships": false,
      "manage_others_archives": false,
      "manage_others_futures": false,
      "manage_others_status": false,
      "manage_own_archives": false,
      "manage_own_futures": false,
      "manage_own_status": false,
      "view_others_archives": true,
      "view_others_futures": true,
      "view_others_reports": false,
      "member_board": false,
      "manage_member_archives": false,
      "manage_member_futures": false,
      "manage_member_status": false,
      "view_member_archives": false,
      "view_member_futures": false,
      "view_member_reports": false,
      "view_user_board_updated_at": true,
      "created_at": 1739375619,
      "updated_at": 1739375619
    },
    {
      "id": "2283777",
      "name": "Administrator",
      "billing": true,
      "followed_users": true,
      "reminders": true,
      "safeties": true,
      "user_board": true,
      "manage_company_and_users": true,
      "manage_groups_and_memberships": true,
      "manage_others_archives": true,
      "manage_others_futures": true,
      "manage_others_status": true,
      "manage_own_archives": true,
      "manage_own_futures": true,
      "manage_own_status": true,
      "view_others_archives": true,
      "view_others_futures": true,
      "view_others_reports": true,
      "member_board": false,
      "manage_member_archives": false,
      "manage_member_futures": false,
      "manage_member_status": false,
      "view_member_archives": false,
      "view_member_futures": false,
      "view_member_reports": false,
      "view_user_board_updated_at": true,
      "created_at": 1739375619,
      "updated_at": 1739375619
    },
    {
      "id": "2283779",
      "name": "Regular User",
      "billing": false,
      "followed_users": false,
      "reminders": false,
      "safeties": false,
      "user_board": true,
      "manage_company_and_users": false,
      "manage_groups_and_memberships": false,
      "manage_others_archives": false,
      "manage_others_futures": false,
      "manage_others_status": false,
      "manage_own_archives": false,
      "manage_own_futures": true,
      "manage_own_status": true,
      "view_others_archives": true,
      "view_others_futures": true,
      "view_others_reports": false,
      "member_board": false,
      "manage_member_archives": false,
      "manage_member_futures": false,
      "manage_member_status": false,
      "view_member_archives": false,
      "view_member_futures": false,
      "view_member_reports": false,
      "view_user_board_updated_at": true,
      "created_at": 1739375619,
      "updated_at": 1739375619
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 4,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/roles",
      "last_href": "http://example.org/api/v4/roles",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1739375619,
      "beacons": 1738425219,
      "desktop_presences": 1733154819,
      "favorites": 1737042819,
      "fences": 1739202819,
      "groups": 1736610819,
      "networks": 1732636419,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null
  }
}

Retrieve a role

Retrieve an existing role.

Endpoint

GET /api/v4/roles/:id

Request

Route

GET /api/v4/roles/2283785

Headers

Content-Type: application/json
Authorization: Bearer SDavz7rjnVC3X-nSH9tg--m24X-__XShsqO1bidzskk

cURL

curl -g "https://www.simpleinout.com/api/v4/roles/2283785" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Sio-Version: 1.0.0" \
	-H "Authorization: Bearer SDavz7rjnVC3X-nSH9tg--m24X-__XShsqO1bidzskk"

Response

Simulated Response

Response Fields

Name Description
roles (object) the role attributes

Status

200

Headers

ETag: W/"80209bca7627ca1fc5d4760862c987c0"
Last-Modified: Wed, 12 Feb 2025 15:53:39 GMT

Body

{
  "roles": {
    "id": "2283785",
    "name": "Bogan Inc",
    "billing": false,
    "followed_users": false,
    "reminders": false,
    "safeties": false,
    "user_board": false,
    "manage_company_and_users": false,
    "manage_groups_and_memberships": false,
    "manage_others_archives": false,
    "manage_others_futures": false,
    "manage_others_status": false,
    "manage_own_archives": false,
    "manage_own_futures": false,
    "manage_own_status": false,
    "view_others_archives": false,
    "view_others_futures": false,
    "view_others_reports": false,
    "member_board": false,
    "manage_member_archives": false,
    "manage_member_futures": false,
    "manage_member_status": false,
    "view_member_archives": false,
    "view_member_futures": false,
    "view_member_reports": false,
    "view_user_board_updated_at": false,
    "created_at": 1739375619,
    "updated_at": 1739375619
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1734623619,
      "beacons": 1732463619,
      "desktop_presences": 1736178819,
      "favorites": 1730908419,
      "fences": 1735055619,
      "groups": 1732204419,
      "networks": 1734882819,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null,
    "update_available": false
  }
}

Update a role

Updates an existing role. Users must have a role that permits managing the company to update roles.

Endpoint

PATCH /api/v4/roles/:id

Parameters

Name Description
role[name] (string) the name of the role, no longer than 255 characters, must be unique for the company
role[billing] (boolean) these users can change the company's plan, credit card, and invoice email/information.
role[followed_users] (boolean) these users can receive notifications on their devices when another user updates their status.
role[reminders] (boolean) these users can manage notifications sent to other users reminding them to update their status.
role[safeties] (boolean) these users can receive notifications when another user hasn't updated their status.
role[user_board] (boolean) these users can see all other users and their current status.
role[manage_groups_and_memberships] (boolean) these users can manage groups and which users are assigned to each group.
role[manage_others_archives] (boolean) these users can change the past statuses of all others by adding and deleting status updates.
role[manage_others_futures] (boolean) these users can schedule future status updates for all other users.
role[manage_others_status] (boolean) these users can change the current status of all users.
role[manage_own_archives] (boolean) these users can change their own past statuses by adding and deleting status updates.
role[manage_own_futures] (boolean) these users can schedule future status updates for themselves.
role[manage_own_status] (boolean) these users can update their own status from any device or the website. If a user is not allowed to update their own status, they can only update their status from a common device running FrontDesk or TimeClock.
role[view_others_archives] (boolean) these users can view the past status updates made by all other users.
role[view_others_futures] (boolean) these users can view the scheduled status updates for all users.
role[view_others_reports] (boolean) these users can run reports on the status history of all other users.
role[view_user_board_updated_at] (boolean) these users can view the time that status updates were made on the board.
role[member_board] (boolean) these users can see other users within the same groups and their current status.
role[manage_member_archives] (boolean) these users can change the past statuses of users within the same groups by adding and deleting status updates.
role[manage_member_futures] (boolean) these users can schedule future status updates for users within the same groups.
role[manage_member_status] (boolean) these users can change the current status of users within the same groups.
role[view_member_archives] (boolean) these users can view the past status updates made by users within the same groups.
role[view_member_futures] (boolean) these users can view the scheduled status updates for users within the same groups.
role[view_member_reports] (boolean) these users can run reports on the status history of users within the same groups.

Request

Route

PATCH /api/v4/roles/2283795

Headers

Content-Type: application/json
Authorization: Bearer zNr6LNi5xPJd4uJFTND4U8HLsfLPhhwisQc_Szxs0GA

Body

{
  "role": {
    "name": "My Renamed Role",
    "billing": false,
    "view_others_archives": true,
    "view_others_futures": true
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/roles/2283795" -d '{"role":{"name":"My Renamed Role","billing":false,"view_others_archives":true,"view_others_futures":true}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer zNr6LNi5xPJd4uJFTND4U8HLsfLPhhwisQc_Szxs0GA"

Response

Simulated Response

Response Fields

Name Description
roles (object) the newly updated role attributes

Status

200

Headers

ETag: W/"f0fd729aa919ffb1146f3f30f5a551ae"

Body

{
  "roles": {
    "id": "2283795",
    "name": "My Renamed Role",
    "billing": false,
    "followed_users": false,
    "reminders": false,
    "safeties": false,
    "user_board": false,
    "manage_company_and_users": false,
    "manage_groups_and_memberships": false,
    "manage_others_archives": false,
    "manage_others_futures": false,
    "manage_others_status": false,
    "manage_own_archives": false,
    "manage_own_futures": false,
    "manage_own_status": false,
    "view_others_archives": true,
    "view_others_futures": true,
    "view_others_reports": false,
    "member_board": false,
    "manage_member_archives": false,
    "manage_member_futures": false,
    "manage_member_status": false,
    "view_member_archives": false,
    "view_member_futures": false,
    "view_member_reports": false,
    "view_user_board_updated_at": false,
    "created_at": 1739375619,
    "updated_at": 1739375619
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1732895619,
      "beacons": 1737734019,
      "desktop_presences": 1735401219,
      "favorites": 1737302019,
      "fences": 1736092419,
      "groups": 1736092419,
      "networks": 1731513219,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null
  }
}

Statuses

List statuses

List all the statuses within the time period specified by the ‘created_at’ date range. Users must have a role that permits viewing the status history of others or only the authorized user’s statuses will be returned.

Endpoint

GET /api/v4/statuses

Parameters

Name Description
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results
created_at required (string) a date range string for the time the status was created
status (string) the status: 'in', 'remote', 'busy', 'break', 'out', 'sick', or 'vacation'
comment (string) the comment, case sensitive, included with the status change
automatic (boolean) only find automatic statuses
user_id (string) the ID of a particular user
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'created_at', 'status', 'comment', 'automatic'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'user.favorites', 'user.latest', 'user.memberships', 'user.memberships.group', 'user.phones', 'user.recents', 'changed_by_user', 'application'

Request

Route

GET /api/v4/statuses?created_at=1738735200..1738994399

Headers

Content-Type: application/json
Authorization: Bearer hHl3J6x5FwMit-O-y1rEuZPJF96AlHh7uOkmgKgSlxo

Query Parameters

created_at=1738735200..1738994399

cURL

curl -g "https://www.simpleinout.com/api/v4/statuses?created_at=1738735200..1738994399" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer hHl3J6x5FwMit-O-y1rEuZPJF96AlHh7uOkmgKgSlxo"

Response

Simulated Response

Response Fields

Name Description
statuses (array) an array of matching statuses

Status

200

Headers

ETag: W/"092f06880366566ad1819f8d44ba736a"
Last-Modified: Thu, 06 Feb 2025 15:00:00 GMT

Body

{
  "statuses": [
    {
      "status": "in",
      "comment": "At Work",
      "automatic": false,
      "user_id": "941636",
      "changed_by_user_id": null,
      "created_at": 1738742400
    },
    {
      "status": "out",
      "comment": "Left Work",
      "automatic": true,
      "user_id": "941636",
      "changed_by_user_id": null,
      "created_at": 1738756800
    },
    {
      "status": "in",
      "comment": "At Work",
      "automatic": false,
      "user_id": "941636",
      "changed_by_user_id": null,
      "created_at": 1738760400
    },
    {
      "status": "out",
      "comment": "Left Work",
      "automatic": false,
      "user_id": "941636",
      "changed_by_user_id": null,
      "created_at": 1738778400
    },
    {
      "status": "in",
      "comment": "At Work",
      "automatic": true,
      "user_id": "941636",
      "changed_by_user_id": null,
      "created_at": 1738828800
    },
    {
      "status": "out",
      "comment": "Left Work",
      "automatic": true,
      "user_id": "941636",
      "changed_by_user_id": null,
      "created_at": 1738850400
    },
    {
      "status": "out",
      "comment": "On Vacation",
      "automatic": false,
      "user_id": "941636",
      "changed_by_user_id": "941637",
      "created_at": 1738854000
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 7,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/statuses?created_at=1738735200..1738994399",
      "last_href": "http://example.org/api/v4/statuses?created_at=1738735200..1738994399",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1739289216,
      "beacons": 1736438016,
      "desktop_presences": 1733154816,
      "favorites": 1731772416,
      "fences": 1733586816,
      "groups": 1732118016,
      "networks": 1735401216,
      "roles": 1739375616,
      "settings": 1739375616
    },
    "emergency": null
  }
}

Users

Archive a user

Archives an existing user. Users must have a role that permits managing users.

Endpoint

POST /api/v4/users/:id/archive

Request

Route

POST /api/v4/users/941783/archive

Headers

Content-Type: application/json
Authorization: Bearer Lh9t6LJMfJvqsRDW_LZWR3xZ9cvCPsBGKIC1BTZZty8

cURL

curl "https://www.simpleinout.com/api/v4/users/941783/archive" -d '' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer Lh9t6LJMfJvqsRDW_LZWR3xZ9cvCPsBGKIC1BTZZty8"

Response

Simulated Response

Status

204

Create a future status update for a user

Add a scheduled status for a specific user. Users must have a role that permits managing their own scheduled statuses if updating themselves or be permitted to manage the scheduled statuses of others if updating another user. The company must also have scheduled statuses enabled.

Endpoint

POST /api/v4/users/:id/futures

Parameters

Name Description
future[status] required (string) must be 'in', 'remote', 'busy', 'break', 'out', 'sick', or 'vacation'
future[apply_at] required (integer) epoch time to apply status change, must be in the future, have minutes within (00, 15, 30, 45), and seconds of 0
future[comment] (string) up to 50 character description of the status update
future[end_at] (integer) epoch time to end the scheduled status, must be after apply_at, have minutes within (00, 15, 30, 45), and seconds of 0
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'changed_by_user'

Request

Route

POST /api/v4/users/941702/futures

Headers

Content-Type: application/json
Authorization: Bearer r5MzsZCQ22fZc-6mcY1ww-o4UlvNH9aC0S0D0irkko0

Body

{
  "future": {
    "status": "out",
    "apply_at": 1744466400,
    "comment": "On Vacation",
    "end_at": 1744898400
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/941702/futures" -d '{"future":{"status":"out","apply_at":1744466400,"comment":"On Vacation","end_at":1744898400}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer r5MzsZCQ22fZc-6mcY1ww-o4UlvNH9aC0S0D0irkko0"

Response

Simulated Response

Response Fields

Name Description
futures (object) the newly created future object

Status

201

Headers

ETag: W/"bed90d0be0c9d84f047aad6ae81a3169"

Body

{
  "futures": {
    "id": "30096",
    "status": "out",
    "comment": "On Vacation",
    "completed": false,
    "apply_at": 1744466400,
    "end_at": 1744898400,
    "user_id": "941702",
    "changed_by_user_id": "941701"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1732982018,
      "beacons": 1738598018,
      "desktop_presences": 1732031618,
      "favorites": 1733068418,
      "fences": 1730822018,
      "groups": 1738252418,
      "networks": 1734623618,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

Create a future status update for the current user

Add a scheduled status for the current user. Users must have a role that permits managing their own scheduled statuses and the company must have scheduled statuses enabled.

Endpoint

POST /api/v4/users/my/futures

Parameters

Name Description
future[status] required (string) must be 'in', 'remote', 'busy', 'break', 'out', 'sick', or 'vacation'
future[apply_at] required (integer) epoch time to apply status change, must be in the future and have minutes within (00, 15, 30, 45), and seconds of 0
future[comment] (string) up to 50 character description of the status update
future[end_at] (integer) epoch time to end the scheduled status, must be after apply_at, have minutes within (00, 15, 30, 45), and seconds of 0
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'changed_by_user'

Request

Route

POST /api/v4/users/my/futures

Headers

Content-Type: application/json
Authorization: Bearer x9IWjKl_S6Crt-bceSm2uXUgPyDcjuxFlD3Kh9MgU3g

Body

{
  "future": {
    "status": "out",
    "apply_at": 1744466400,
    "comment": "On Vacation",
    "end_at": 1744898400
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/my/futures" -d '{"future":{"status":"out","apply_at":1744466400,"comment":"On Vacation","end_at":1744898400}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer x9IWjKl_S6Crt-bceSm2uXUgPyDcjuxFlD3Kh9MgU3g"

Response

Simulated Response

Response Fields

Name Description
futures (object) the newly created future object

Status

201

Headers

ETag: W/"61fab0e626367a400beaed506655a80a"

Body

{
  "futures": {
    "id": "30101",
    "status": "out",
    "comment": "On Vacation",
    "completed": false,
    "apply_at": 1744466400,
    "end_at": 1744898400,
    "user_id": "941726",
    "changed_by_user_id": null
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1730994818,
      "beacons": 1737302018,
      "desktop_presences": 1737129218,
      "favorites": 1735228418,
      "fences": 1731340418,
      "groups": 1731599618,
      "networks": 1737561218,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

Create a status update for a user

Changes a user’s status. Users must have a role that permits managing their own current status or their own past statuses if updating themselves. Users must be permitted to manage the current status of others or the past status of others if updating another user.

Endpoint

POST /api/v4/users/:id/statuses

Parameters

Name Description
status[status] required (string) must be 'in', 'remote', 'busy', 'break', 'out', 'sick', or 'vacation'
status[comment] (string) up to 50 character description of the status update
status[created_at] (integer) epoch time to apply status change, defaults to the current time (if this parameter is passed the date must be in the past)
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'user.favorites', 'user.latest', 'user.memberships', 'user.phones', 'user.recents', 'changed_by_user', 'application'

Request

Route

POST /api/v4/users/941691/statuses

Headers

Content-Type: application/json
Authorization: Bearer uO3m76VLJmG-Eq5aIOFm1-c7r4lxb7XpAZKr0RNyusQ

Body

{
  "status": {
    "status": "in",
    "comment": "In at HQ"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/941691/statuses" -d '{"status":{"status":"in","comment":"In at HQ"}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer uO3m76VLJmG-Eq5aIOFm1-c7r4lxb7XpAZKr0RNyusQ"

Response

Simulated Response

Response Fields

Name Description
statuses (object) the newly created status object

Status

201

Headers

ETag: W/"38cc171d6ff75bbfb2dfea29c167358a"

Body

{
  "statuses": {
    "status": "in",
    "comment": "In at HQ",
    "automatic": false,
    "user_id": "941691",
    "changed_by_user_id": "941690",
    "created_at": 1739375618
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1735746817,
      "beacons": 1733759617,
      "desktop_presences": 1737388417,
      "favorites": 1732722817,
      "fences": 1734623617,
      "groups": 1736610817,
      "networks": 1736783617,
      "roles": 1739375617,
      "settings": 1739375617
    },
    "emergency": null
  }
}

Create a status update for the current user

Changes the current user’s status. Users must have a role that permits managing their own current status or their own past statuses.

Endpoint

POST /api/v4/users/my/statuses

Parameters

Name Description
status[status] required (string) must be 'in', 'remote', 'busy', 'break', 'out', 'sick', or 'vacation'
status[comment] (st`ring) up to 50 character description of the status update
status[created_at] (integer) epoch time to apply status change, defaults to the current time (if this parameter is passed the date must be in the past)
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'user.favorites', 'user.latest', 'user.memberships', 'user.phones', 'user.recents', 'changed_by_user', 'application'

Request

Route

POST /api/v4/users/my/statuses

Headers

Content-Type: application/json
Authorization: Bearer y9-ufVpyGtiRDoLnJ1rvk4ZOXWsBbaPAJpH_C8mMFUc

Body

{
  "status": {
    "status": "in",
    "comment": "In at HQ"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/my/statuses" -d '{"status":{"status":"in","comment":"In at HQ"}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer y9-ufVpyGtiRDoLnJ1rvk4ZOXWsBbaPAJpH_C8mMFUc"

Response

Simulated Response

Response Fields

Name Description
statuses (object) the newly created status object

Status

201

Headers

ETag: W/"83eaca3591e83e65ad2c45b0bf57cf0c"

Body

{
  "statuses": {
    "status": "in",
    "comment": "In at HQ",
    "automatic": false,
    "user_id": "941737",
    "changed_by_user_id": null,
    "created_at": 1739375619
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1735919618,
      "beacons": 1731426818,
      "desktop_presences": 1734191618,
      "favorites": 1739375618,
      "fences": 1735142018,
      "groups": 1730822018,
      "networks": 1731167618,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

Create a user

Creates a new user. When this is completed, the user will be sent a welcome email from Simple In/Out with a link to choose their own password. Users must have a role that permits managing the company/users to create users. Companies are limited to the number of users their plan supports, and attempting to add more users will result in a greater_than error on the base parameter.

Endpoint

POST /api/v4/users

Parameters

Name Description
user[email] required (string) new user's email address
user[name] required (string) new user's full name
user[details] (string) additional text information about the user
user[lang] (string) preferred locale of the user defaulting to the locale of the authorized user, can be en, en-au, en-ca, en-gb, es, fr, fr-ca
user[phones_attributes] (array) phone objects to attach to the user, each with a 'number' attribute
user[memberships_attributes] (array) membership objects to place the user in the group, each with a 'group_id' attribute
user[role_id] required (string) the ID of the role to assign to the user
user[skip_confirmation_email] (boolean) whether to send a welcome email for the new user to choose their password, defaults to false which makes certain the email is sent
only (string) comma-delimited list of fields to render only, possibilities include: 'id', 'name', 'email', 'image_url', 'details', 'lang', 'created_at', 'updated_at', 'cached_at'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'badge', 'favorites', 'latest', 'memberships', 'memberships.group', 'permissions', 'phones', 'status', 'status.application', 'status.changed_by_user', 'recents', 'role'

Request

Route

POST /api/v4/users

Headers

Content-Type: application/json
Authorization: Bearer vkLXE9SgCRKJMl4OpRKxL7lila3K4Y31Fv8kclnVxI0

Body

{
  "user": {
    "email": "[email protected]",
    "name": "Bojack Horseman",
    "details": "Lead Actor",
    "lang": "en",
    "phones_attributes": [
      {
        "number": "323-141-6931 x452"
      }
    ],
    "memberships_attributes": [
      {
        "group_id": 58612
      }
    ],
    "role_id": "2283689"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users" -d '{"user":{"email":"[email protected]","name":"Bojack Horseman","details":"Lead Actor","lang":"en","phones_attributes":[{"number":"323-141-6931 x452"}],"memberships_attributes":[{"group_id":58612}],"role_id":"2283689"}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer vkLXE9SgCRKJMl4OpRKxL7lila3K4Y31Fv8kclnVxI0"

Response

Simulated Response

Response Fields

Name Description
users (object) the newly created user object

Status

201

Headers

ETag: W/"06359b2fe78824fa638ea99719796293"

Body

{
  "users": {
    "id": "941717",
    "name": "Bojack Horseman",
    "email": "[email protected]",
    "details": "Lead Actor",
    "lang": "en",
    "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
    "role_id": "2283689",
    "created_at": 1739375618,
    "updated_at": 1739375618,
    "cached_at": "1739375618.519203200"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1736351618,
      "beacons": 1736524418,
      "desktop_presences": 1731945218,
      "favorites": 1735055618,
      "fences": 1737647618,
      "groups": 1739375618,
      "networks": 1738857218,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

Create/Update user favorites

Creates user favorites (Quick Picks). If user favorites exist, they will be overwritten by the new ones. Users are limited to 10 favorites.

Endpoint

POST /api/v4/users/my/favorites

Parameters

Name Description
favorites required (array) array of objects consisting of 'status' and 'comment'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'badge', 'favorites', 'latest', 'memberships', 'memberships.group', 'permissions', 'phones', 'status', 'status.application', 'status.changed_by_user', 'recents', 'role'
only (string) comma-delimited list of fields to render only, possibilities include: 'id', 'name', 'email', 'image_url', 'details', 'lang', 'created_at', 'updated_at', 'cached_at'

Request

Route

POST /api/v4/users/my/favorites

Headers

Content-Type: application/json
Authorization: Bearer XWoQI4s8_Xzpv-s7FyOav7OeuZ3pQPQUq-xedi4oTYA

Body

{
  "favorites": [
    {
      "status": "in",
      "comment": "At Work"
    },
    {
      "status": "out",
      "comment": "On Vacation"
    }
  ],
  "expand": "favorites"
}

cURL

curl "https://www.simpleinout.com/api/v4/users/my/favorites" -d '{"favorites":[{"status":"in","comment":"At Work"},{"status":"out","comment":"On Vacation"}],"expand":"favorites"}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer XWoQI4s8_Xzpv-s7FyOav7OeuZ3pQPQUq-xedi4oTYA"

Response

Simulated Response

Response Fields

Name Description
users (object) the newly updated user attributes

Status

200

Headers

ETag: W/"10f8c75ae57644b581c54628f907acd9"

Body

{
  "users": {
    "id": "941721",
    "name": "Sterling Archer",
    "email": "[email protected]",
    "details": "Voluptatem illo inventore.",
    "lang": "en",
    "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
    "favorites": [
      {
        "status": "in",
        "comment": "At Work"
      },
      {
        "status": "out",
        "comment": "On Vacation"
      }
    ],
    "role_id": "2283699",
    "created_at": 1739375618,
    "updated_at": 1739375618,
    "cached_at": "1739375618.586521100"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1733673218,
      "beacons": 1732636418,
      "desktop_presences": 1732550018,
      "favorites": 1733846018,
      "fences": 1734796418,
      "groups": 1738252418,
      "networks": 1732204418,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

Delete a user

Deletes an existing user. Users must have a role that permits managing the company/users to delete users. Companies must have at least one user with the Administrator role, if you attempt to delete the last user with the Administrator role, this will result in a less_than error on the base parameter.

Endpoint

DELETE /api/v4/users/:id

Request

Route

DELETE /api/v4/users/941728

Headers

Content-Type: application/json
Authorization: Bearer d0LBzZmOkAGn2Q1sixUACwe1btw604ndV5-W8__AjIg

cURL

curl "https://www.simpleinout.com/api/v4/users/941728" -d '' -X DELETE \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer d0LBzZmOkAGn2Q1sixUACwe1btw604ndV5-W8__AjIg"

Response

Simulated Response

Status

204

Favorite a status for the current user

Designates a previous status update as a favorite for the current user’s Quick Picks.

Endpoint

PATCH /api/v4/users/my/statuses/favorite

Parameters

Name Description
status[status] required (string) must be 'in', 'remote', 'busy', 'break', 'out', 'sick', or 'vacation'
status[comment] (string) up to 50 character description of the status update

Request

Route

PATCH /api/v4/users/my/statuses/favorite

Headers

Content-Type: application/json
Authorization: Bearer 8wl3kgr4tzkPJmu72fl6dfeUPAx4diXEi7tyRbivnrc

Body

{
  "status": {
    "status": "in",
    "comment": "At Lunch"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/my/statuses/favorite" -d '{"status":{"status":"in","comment":"At Lunch"}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer 8wl3kgr4tzkPJmu72fl6dfeUPAx4diXEi7tyRbivnrc"

Response

Simulated Response

Status

204

Hide a status for the current user

Hides a previous status update from the current user’s Quick Picks.

Endpoint

PATCH /api/v4/users/my/statuses/hide

Parameters

Name Description
status[status] required (string) must be 'in', 'remote', 'busy', 'break', 'out', 'sick', or 'vacation'
status[comment] (string) up to 50 character description of the status update

Request

Route

PATCH /api/v4/users/my/statuses/hide

Headers

Content-Type: application/json
Authorization: Bearer Y7zTxRsWf8pM6bUko55i7DXEdOKiINz8nsIZkGdPJSQ

Body

{
  "status": {
    "status": "in",
    "comment": "At Lunch"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/my/statuses/hide" -d '{"status":{"status":"in","comment":"At Lunch"}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer Y7zTxRsWf8pM6bUko55i7DXEdOKiINz8nsIZkGdPJSQ"

Response

Simulated Response

Status

204

List all archived users

Return a list of all the archived users belonging to the company. Users must have a role that permits managing users.

Endpoint

GET /api/v4/users?archived=true

Request

Route

GET /api/v4/users?archived=true

Headers

Content-Type: application/json
Authorization: Bearer Dah6J84NY6LMs_2UomO0yepGqIOA4aa0cV1as0P9JE8

Query Parameters

archived=true

cURL

curl -g "https://www.simpleinout.com/api/v4/users?archived=true" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer Dah6J84NY6LMs_2UomO0yepGqIOA4aa0cV1as0P9JE8"

Response

Simulated Response

Status

200

Headers

ETag: W/"c53401fcaa0776ddc7f30ecafd24497e"
Last-Modified: Wed, 12 Feb 2025 15:53:40 GMT

Body

{
  "users": [
    {
      "id": "941785",
      "name": "Doria Satterfield",
      "email": null,
      "details": "Aut architecto possimus.",
      "lang": "en",
      "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
      "role_id": null,
      "created_at": 1739375620,
      "updated_at": 1739375620,
      "cached_at": "1739375620.312690000"
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 1,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/users?archived=true",
      "last_href": "http://example.org/api/v4/users?archived=true",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1733846020,
      "beacons": 1735833220,
      "desktop_presences": 1736092420,
      "favorites": 1732550020,
      "fences": 1733327620,
      "groups": 1736870020,
      "networks": 1734364420,
      "roles": 1739375620,
      "settings": 1739375620
    },
    "emergency": null,
    "trusted_cached_at": "1739375605.320443900"
  }
}

List all future statuses for a user

List all the scheduled statuses for the specified user. Please note that the user making this request must have a role with permission to view the scheduled statuses of others and the company must have scheduled statuses enabled.

Endpoint

GET /api/v4/users/:id/futures

Parameters

Name Description
comment (string) the comment, case sensitive, included with the status change
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'apply_at', 'status', 'comment'
apply_at (string) a date range string for the time the status will be added
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'changed_by_user'
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results

Request

Route

GET /api/v4/users/941722/futures

Headers

Content-Type: application/json
Authorization: Bearer AEmnMFocR_ZoGZEOp_sWKn02qums7cfCzApNRbAJWig

cURL

curl -g "https://www.simpleinout.com/api/v4/users/941722/futures" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer AEmnMFocR_ZoGZEOp_sWKn02qums7cfCzApNRbAJWig"

Response

Simulated Response

Response Fields

Name Description
futures (array) an array of matching scheduled statuses

Status

200

Headers

ETag: W/"ca8b37816d921a9af3fde6e250eaa28b"
Last-Modified: Wed, 12 Feb 2025 15:53:38 GMT

Body

{
  "futures": [
    {
      "id": "30099",
      "status": "out",
      "comment": "Offsite Meeting",
      "completed": false,
      "apply_at": 1739952000,
      "end_at": null,
      "user_id": "941722",
      "changed_by_user_id": null
    },
    {
      "id": "30100",
      "status": "out",
      "comment": "Gone Fishing",
      "completed": false,
      "apply_at": 1745406000,
      "end_at": 1745578800,
      "user_id": "941722",
      "changed_by_user_id": "941723"
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 2,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/users/941722/futures?user_id=941722",
      "last_href": "http://example.org/api/v4/users/941722/futures?user_id=941722",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1734278018,
      "beacons": 1732895618,
      "desktop_presences": 1735746818,
      "favorites": 1737042818,
      "fences": 1730822018,
      "groups": 1733586818,
      "networks": 1734364418,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

List all future statuses for the current user

List all the scheduled statuses for the current user. Please note that the company must have scheduled statuses enabled for users to see their scheduled statuses.

Endpoint

GET /api/v4/users/my/futures

Parameters

Name Description
comment (string) the comment, case sensitive, included with the status change
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'apply_at', 'status', 'comment'
apply_at (string) a date range string for the time the status will be added
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'changed_by_user'
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results

Request

Route

GET /api/v4/users/my/futures

Headers

Content-Type: application/json
Authorization: Bearer o9S7NfMSXnivhvkDEIDTMOrplw7S7dqeVGVIIF4lvq0

cURL

curl -g "https://www.simpleinout.com/api/v4/users/my/futures" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer o9S7NfMSXnivhvkDEIDTMOrplw7S7dqeVGVIIF4lvq0"

Response

Simulated Response

Response Fields

Name Description
futures (array) an array of matching scheduled statuses

Status

200

Headers

ETag: W/"a4258c9f8c770db82d336c8a10a2573a"
Last-Modified: Wed, 12 Feb 2025 15:53:38 GMT

Body

{
  "futures": [
    {
      "id": "30097",
      "status": "out",
      "comment": "Offsite Meeting",
      "completed": false,
      "apply_at": 1739952000,
      "end_at": null,
      "user_id": "941706",
      "changed_by_user_id": null
    },
    {
      "id": "30098",
      "status": "out",
      "comment": "Gone Fishing",
      "completed": false,
      "apply_at": 1745406000,
      "end_at": 1745578800,
      "user_id": "941706",
      "changed_by_user_id": "941707"
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 2,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/users/my/futures?user_id=941706",
      "last_href": "http://example.org/api/v4/users/my/futures?user_id=941706",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1733586818,
      "beacons": 1739116418,
      "desktop_presences": 1734018818,
      "favorites": 1735833218,
      "fences": 1735055618,
      "groups": 1737302018,
      "networks": 1733586818,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

List all statuses for a user

List all the statuses for the specified user within the time period specified by the ‘created_at’ date range. Users must have a role that permits viewing the past statuses of others if viewing another user. They can always view their own past statuses.

Endpoint

GET /api/v4/users/:id/statuses

Parameters

Name Description
created_at required (string) a date range string for the time the status was created
comment (string) the comment, case sensitive, included with the status change
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'created_at', 'status', 'comment'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'user.favorites', 'user.latest', 'user.memberships', 'user.phones', 'user.recents', 'changed_by_user', 'application'
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results

Request

Route

GET /api/v4/users/941724/statuses?created_at=1738735200..1738994399

Headers

Content-Type: application/json
Authorization: Bearer DUFLbN6ViNu6SW8cxZkmEfdmkmWHtIhfUbbzqNvxmTw

Query Parameters

created_at=1738735200..1738994399

cURL

curl -g "https://www.simpleinout.com/api/v4/users/941724/statuses?created_at=1738735200..1738994399" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer DUFLbN6ViNu6SW8cxZkmEfdmkmWHtIhfUbbzqNvxmTw"

Response

Simulated Response

Response Fields

Name Description
statuses (array) an array of matching statuses

Status

200

Headers

ETag: W/"6f6c71f10f7f6693503eda44e9263606"
Last-Modified: Thu, 06 Feb 2025 15:00:00 GMT

Body

{
  "statuses": [
    {
      "status": "in",
      "comment": "At Work",
      "automatic": false,
      "user_id": "941724",
      "changed_by_user_id": null,
      "created_at": 1738742400
    },
    {
      "status": "out",
      "comment": "Left Work",
      "automatic": false,
      "user_id": "941724",
      "changed_by_user_id": null,
      "created_at": 1738756800
    },
    {
      "status": "in",
      "comment": "At Work",
      "automatic": false,
      "user_id": "941724",
      "changed_by_user_id": null,
      "created_at": 1738760400
    },
    {
      "status": "out",
      "comment": "Left Work",
      "automatic": false,
      "user_id": "941724",
      "changed_by_user_id": null,
      "created_at": 1738778400
    },
    {
      "status": "in",
      "comment": "At Work",
      "automatic": false,
      "user_id": "941724",
      "changed_by_user_id": null,
      "created_at": 1738828800
    },
    {
      "status": "out",
      "comment": "Left Work",
      "automatic": false,
      "user_id": "941724",
      "changed_by_user_id": null,
      "created_at": 1738850400
    },
    {
      "status": "out",
      "comment": "Vacation",
      "automatic": false,
      "user_id": "941724",
      "changed_by_user_id": "941725",
      "created_at": 1738854000
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 7,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/users/941724/statuses?created_at=1738735200..1738994399&user_id=941724",
      "last_href": "http://example.org/api/v4/users/941724/statuses?created_at=1738735200..1738994399&user_id=941724",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1732204418,
      "beacons": 1735401218,
      "desktop_presences": 1731858818,
      "favorites": 1731254018,
      "fences": 1731686018,
      "groups": 1737734018,
      "networks": 1731081218,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

List all statuses for the current user

List all the statuses for the current user within the time period specified by the ‘created_at’ date range.

Endpoint

GET /api/v4/users/my/statuses

Parameters

Name Description
created_at required (string) a date range string for the time the status was created
comment (string) the comment, case sensitive, included with the status change
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'created_at', 'status', 'comment'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'user', 'user.favorites', 'user.latest', 'user.memberships', 'user.phones', 'user.recents', 'changed_by_user', 'application'
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results

Request

Route

GET /api/v4/users/my/statuses?created_at=1738735200..1738994399

Headers

Content-Type: application/json
Authorization: Bearer 8CIeklBVSJ6n3MmsHeFiWv-3bsT7BFaaJ9Un91wqMKo

Query Parameters

created_at=1738735200..1738994399

cURL

curl -g "https://www.simpleinout.com/api/v4/users/my/statuses?created_at=1738735200..1738994399" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer 8CIeklBVSJ6n3MmsHeFiWv-3bsT7BFaaJ9Un91wqMKo"

Response

Simulated Response

Response Fields

Name Description
statuses (array) an array of matching statuses

Status

200

Headers

ETag: W/"fb6774eb4ebf10b8afd85cdead6766f3"
Last-Modified: Thu, 06 Feb 2025 15:00:00 GMT

Body

{
  "statuses": [
    {
      "status": "in",
      "comment": "At Work",
      "automatic": false,
      "user_id": "941693",
      "changed_by_user_id": null,
      "created_at": 1738742400
    },
    {
      "status": "out",
      "comment": "Left Work",
      "automatic": false,
      "user_id": "941693",
      "changed_by_user_id": null,
      "created_at": 1738756800
    },
    {
      "status": "in",
      "comment": "At Work",
      "automatic": false,
      "user_id": "941693",
      "changed_by_user_id": null,
      "created_at": 1738760400
    },
    {
      "status": "out",
      "comment": "Left Work",
      "automatic": false,
      "user_id": "941693",
      "changed_by_user_id": null,
      "created_at": 1738778400
    },
    {
      "status": "in",
      "comment": "At Work",
      "automatic": false,
      "user_id": "941693",
      "changed_by_user_id": null,
      "created_at": 1738828800
    },
    {
      "status": "out",
      "comment": "Left Work",
      "automatic": false,
      "user_id": "941693",
      "changed_by_user_id": null,
      "created_at": 1738850400
    },
    {
      "status": "out",
      "comment": "Vacation",
      "automatic": false,
      "user_id": "941693",
      "changed_by_user_id": "941694",
      "created_at": 1738854000
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 7,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/users/my/statuses?created_at=1738735200..1738994399&user_id=941693",
      "last_href": "http://example.org/api/v4/users/my/statuses?created_at=1738735200..1738994399&user_id=941693",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1733414018,
      "beacons": 1734191618,
      "desktop_presences": 1733500418,
      "favorites": 1738857218,
      "fences": 1732982018,
      "groups": 1732809218,
      "networks": 1733327618,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

List all users

Return a list of all the users belonging to the company. Users must have a role that permits viewing users.

Endpoint

GET /api/v4/users

Parameters

Name Description
page_size (integer) number of results to return per page, defaults to 25
page (integer) page number of results
name (string) return users with this name
email (string) return users with this email
id (array) return users by an array of ids
group_id (string/array) return users belonging to a group id, which can be a string or array in the form of group_id[]=INT
cached_at (integer/float) return users updated that have made a significant change since an epoch time, accurate to nanoseconds
sort (string) order of the return with optional '-' to denote descending, possibilities include: 'name', 'email', 'cached_at', 'status.status', 'status.created_at'
only (string) comma-delimited list of fields to render only, possibilities include: 'id', 'name', 'email', 'image_url', 'details', 'lang', 'created_at', 'updated_at', 'cached_at'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'badge', 'favorites', 'latest', 'memberships', 'memberships.group', 'permissions', 'phones', 'status', 'status.application', 'status.changed_by_user', 'recents', 'role'

Request

Route

GET /api/v4/users

Headers

Content-Type: application/json
Authorization: Bearer ZrMJ-15JucL9hrR-kgAsEaFsFZz-MqZpppzDPA8xYEM

cURL

curl -g "https://www.simpleinout.com/api/v4/users" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer ZrMJ-15JucL9hrR-kgAsEaFsFZz-MqZpppzDPA8xYEM"

Response

Simulated Response

Response Fields

Name Description
users (array) an array of users
trusted_cached_at (string in the meta object) the server time minus an amount to account for network delivery time

Status

200

Headers

ETag: W/"4330ed591a6b2a59217c2ea28c082197"
Last-Modified: Wed, 12 Feb 2025 15:53:38 GMT

Body

{
  "users": [
    {
      "id": "941712",
      "name": "Malory Archer",
      "email": "[email protected]",
      "details": "Ut enim maiores.",
      "lang": "en",
      "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
      "role_id": "2283685",
      "created_at": 1739375618,
      "updated_at": 1739375618,
      "cached_at": "1739375618.459264000"
    },
    {
      "id": "941713",
      "name": "Sterling Archer",
      "email": "[email protected]",
      "details": "Omnis voluptas laudantium.",
      "lang": "en",
      "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
      "role_id": "2283687",
      "created_at": 1739375618,
      "updated_at": 1739375618,
      "cached_at": "1739375618.464438000"
    },
    {
      "id": "941714",
      "name": "Lana Kane",
      "email": "[email protected]",
      "details": "Animi qui omnis.",
      "lang": "en",
      "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
      "role_id": "2283687",
      "created_at": 1739375618,
      "updated_at": 1739375618,
      "cached_at": "1739375618.470484000"
    },
    {
      "id": "941715",
      "name": "Ray Gillette",
      "email": "[email protected]",
      "details": "Accusantium quia rem.",
      "lang": "en",
      "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
      "role_id": "2283687",
      "created_at": 1739375618,
      "updated_at": 1739375618,
      "cached_at": "1739375618.475302000"
    }
  ],
  "meta": {
    "paging": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "count": 4,
      "previous_page": null,
      "next_page": null,
      "first_href": "http://example.org/api/v4/users",
      "last_href": "http://example.org/api/v4/users",
      "previous_href": null,
      "next_href": null
    },
    "last_updated_at": {
      "announcements": 1735833218,
      "beacons": 1739030018,
      "desktop_presences": 1736265218,
      "favorites": 1734537218,
      "fences": 1732204418,
      "groups": 1733154818,
      "networks": 1733759618,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null,
    "trusted_cached_at": "1739375603.481956000"
  }
}

Mark announcements as read

Marks announcements beforehand as read. If an epoch time from the future is passed in, it will become the current time.

Endpoint

POST /api/v4/users/my/announcements/read

Parameters

Name Description
read_at required (integer) epoch time denoting all announcements before this time have been read

Request

Route

POST /api/v4/users/my/announcements/read

Headers

Content-Type: application/json
Authorization: Bearer SAezI6ApTMozOpaIOGYxdIxCiaNl9xCwgrjk6PGmuG0

cURL

curl "https://www.simpleinout.com/api/v4/users/my/announcements/read" -d '' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer SAezI6ApTMozOpaIOGYxdIxCiaNl9xCwgrjk6PGmuG0"

Response

Simulated Response

Response Fields

Name Description
users (object) the newly updated user attributes

Status

204

Retrieve a user

Retrieve an existing user. Users must have a role that permits viewing users.

Endpoint

GET /api/v4/users/:id

Parameters

Name Description
only (string) comma-delimited list of fields to render only, possibilities include: 'id', 'name', 'email', 'image_url', 'details', 'lang', 'created_at', 'updated_at', 'cached_at'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'badge', 'favorites', 'latest', 'memberships', 'memberships.group', 'permissions', 'phones', 'status', 'status.application', 'status.changed_by_user', 'recents', 'role'

Request

Route

GET /api/v4/users/941734

Headers

Content-Type: application/json
Authorization: Bearer 5kIHNBc9jfM8sg2scO3Pf0-71-9ITtKotSo_RYquD4g

cURL

curl -g "https://www.simpleinout.com/api/v4/users/941734" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer 5kIHNBc9jfM8sg2scO3Pf0-71-9ITtKotSo_RYquD4g"

Response

Simulated Response

Response Fields

Name Description
users (object) a user object

Status

200

Headers

ETag: W/"0203e93554c828c6f8fdbface4477579"
Last-Modified: Wed, 12 Feb 2025 15:53:38 GMT

Body

{
  "users": {
    "id": "941734",
    "name": "Sterling Archer",
    "email": "[email protected]",
    "details": "Et cum blanditiis.",
    "lang": "en",
    "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
    "role_id": "2283727",
    "created_at": 1739375618,
    "updated_at": 1739375618,
    "cached_at": "1739375618.933750000"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1737734018,
      "beacons": 1736697218,
      "desktop_presences": 1733759618,
      "favorites": 1737302018,
      "fences": 1732204418,
      "groups": 1738857218,
      "networks": 1739202818,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

Retrieve the current user

Retrieve the current user who is authorized.

Endpoint

GET /api/v4/users/my

Parameters

Name Description
only (string) comma-delimited list of fields to render only, possibilities include: 'id', 'name', 'email', 'image_url', 'details', 'lang', 'created_at', 'updated_at', 'cached_at'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'badge', 'favorites', 'latest', 'memberships', 'memberships.group', 'permissions', 'phones', 'status', 'status.application', 'status.changed_by_user', 'recents', 'role'

Request

Route

GET /api/v4/users/my

Headers

Content-Type: application/json
Authorization: Bearer vlX3Sp6d4MAltt5-_BkldxoatXZMvTtK4z5dUA-apWc

cURL

curl -g "https://www.simpleinout.com/api/v4/users/my" -X GET \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer vlX3Sp6d4MAltt5-_BkldxoatXZMvTtK4z5dUA-apWc"

Response

Simulated Response

Response Fields

Name Description
users (object) a user object

Status

200

Headers

ETag: W/"1565edf6e3e27494f2ae4f91dc60a349"
Last-Modified: Wed, 12 Feb 2025 15:53:38 GMT

Body

{
  "users": {
    "id": "941704",
    "name": "Sterling Archer",
    "email": "[email protected]",
    "details": "Repellendus delectus est.",
    "lang": "en",
    "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
    "role_id": "2283671",
    "created_at": 1739375618,
    "updated_at": 1739375618,
    "cached_at": "1739375618.313156100"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1735401218,
      "beacons": 1737561218,
      "desktop_presences": 1732204418,
      "favorites": 1737129218,
      "fences": 1737474818,
      "groups": 1731858818,
      "networks": 1731167618,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

Unarchive a user

Unarchives an archived user. Users must have a role that permits managing users.

Endpoint

POST /api/v4/users/:id/unarchive

Parameters

Name Description
user[email] required (string) the user's email address
user[name] (string) the user's full name
user[details] (string) additional text information about the user
user[lang] (string) preferred locale of the user defaulting to the locale of the authorized user, can be en, en-au, en-ca, en-gb, es, fr, fr-ca
user[phones_attributes] (array) phone objects to attach to the user, each with a 'number' attribute
user[memberships_attributes] (array) membership objects to place the user in the group, each with a 'group_id' attribute
user[role_id] required (string) the ID of the role to assign to the user
only (string) comma-delimited list of fields to render only, possibilities include: 'id', 'name', 'email', 'image_url', 'details', 'lang', 'created_at', 'updated_at', 'cached_at'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'badge', 'favorites', 'latest', 'memberships', 'memberships.group', 'permissions', 'phones', 'status', 'status.application', 'status.changed_by_user', 'recents', 'role'

Request

Route

POST /api/v4/users/941758/unarchive

Headers

Content-Type: application/json
Authorization: Bearer rr9refpmhQSNREXiE_Eg_mmxmAUxqq_4gI_kvAWuyEk

Body

{
  "user": {
    "email": "[email protected]",
    "role_id": "2283801"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/941758/unarchive" -d '{"user":{"email":"[email protected]","role_id":"2283801"}}' -X POST \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer rr9refpmhQSNREXiE_Eg_mmxmAUxqq_4gI_kvAWuyEk"

Response

Simulated Response

Status

200

Headers

ETag: W/"7c4ab476376fb7280e43daf964c46ede"

Body

{
  "users": {
    "id": "941758",
    "name": "Pres. Hayden Leffler",
    "email": "[email protected]",
    "details": "Omnis aut quia.",
    "lang": "en",
    "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
    "role_id": "2283801",
    "created_at": 1739375619,
    "updated_at": 1739375619,
    "cached_at": "1739375619.593567000"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1733500419,
      "beacons": 1739202819,
      "desktop_presences": 1735660419,
      "favorites": 1732031619,
      "fences": 1732895619,
      "groups": 1738857219,
      "networks": 1735401219,
      "roles": 1739375619,
      "settings": 1739375619
    },
    "emergency": null
  }
}

Unfavorite a status for the current user

Undoes a previous status’ favorite designation for the current user’s Quick Picks.

Endpoint

PATCH /api/v4/users/my/statuses/unfavorite

Parameters

Name Description
status[status] required (string) must be 'in', 'remote', 'busy', 'break', 'out', 'sick', or 'vacation'
status[comment] (string) up to 50 character description of the status update

Request

Route

PATCH /api/v4/users/my/statuses/unfavorite

Headers

Content-Type: application/json
Authorization: Bearer gkaOHlFrmA8DRjwDX6gqV1qwyY17CKHBCqS318AP5qc

Body

{
  "status": {
    "status": "in",
    "comment": "At Lunch"
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/my/statuses/unfavorite" -d '{"status":{"status":"in","comment":"At Lunch"}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer gkaOHlFrmA8DRjwDX6gqV1qwyY17CKHBCqS318AP5qc"

Response

Simulated Response

Status

204

Update a user

Updates an existing user. Users must have a role that permits managing the company/users to update users. Companies must have at least one user with the Administrator role, if you attempt to change the role of the last user with the Administrator role, this will result in a less_than error on the base parameter.

Endpoint

PATCH /api/v4/users/:id

Parameters

Name Description
user[email] (string) new user's email address
user[name] (string) new user's full name
user[details] (string) additional text information about the user
user[lang] (string) preferred locale of the user, can be en, en-au, en-ca, en-gb, es, fr, fr-ca
user[phones_attributes] (array) phone objects to attach to the user if both 'id' and 'number' are passed in, the existing phone number will be updated if just 'number' is passed in, a new phone will be added if both 'id' and '_destroy' are passed in ('_destroy' being truthy like 'true' or '1'), the phone number will be removed
user[memberships_attributes] (array) group objects to attach to the user if both 'id' and 'group_id' are passed in, the existing membership will be updated if just 'group_id' is passed in, a new membership will be added if both 'id' and '_destroy' are passed in ('_destroy' being truthy like 'true' or '1'), the group membership will be removed
user[role_id] (string) the ID of the role to assign to the user
only (string) comma-delimited list of fields to render only, possibilities include: 'id', 'name', 'email', 'image_url', 'details', 'lang', 'created_at', 'updated_at', 'cached_at'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'badge', 'favorites', 'latest', 'memberships', 'memberships.group', 'permissions', 'phones', 'status', 'status.application', 'status.changed_by_user', 'recents', 'role'

Request

Route

PATCH /api/v4/users/941736

Headers

Content-Type: application/json
Authorization: Bearer VbkLsRXhicUVRD7FxBZF7DAKiPzKbFtKO_39tXqlGLk

Body

{
  "user": {
    "phones_attributes": [
      {
        "number": "792-257-3625 x416"
      }
    ],
    "memberships_attributes": [
      {
        "group_id": 58613
      }
    ]
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/941736" -d '{"user":{"phones_attributes":[{"number":"792-257-3625 x416"}],"memberships_attributes":[{"group_id":58613}]}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer VbkLsRXhicUVRD7FxBZF7DAKiPzKbFtKO_39tXqlGLk"

Response

Simulated Response

Response Fields

Name Description
users (object) the newly updated user attributes

Status

200

Headers

ETag: W/"7e72b5ed54c203591d5193cb9574f152"

Body

{
  "users": {
    "id": "941736",
    "name": "Sterling Archer",
    "email": "[email protected]",
    "details": "Dolor libero quis.",
    "lang": "en",
    "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
    "role_id": "2283731",
    "created_at": 1739375618,
    "updated_at": 1739375618,
    "cached_at": "1739375618.979690000"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1733586818,
      "beacons": 1732636418,
      "desktop_presences": 1732982018,
      "favorites": 1731340418,
      "fences": 1739375618,
      "groups": 1739375618,
      "networks": 1731340418,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}

Update the current user

Updates the currently authorized user. The current user cannot update their own role.

Endpoint

PATCH /api/v4/users/my

Parameters

Name Description
user[email] (string) new user's email address
user[name] (string) new user's full name
user[details] (string) additional text information about the user
user[lang] (string) preferred locale of the user, can be en, en-au, en-ca, en-gb, es, fr, fr-ca
user[phones_attributes] (array) phone objects to attach to the user if both 'id' and 'number' are passed in, the existing phone number will be updated if just 'number' is passed in, a new phone will be added if both 'id' and '_destroy' are passed in ('_destroy' being truthy like 'true' or '1'), the phone number will be removed
user[memberships_attributes] (array) group objects to attach to the user if both 'id' and 'group_id' are passed in, the existing membership will be updated if just 'group_id' is passed in, a new membership will be added if both 'id' and '_destroy' are passed in ('_destroy' being truthy like 'true' or '1') the group membership will be removed
only (string) comma-delimited list of fields to render only, possibilities include: 'id', 'name', 'email', 'image_url', 'details', 'lang', 'created_at', 'updated_at', 'cached_at'
expand (string) comma-delimited list of extra information to include in the response, possibilities include: 'badge', 'favorites', 'latest', 'memberships', 'memberships.group', 'permissions', 'phones', 'status', 'status.application', 'status.changed_by_user', 'recents', 'role'

Request

Route

PATCH /api/v4/users/my

Headers

Content-Type: application/json
Authorization: Bearer H1GSKToFOr9HKu9G90OM2q68cIQzasYz01JllWvFOWI

Body

{
  "user": {
    "phones_attributes": [
      {
        "number": "392-211-9372 x213"
      }
    ],
    "memberships_attributes": [
      {
        "group_id": 58608
      }
    ]
  }
}

cURL

curl "https://www.simpleinout.com/api/v4/users/my" -d '{"user":{"phones_attributes":[{"number":"392-211-9372 x213"}],"memberships_attributes":[{"group_id":58608}]}}' -X PATCH \
	-H "Version: HTTP/1.0" \
	-H "Content-Type: application/json" \
	-H "Authorization: Bearer H1GSKToFOr9HKu9G90OM2q68cIQzasYz01JllWvFOWI"

Response

Simulated Response

Response Fields

Name Description
users (object) the newly updated user attributes

Status

200

Headers

ETag: W/"0409de4fbb5850d55b5252118ea65f9f"

Body

{
  "users": {
    "id": "941695",
    "name": "Mrs. Robbie Ledner",
    "email": "[email protected]",
    "details": "Et nihil cum.",
    "lang": "en",
    "image_url": "https://simpleinout.s3.amazonaws.com/image_none.png",
    "role_id": "2283649",
    "created_at": 1739375618,
    "updated_at": 1739375618,
    "cached_at": "1739375618.137718000"
  },
  "meta": {
    "last_updated_at": {
      "announcements": 1739289218,
      "beacons": 1732895618,
      "desktop_presences": 1734278018,
      "favorites": 1735833218,
      "fences": 1738598018,
      "groups": 1739375618,
      "networks": 1736610818,
      "roles": 1739375618,
      "settings": 1739375618
    },
    "emergency": null
  }
}