Zentry.CheckIns.Api v1.0
Base URLs:
Authentication
- API Key (API_KEY)
- Parameter Name: Api-Key Authentication, in: header.
CheckIn
CreateCheckIn
POST /CheckIn/create
Body parameter
{
"reservationId": "926d3163ee1ffbbdb47b6a76",
"location": {
"latitude": 38.62,
"longitude": -90.18
}
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateCheckInRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | CheckIn |
CheckOut
POST /CheckIn/check-out
Body parameter
{
"id": "184d3163ee1ffbbdb38b6c07",
"location": {
"latitude": 38.62,
"longitude": -90.18
}
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CheckOutRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | CheckIn |
GetCheckIns
POST /CheckIn
Body parameter
{
"offset": 0,
"limit": 25,
"ids": [
"184d3163ee1ffbbdb38b6c07"
],
"userIds": [
"926d3163ee1ffbbdb47b6a76"
],
"locationIds": [
"686d3163ee1ffbbdb38b6a74"
],
"workspaceIds": [
"986d3163ee1ffbbdb38b6n34"
],
"employerIds": [
"184d3163ee1ffbbdb38b6c07"
],
"minimumTimeIn": "2019-08-24T14:15:22Z",
"maximumTimeIn": "2019-08-24T14:15:22Z",
"excludeCheckOuts": true
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | GetCheckInsRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | CheckInIPagedResponse |
Reservation
CreateReservation
POST /Reservation/create
Body parameter
{
"userId": "926d3163ee1ffbbdb47b6a76",
"locationId": "686d3163ee1ffbbdb38b6a74",
"employerId": "184d3163ee1ffbbdb38b6c07",
"reservationDate": "2019-08-24T14:15:22Z",
"userTimeZone": "America/Chicago"
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | CreateReservationRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | Reservation |
400 | Bad Request | Bad Request | ProblemDetails |
DeleteReservation
DELETE /Reservation
Body parameter
{
"reservationId": "926d3163ee1ffbbdb47b6a76"
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | DeleteReservationRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | None |
GetReservations
POST /Reservation
Body parameter
{
"offset": 0,
"limit": 25,
"userIds": [
"926d3163ee1ffbbdb47b6a76"
],
"locationIds": [
"686d3163ee1ffbbdb38b6a74"
],
"workspaceIds": [
"986d3163ee1ffbbdb38b6n34"
],
"employerIds": [
"184d3163ee1ffbbdb38b6c07"
],
"minimumReservationDate": "2019-08-24T14:15:22Z",
"maximumReservationDate": "2019-08-24T14:15:22Z"
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | GetReservationsRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | ReservationIPagedResponse |
Token
GetUserTokenCount
POST /Token/user
Body parameter
{
"userId": "926d3163ee1ffbbdb47b6a76",
"employerId": "184d3163ee1ffbbdb38b6c07",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | GetUserTokenCountRequest | false | none |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | UserTokenCount |
Schemas
CheckIn
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"userId": "926d3163ee1ffbbdb47b6a76",
"locationId": "686d3163ee1ffbbdb38b6a74",
"workspaceId": "string",
"employerId": "184d3163ee1ffbbdb38b6c07",
"reservationDate": "2019-08-24T14:15:22Z",
"timeIn": "2019-08-24T14:15:22Z",
"checkInGeo": {
"latitude": 38.62,
"longitude": -90.18
},
"timeOut": "2019-08-24T14:15:22Z",
"checkOutGeo": {
"latitude": 38.62,
"longitude": -90.18
},
"checkedInByUserId": "string",
"price": 10000,
"tokenCost": 10
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | true | none | The unique identifier for this entity |
dateCreated | string(date-time) | true | none | The initial date this entity was created |
dateUpdated | string(date-time) | true | none | The last time this entity was updated |
userId | string | true | none | Zentry Pass User Id |
locationId | string | true | none | Zentry Pass Workspace Location Id |
workspaceId | string | true | none | none |
employerId | string | true | none | Zentry Pass Employer Id |
reservationDate | string(date-time) | true | none | The date of the reservation |
timeIn | string(date-time) | true | none | The time of check-in |
checkInGeo | Geo | false | none | none |
timeOut | string(date-time)¦null | false | none | The time of check-out |
checkOutGeo | Geo | false | none | none |
checkedInByUserId | string¦null | false | none | The user that performed the check-in |
price | integer(int64) | true | none | The cost of the location. Stored in cents. |
tokenCost | integer(int32) | true | none | How many tokens the location cost |
CheckInIPagedResponse
{
"data": [
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"userId": "926d3163ee1ffbbdb47b6a76",
"locationId": "686d3163ee1ffbbdb38b6a74",
"workspaceId": "string",
"employerId": "184d3163ee1ffbbdb38b6c07",
"reservationDate": "2019-08-24T14:15:22Z",
"timeIn": "2019-08-24T14:15:22Z",
"checkInGeo": {
"latitude": 38.62,
"longitude": -90.18
},
"timeOut": "2019-08-24T14:15:22Z",
"checkOutGeo": {
"latitude": 38.62,
"longitude": -90.18
},
"checkedInByUserId": "string",
"price": 10000,
"tokenCost": 10
}
],
"pagedRequest": {
"offset": 0,
"limit": 25
},
"totalCount": 100
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
data | [CheckIn] | true | read-only | The paged data |
pagedRequest | IPagedRequest | true | none | none |
totalCount | integer(int32) | true | read-only | The total number of items available |
CheckInQuery
{
"offset": 0,
"limit": 25,
"ids": [
"184d3163ee1ffbbdb38b6c07"
],
"userIds": [
"926d3163ee1ffbbdb47b6a76"
],
"locationIds": [
"686d3163ee1ffbbdb38b6a74"
],
"workspaceIds": [
"986d3163ee1ffbbdb38b6n34"
],
"employerIds": [
"184d3163ee1ffbbdb38b6c07"
],
"minimumTimeIn": "2019-08-24T14:15:22Z",
"maximumTimeIn": "2019-08-24T14:15:22Z",
"excludeCheckOuts": true
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
offset | integer(int32) | true | none | How far to skip into a collection |
limit | integer(int32) | true | none | How many results to return |
ids | [string]¦null | false | none | List of Zentry Pass CheckIn Ids |
userIds | [string]¦null | false | none | List of Zentry Pass User Ids |
locationIds | [string]¦null | false | none | List of Zentry Pass Workspace Location Ids |
workspaceIds | [string]¦null | false | none | List of Zentry Pass Workspace Ids |
employerIds | [string]¦null | false | none | List of Zentry Pass Employer Ids |
minimumTimeIn | string(date-time)¦null | false | none | Filter check-ins with a TimeIn greater than this time |
maximumTimeIn | string(date-time)¦null | false | none | Filter check-ins with a TimeIn less than this time |
excludeCheckOuts | boolean¦null | false | none | Used to get checkins that have not checked out yet |
CheckOutRequest
{
"id": "184d3163ee1ffbbdb38b6c07",
"location": {
"latitude": 38.62,
"longitude": -90.18
}
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | true | none | Zentry Pass CheckIn Id |
location | Geo | false | none | none |
CreateCheckInRequest
{
"reservationId": "926d3163ee1ffbbdb47b6a76",
"location": {
"latitude": 38.62,
"longitude": -90.18
}
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
reservationId | string | true | none | Zentry Pass Reservation Id |
location | Geo | false | none | none |
CreateReservationRequest
{
"userId": "926d3163ee1ffbbdb47b6a76",
"locationId": "686d3163ee1ffbbdb38b6a74",
"employerId": "184d3163ee1ffbbdb38b6c07",
"reservationDate": "2019-08-24T14:15:22Z",
"userTimeZone": "America/Chicago"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
userId | string | true | none | Zentry Pass User Id |
locationId | string | true | none | Zentry Pass Workspace Location Id |
employerId | string | true | none | Zentry Pass Employer Id |
reservationDate | string(date-time) | true | none | The date of the reservation |
userTimeZone | string | true | none | The user's time zone |
DeleteReservationRequest
{
"reservationId": "926d3163ee1ffbbdb47b6a76"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
reservationId | string | true | none | Zentry Pass Reservation Id |
Geo
{
"latitude": 38.62,
"longitude": -90.18
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
latitude | number(double) | true | none | none |
longitude | number(double) | true | none | none |
GetCheckInsRequest
{
"offset": 0,
"limit": 25,
"ids": [
"184d3163ee1ffbbdb38b6c07"
],
"userIds": [
"926d3163ee1ffbbdb47b6a76"
],
"locationIds": [
"686d3163ee1ffbbdb38b6a74"
],
"workspaceIds": [
"986d3163ee1ffbbdb38b6n34"
],
"employerIds": [
"184d3163ee1ffbbdb38b6c07"
],
"minimumTimeIn": "2019-08-24T14:15:22Z",
"maximumTimeIn": "2019-08-24T14:15:22Z",
"excludeCheckOuts": true
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | CheckInQuery | false | none | none |
and
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | object | false | none | none |
GetReservationsRequest
{
"offset": 0,
"limit": 25,
"userIds": [
"926d3163ee1ffbbdb47b6a76"
],
"locationIds": [
"686d3163ee1ffbbdb38b6a74"
],
"workspaceIds": [
"986d3163ee1ffbbdb38b6n34"
],
"employerIds": [
"184d3163ee1ffbbdb38b6c07"
],
"minimumReservationDate": "2019-08-24T14:15:22Z",
"maximumReservationDate": "2019-08-24T14:15:22Z"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | ReservationQuery | false | none | none |
and
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | object | false | none | none |
GetUserTokenCountRequest
{
"userId": "926d3163ee1ffbbdb47b6a76",
"employerId": "184d3163ee1ffbbdb38b6c07",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}
Gets the number of tokens used in the passed time frame
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
userId | string | true | none | Zentry Pass User Id |
employerId | string | true | none | Zentry Pass Employer Id |
fromDate | string(date-time)¦null | false | none | Limit token count to reservations and checkins greater than this date. If this is null, then defaults to the start of the month. |
toDate | string(date-time)¦null | false | none | Limit token count to reservations and checkins less than this date. If FromDate is null, then this value is ignored. |
HttpValidationProblemDetails
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null,
"errors": {
"property1": [
"string"
],
"property2": [
"string"
]
}
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | ProblemDetails | false | none | none |
and
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | object | false | none | none |
» additionalProperties | any | false | none | none |
» errors | object | true | none | none |
»» additionalProperties | [string] | false | none | none |
IPagedRequest
{
"offset": 0,
"limit": 25
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
offset | integer(int32) | true | read-only | How far to skip into a collection |
limit | integer(int32) | true | read-only | How many results to return |
ProblemDetails
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
additionalProperties | any | false | none | none |
type | string¦null | false | none | none |
title | string¦null | false | none | none |
status | integer(int32)¦null | false | none | none |
detail | string¦null | false | none | none |
instance | string¦null | false | none | none |
Reservation
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"locationId": "686d3163ee1ffbbdb38b6a74",
"workspaceId": "686d3163ee1ffbbdb38b6a74",
"userId": "926d3163ee1ffbbdb47b6a76",
"employerId": "184d3163ee1ffbbdb38b6c07",
"reservationDate": "2019-08-24T14:15:22Z",
"price": 10000,
"tokenCost": 10
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | true | none | The unique identifier for this entity |
dateCreated | string(date-time) | true | none | The initial date this entity was created |
dateUpdated | string(date-time) | true | none | The last time this entity was updated |
locationId | string | true | none | Zentry Pass Workspace Location Id |
workspaceId | string | true | none | Zentry Pass Workspace Id |
userId | string | true | none | Zentry Pass User Id |
employerId | string | true | none | Zentry Pass Employer Id |
reservationDate | string(date-time) | true | none | The date of the reservation |
price | integer(int64) | true | none | The cost of the location. Stored in cents. |
tokenCost | integer(int32) | true | none | How many tokens the location cost |
ReservationIPagedResponse
{
"data": [
{
"id": "184d3163ee1ffbbdb38b6c07",
"dateCreated": "2019-08-24T14:15:22Z",
"dateUpdated": "2019-08-24T14:15:22Z",
"locationId": "686d3163ee1ffbbdb38b6a74",
"workspaceId": "686d3163ee1ffbbdb38b6a74",
"userId": "926d3163ee1ffbbdb47b6a76",
"employerId": "184d3163ee1ffbbdb38b6c07",
"reservationDate": "2019-08-24T14:15:22Z",
"price": 10000,
"tokenCost": 10
}
],
"pagedRequest": {
"offset": 0,
"limit": 25
},
"totalCount": 100
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
data | [Reservation] | true | read-only | The paged data |
pagedRequest | IPagedRequest | true | none | none |
totalCount | integer(int32) | true | read-only | The total number of items available |
ReservationQuery
{
"offset": 0,
"limit": 25,
"userIds": [
"926d3163ee1ffbbdb47b6a76"
],
"locationIds": [
"686d3163ee1ffbbdb38b6a74"
],
"workspaceIds": [
"986d3163ee1ffbbdb38b6n34"
],
"employerIds": [
"184d3163ee1ffbbdb38b6c07"
],
"minimumReservationDate": "2019-08-24T14:15:22Z",
"maximumReservationDate": "2019-08-24T14:15:22Z"
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
offset | integer(int32) | true | none | How far to skip into a collection |
limit | integer(int32) | true | none | How many results to return |
userIds | [string]¦null | false | none | List of Zentry Pass User Ids |
locationIds | [string]¦null | false | none | List of Zentry Pass Workspace Location Ids |
workspaceIds | [string]¦null | false | none | List of Zentry Pass Workspace Ids |
employerIds | [string]¦null | false | none | List of Zentry Pass Employer Ids |
minimumReservationDate | string(date-time)¦null | false | none | Filter reservations with a reservation date greater than this time |
maximumReservationDate | string(date-time)¦null | false | none | Filter reservations with a reservation date less than this time |
UserTokenCount
{
"userId": "string",
"tokenCount": 0
}
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
userId | string | true | none | none |
tokenCount | integer(int32) | true | none | none |