developer portal

Access Control

Get exceptions

Gets a list of all access schedule exceptions.

Privilege required: Api: Accesscontrol read or Api: Accesscontrol edit

Responses

200OK
[
  {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Office hours",
    "TimeClockIds": [],
    "Dates": [],
    "AccessControl": false,
    "ConstantRelais": false,
    "Pulse": false
  }
]
401Unauthorized
403Forbidden

Update exception

Updates an access schedule exception.

Request body

Responses

200OK
[
  {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Office hours",
    "TimeClockIds": [],
    "Dates": [],
    "AccessControl": false,
    "ConstantRelais": false,
    "Pulse": false
  }
]
401Unauthorized
403Forbidden

Create exception

Creates an access schedule exception.

Request body

Responses

200OK
[
  {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Office hours",
    "TimeClockIds": [],
    "Dates": [],
    "AccessControl": false,
    "ConstantRelais": false,
    "Pulse": false
  }
]
401Unauthorized
403Forbidden

Get exception by Id

Gets an access schedule exception by its Id.

Privilege required: Api: Accesscontrol read or Api: Accesscontrol edit

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Responses

200OK
[
  {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Office hours",
    "TimeClockIds": [],
    "Dates": [],
    "AccessControl": false,
    "ConstantRelais": false,
    "Pulse": false
  }
]
401Unauthorized
403Forbidden

Get access group

Returns an access group by id.

Privilege required: Api: Accesscontrol read or Api: Accesscontrol edit

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Responses

200OK
FieldType
Data(default = null)object
{
  "Data": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  }
}
401Unauthorized
403Forbidden

Delete access group

Deletes an access group.

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Responses

200OK
FieldType
Data(default = null)object
{
  "Data": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  }
}
400BadRequest
FieldType
Entityobject
ValidationResultarray
{
  "Entity": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  },
  "ValidationResult": [
    {
      "Message": "",
      "SourceMemberNames": []
    }
  ]
}
401Unauthorized
403Forbidden
417ExpectationFailed

Update access group

Updates an access group.

Request body

object

FieldTypeRequired
Idstringrequired
Namestringrequired
UserIds(default = [])arrayoptional

Responses

200OK
FieldType
Data(default = null)object
{
  "Data": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  }
}
400BadRequest
FieldType
Entityobject
ValidationResultarray
{
  "Entity": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  },
  "ValidationResult": [
    {
      "Message": "",
      "SourceMemberNames": []
    }
  ]
}
401Unauthorized
403Forbidden
417ExpectationFailed

Create access group

Creates a new access group.

Request body

object

FieldTypeRequired
Namestringrequired
UserIds(default = [])arrayoptional

Responses

200OK
FieldType
Data(default = null)object
{
  "Data": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  }
}
400BadRequest
FieldType
Entityobject
ValidationResultarray
{
  "Entity": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  },
  "ValidationResult": [
    {
      "Message": "",
      "SourceMemberNames": []
    }
  ]
}
401Unauthorized
403Forbidden
417ExpectationFailed

Link users to access group

Links one or more users to an access group.

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Request body

Responses

200OK
FieldType
Data(default = null)object
{
  "Data": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  }
}
400BadRequest
FieldType
Entityobject
ValidationResultarray
{
  "Entity": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  },
  "ValidationResult": [
    {
      "Message": "",
      "SourceMemberNames": []
    }
  ]
}
401Unauthorized
403Forbidden
417ExpectationFailed

Unlink users from access group

Unlinks one or more users from an access group.

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Request body

Responses

200OK
FieldType
Data(default = null)object
{
  "Data": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  }
}
400BadRequest
FieldType
Entityobject
ValidationResultarray
{
  "Entity": {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Everyone",
    "Users": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Code": "012345",
        "Name": "John Doe",
        "Type": 0
      }
    ]
  },
  "ValidationResult": [
    {
      "Message": "",
      "SourceMemberNames": []
    }
  ]
}
401Unauthorized
403Forbidden
417ExpectationFailed

Get access locations

Returns a list of all access locations.

Privilege required: Api: Accesscontrol read or Api: Accesscontrol edit

Responses

200OK
[
  {
    "Id": "00000000-0000-0000-0000-000000000000",
    "Name": "Entrance",
    "Readers": [
      {
        "ReaderId": "00000000-0000-0000-0000-000000000000",
        "ReaderName": "Entrance"
      }
    ],
    "Relais": [
      {
        "RelaisId": "00000000-0000-0000-0000-000000000000",
        "RelaisName": "Entrance"
      }
    ]
  }
]
401Unauthorized
403Forbidden

Get user access

Returns a list of all users that have access to a location.

