Skip to main content

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

NameInTypeRequiredDescription
bodybodyCreateCheckInRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKCheckIn

CheckOut

POST /CheckIn/check-out

Body parameter

{
"id": "184d3163ee1ffbbdb38b6c07",
"location": {
"latitude": 38.62,
"longitude": -90.18
}
}

Parameters

NameInTypeRequiredDescription
bodybodyCheckOutRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKCheckIn

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

NameInTypeRequiredDescription
bodybodyGetCheckInsRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKCheckInIPagedResponse

Reservation

CreateReservation

POST /Reservation/create

Body parameter

{
"userId": "926d3163ee1ffbbdb47b6a76",
"locationId": "686d3163ee1ffbbdb38b6a74",
"employerId": "184d3163ee1ffbbdb38b6c07",
"reservationDate": "2019-08-24T14:15:22Z",
"userTimeZone": "America/Chicago"
}

Parameters

NameInTypeRequiredDescription
bodybodyCreateReservationRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKReservation
400Bad RequestBad RequestProblemDetails

DeleteReservation

DELETE /Reservation

Body parameter

{
"reservationId": "926d3163ee1ffbbdb47b6a76"
}

Parameters

NameInTypeRequiredDescription
bodybodyDeleteReservationRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKNone

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

NameInTypeRequiredDescription
bodybodyGetReservationsRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKReservationIPagedResponse

Token

GetUserTokenCount

POST /Token/user

Body parameter

{
"userId": "926d3163ee1ffbbdb47b6a76",
"employerId": "184d3163ee1ffbbdb38b6c07",
"fromDate": "2019-08-24T14:15:22Z",
"toDate": "2019-08-24T14:15:22Z"
}

Parameters

NameInTypeRequiredDescription
bodybodyGetUserTokenCountRequestfalsenone

Responses

StatusMeaningDescriptionSchema
200OKOKUserTokenCount

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
}

NameTypeRequiredRestrictionsDescription
idstringtruenoneThe unique identifier for this entity
dateCreatedstring(date-time)truenoneThe initial date this entity was created
dateUpdatedstring(date-time)truenoneThe last time this entity was updated
userIdstringtruenoneZentry Pass User Id
locationIdstringtruenoneZentry Pass Workspace Location Id
workspaceIdstringtruenonenone
employerIdstringtruenoneZentry Pass Employer Id
reservationDatestring(date-time)truenoneThe date of the reservation
timeInstring(date-time)truenoneThe time of check-in
checkInGeoGeofalsenonenone
timeOutstring(date-time)¦nullfalsenoneThe time of check-out
checkOutGeoGeofalsenonenone
checkedInByUserIdstring¦nullfalsenoneThe user that performed the check-in
priceinteger(int64)truenoneThe cost of the location. Stored in cents.
tokenCostinteger(int32)truenoneHow 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
}

NameTypeRequiredRestrictionsDescription
data[CheckIn]trueread-onlyThe paged data
pagedRequestIPagedRequesttruenonenone
totalCountinteger(int32)trueread-onlyThe 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
}

NameTypeRequiredRestrictionsDescription
offsetinteger(int32)truenoneHow far to skip into a collection
limitinteger(int32)truenoneHow many results to return
ids[string]¦nullfalsenoneList of Zentry Pass CheckIn Ids
userIds[string]¦nullfalsenoneList of Zentry Pass User Ids
locationIds[string]¦nullfalsenoneList of Zentry Pass Workspace Location Ids
workspaceIds[string]¦nullfalsenoneList of Zentry Pass Workspace Ids
employerIds[string]¦nullfalsenoneList of Zentry Pass Employer Ids
minimumTimeInstring(date-time)¦nullfalsenoneFilter check-ins with a TimeIn greater than this time
maximumTimeInstring(date-time)¦nullfalsenoneFilter check-ins with a TimeIn less than this time
excludeCheckOutsboolean¦nullfalsenoneUsed to get checkins that have not checked out yet

CheckOutRequest

{
"id": "184d3163ee1ffbbdb38b6c07",
"location": {
"latitude": 38.62,
"longitude": -90.18
}
}

NameTypeRequiredRestrictionsDescription
idstringtruenoneZentry Pass CheckIn Id
locationGeofalsenonenone

CreateCheckInRequest

{
"reservationId": "926d3163ee1ffbbdb47b6a76",
"location": {
"latitude": 38.62,
"longitude": -90.18
}
}