Privilege required: Api: Accesscontrol read or Api: Accesscontrol edit

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Responses

200OK
[
  {
    "PersonId": "00000000-0000-0000-0000-000000000000",
    "UserId": "00000000-0000-0000-0000-000000000000",
    "ScheduleId": "00000000-0000-0000-0000-000000000000",
    "IsMaster": false
  }
]
401Unauthorized
403Forbidden
417ExpectationFailed

Grant user access

Grants a user access to a location according to a schema. Provide either a user id or person id to identify a user. The user is added to the group {LocationName} - {ScheduleName}. If necessary, a new group is created before granting access.

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Request body

object

FieldTypeRequired
PersonId(default = null) ID of the person that was granted entry.stringoptional
UserId(default = null) ID of the user that was denied entry.stringoptional
AccessScheduleId(default = null) ID of the linked access schedule.stringrequired

Responses

200OK
FieldType
Successboolean
Message(default = null)string
{
  "Success": false,
  "Message": null
}
400BadRequest
FieldType
Successboolean
Message(default = null)string
{
  "Success": false,
  "Message": null
}
401Unauthorized
403Forbidden
417ExpectationFailed

Grant user access (ciaw)

Grants a user access to a location according to a schema. Provide a name to identify a user. Provide either a Limosa number or both Rrn number and VAT number to identify a CIAW person. The user is added to the specified user group, linked to the specified RFID tag and linked to the specified CIAW person. If necessary, a new user, RFID tag and/or user group is created before granting access.

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Request body

object

FieldTypeRequired
LimosaNumber(default = 0) Limosa number, used for foreign employees.numberoptional
RrnNumber(default = 0) Rijksregisternummer, used for Belgian employees.numberoptional
NameName of the person who was granted accessstringrequired
BtwNumber(default = null) VAT numberstringoptional
BadgeNumberBadge number used for this registrationstringrequired
LimosaExpirationDate(default = null)stringoptional
A1ExpirationDate(default = null)stringoptional
VisaExpirationDate(default = null) Date this person's Limosa number expires.stringoptional
OwnStaff(default = false) Whether this employee works for the current company or for a different one.booleanrequired
AddToGroupAdd this user to an access group.stringrequired
AccessScheduleIdID of the linked access schedule.stringrequired

Responses

200OK
FieldType
Successboolean
Message(default = null)string
UserIdstring
PersonIdstring
{
  "Success": false,
  "Message": null,
  "UserId": "00000000-0000-0000-0000-000000000000",
  "PersonId": "00000000-0000-0000-0000-000000000000"
}
400BadRequest
FieldType
Successboolean
Message(default = null)string
UserIdstring
PersonIdstring
{
  "Success": false,
  "Message": null,
  "UserId": "00000000-0000-0000-0000-000000000000",
  "PersonId": "00000000-0000-0000-0000-000000000000"
}
401Unauthorized
403Forbidden
417ExpectationFailed

Deny user access

Denies a user access to a location. Provide either a user id or person id to identify a user. The user is removed from all groups of the location.

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Request body

object

FieldTypeRequired
PersonId(default = null) ID of the person that was denied entry.stringoptional
UserId(default = null) ID of the user that was denied entry.stringoptional

Responses

200OK
FieldType
Successboolean
Message(default = null)string
{
  "Success": false,
  "Message": null
}
400BadRequest
FieldType
Successboolean
Message(default = null)string
{
  "Success": false,
  "Message": null
}
401Unauthorized
403Forbidden
417ExpectationFailed

Remove schedules from access location

Removes a list of schedules from an access location.

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Responses

200OK
FieldType
Successboolean
Message(default = null)string
{
  "Success": false,
  "Message": null
}
400BadRequest
FieldType
Successboolean
Message(default = null)string
{
  "Success": false,
  "Message": null
}
401Unauthorized
403Forbidden
417ExpectationFailed

Get access control schedules by access location

Returns a list of all access control schedules linked to an access location.

Privilege required: Api: Accesscontrol read or Api: Accesscontrol edit

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Responses

200OK
FieldType
Dataarray
{
  "Data": [
    {
      "Schedule": {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Office hours"
      },
      "Groups": [
        {
          "Id": "00000000-0000-0000-0000-000000000000",
          "Name": "Everyone"
        }
      ]
    }
  ]
}
401Unauthorized
403Forbidden

Link access control schedule to access location

Links an access control schedule to an access location.

Path parameters

NameTypeRequiredExample
idstringrequired00000000-0000-0000-0000-000000000000

Request body

object

FieldTypeRequired
ScheduleIdstringrequired
GroupIds(default = [])arrayoptional

Responses

200OK
FieldType
Dataobject
{
  "Data": {
    "Schedule": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "Name": "Office hours"
    },
    "Groups": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Everyone"
      }
    ]
  }
}
400BadRequest
FieldType
Entityobject
ValidationResultarray
{
  "Entity": {
    "Schedule": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "Name": "Office hours"
    },
    "Groups": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Everyone"
      }
    ]
  },
  "ValidationResult": [
    {
      "Message": "",
      "SourceMemberNames": []
    }
  ]
}
401Unauthorized
403Forbidden
417ExpectationFailed

Get access control schedule by access location and id

Returns an access control schedule linked to an access location by id.

Privilege required: Api: Accesscontrol read or Api: Accesscontrol edit

Path parameters

NameTypeRequiredExample
locationIdstringrequired00000000-0000-0000-0000-000000000000
scheduleIdstringrequired00000000-0000-0000-0000-000000000000

Responses

200OK
FieldType
Dataobject
{
  "Data": {
    "Schedule": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "Name": "Office hours"
    },
    "Groups": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Everyone"
      }
    ]
  }
}
401Unauthorized
403Forbidden

Unlink access control schedule from access location

Unlinks an access control schedule from an access location.

Path parameters

NameTypeRequiredExample
locationIdstringrequired00000000-0000-0000-0000-000000000000
scheduleIdstringrequired00000000-0000-0000-0000-000000000000

Responses

200OK
FieldType
Dataobject
{
  "Data": {
    "Schedule": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "Name": "Office hours"
    },
    "Groups": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Everyone"
      }
    ]
  }
}
400BadRequest
FieldType
Entityobject
ValidationResultarray
{
  "Entity": {
    "Schedule": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "Name": "Office hours"
    },
    "Groups": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Everyone"
      }
    ]
  },
  "ValidationResult": [
    {
      "Message": "",
      "SourceMemberNames": []
    }
  ]
}
401Unauthorized
403Forbidden
417ExpectationFailed

Link groups to access control schedule

Links one or more groups to an access control schedule.

Path parameters

NameTypeRequiredExample
locationIdstringrequired00000000-0000-0000-0000-000000000000
scheduleIdstringrequired00000000-0000-0000-0000-000000000000

Request body

Responses

200OK
FieldType
Dataobject
{
  "Data": {
    "Schedule": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "Name": "Office hours"
    },
    "Groups": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Everyone"
      }
    ]
  }
}
400BadRequest
FieldType
Entityobject
ValidationResultarray
{
  "Entity": {
    "Schedule": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "Name": "Office hours"
    },
    "Groups": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Everyone"
      }
    ]
  },
  "ValidationResult": [
    {
      "Message": "",
      "SourceMemberNames": []
    }
  ]
}
401Unauthorized
403Forbidden
417ExpectationFailed

Unlink groups from access schedule

Unlinks one or more groups from an access control schedule.

Path parameters

NameTypeRequiredExample
locationIdstringrequired00000000-0000-0000-0000-000000000000
scheduleIdstringrequired00000000-0000-0000-0000-000000000000

Request body

Responses

200OK
FieldType
Dataobject
{
  "Data": {
    "Schedule": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "Name": "Office hours"
    },
    "Groups": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Everyone"
      }
    ]
  }
}
400BadRequest
FieldType
Entityobject
ValidationResultarray
{
  "Entity": {
    "Schedule": {
      "Id": "00000000-0000-0000-0000-000000000000",
      "Name": "Office hours"
    },
    "Groups": [
      {
        "Id": "00000000-0000-0000-0000-000000000000",
        "Name": "Everyone"
      }
    ]
  },
  "ValidationResult": [
    {
      "Message": "",
      "SourceMemberNames": []
    }
  ]
}
401Unauthorized
403Forbidden
417ExpectationFailed

Get access log

Returns the access log for an access location within a date/time range.

Query parameters

NameTypeRequiredExample
fromDatestringrequired2019-01-25T05:00:00+01:00
toDatestringrequired2019-01-25T22:00:00+01:00
locationstringoptional00000000-0000-0000-0000-000000000000

Responses

200OK
[
  {
    "TimeStamp": "2019-01-25T08:06:45+01:00",
    "UserName": "John Doe",
    "UserId": "00000000-0000-0000-0000-000000000000",
    "LocationName": "Entrance",
    "LocationId": "00000000-0000-0000-0000-000000000000",
    "RelaisName": "Front",
    "ReaderName": "Front",
    "AccessGranted": true,
    "Type": "AccessGranted_MagStripe",
    "BadgeNumber": "00000000"
  }
]
401Unauthorized
403Forbidden