NameTypeRequiredRestrictionsDescription
reservationIdstringtruenoneZentry Pass Reservation Id
locationGeofalsenonenone

CreateReservationRequest

{
"userId": "926d3163ee1ffbbdb47b6a76",
"locationId": "686d3163ee1ffbbdb38b6a74",
"employerId": "184d3163ee1ffbbdb38b6c07",
"reservationDate": "2019-08-24T14:15:22Z",
"userTimeZone": "America/Chicago"
}

NameTypeRequiredRestrictionsDescription
userIdstringtruenoneZentry Pass User Id
locationIdstringtruenoneZentry Pass Workspace Location Id
employerIdstringtruenoneZentry Pass Employer Id
reservationDatestring(date-time)truenoneThe date of the reservation
userTimeZonestringtruenoneThe user's time zone

DeleteReservationRequest

{
"reservationId": "926d3163ee1ffbbdb47b6a76"
}

NameTypeRequiredRestrictionsDescription
reservationIdstringtruenoneZentry Pass Reservation Id

Geo

{
"latitude": 38.62,
"longitude": -90.18
}

NameTypeRequiredRestrictionsDescription
latitudenumber(double)truenonenone
longitudenumber(double)truenonenone

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
}

NameTypeRequiredRestrictionsDescription
anonymousCheckInQueryfalsenonenone

and

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone

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"
}

NameTypeRequiredRestrictionsDescription
anonymousReservationQueryfalsenonenone

and

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone

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

NameTypeRequiredRestrictionsDescription
userIdstringtruenoneZentry Pass User Id
employerIdstringtruenoneZentry Pass Employer Id
fromDatestring(date-time)¦nullfalsenoneLimit token count to reservations and checkins greater than this date. If this is null, then defaults to the start of the month.
toDatestring(date-time)¦nullfalsenoneLimit 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"
]
}
}

NameTypeRequiredRestrictionsDescription
anonymousProblemDetailsfalsenonenone

and

NameTypeRequiredRestrictionsDescription
anonymousobjectfalsenonenone
» additionalPropertiesanyfalsenonenone
» errorsobjecttruenonenone
»» additionalProperties[string]falsenonenone

IPagedRequest

{
"offset": 0,
"limit": 25
}

NameTypeRequiredRestrictionsDescription
offsetinteger(int32)trueread-onlyHow far to skip into a collection
limitinteger(int32)trueread-onlyHow many results to return

ProblemDetails

{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}

NameTypeRequiredRestrictionsDescription
additionalPropertiesanyfalsenonenone
typestring¦nullfalsenonenone
titlestring¦nullfalsenonenone
statusinteger(int32)¦nullfalsenonenone
detailstring¦nullfalsenonenone
instancestring¦nullfalsenonenone

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
}

NameTypeRequiredRestrictionsDescription
idstringtruenoneThe unique identifier for this entity
dateCreatedstring(date-time)truenoneThe initial date this entity was created
dateUpdatedstring(date-time)truenoneThe last time this entity was updated
locationIdstringtruenoneZentry Pass Workspace Location Id
workspaceIdstringtruenoneZentry Pass Workspace Id
userIdstringtruenoneZentry Pass User Id
employerIdstringtruenoneZentry Pass Employer Id
reservationDatestring(date-time)truenoneThe date of the reservation
priceinteger(int64)truenoneThe cost of the location. Stored in cents.
tokenCostinteger(int32)truenoneHow 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
}

NameTypeRequiredRestrictionsDescription
data[Reservation]trueread-onlyThe paged data
pagedRequestIPagedRequesttruenonenone
totalCountinteger(int32)trueread-onlyThe 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"
}

NameTypeRequiredRestrictionsDescription
offsetinteger(int32)truenoneHow far to skip into a collection
limitinteger(int32)truenoneHow many results to return
userIds[string]¦nullfalsenoneList of Zentry Pass User Ids
locationIds[string]¦nullfalsenoneList of Zentry Pass Workspace Location Ids
workspaceIds[string]¦nullfalsenoneList of Zentry Pass Workspace Ids
employerIds[string]¦nullfalsenoneList of Zentry Pass Employer Ids
minimumReservationDatestring(date-time)¦nullfalsenoneFilter reservations with a reservation date greater than this time
maximumReservationDatestring(date-time)¦nullfalsenoneFilter reservations with a reservation date less than this time

UserTokenCount

{
"userId": "string",
"tokenCount": 0
}

NameTypeRequiredRestrictionsDescription
userIdstringtruenonenone
tokenCountinteger(int32)truenonenone