v1

latestOpenAPI 3.0.0Proprietary2026-08-06130577659.7 KB

Miscellaneous|Approval

Fetch approval list.

This endpoint provides you a list of requests for various purposes, including vacation, missing time stamps, or bookings. Approvals in geoCapture, for example, are utilized to apply for leave. The individual overseeing approvals (either set at the department level or delegated to the employee) may either accept, reject, request consultation, or provisionally accept the approval. The statuses of CONSULTATION_REQUIRED and PROVISIONALLY_ACCEPTED may be modified to ACCEPT or REJECTED at a later stage.

If the holiday request is approved, the absence will be displayed on the staff calendar as a filled color. If the application is not yet approved, it will display in a dashed pattern on the Employee Calendar, which offers an overview of absences. If the approval is rejected, it will not be displayed on the calendar. The absence calendar offers an outline of absences and is also employed in other parts of geoCapture, including resource planning.

When a stamp is approved, the new stamp will be added to the employee at the requested time. A new booking will be created in geoCapture as soon as a booking has been approved.

get/approval_center/fetch

Query parameters

logs[byAssignee]integer

Filters the approvals by the assignee.

logs[byEmployee]integer

Filters the approvals by the employee.

logs[byStatuses][]string[]

Filters the approvals by the status.

Value	Description
OPEN	Approval open
DONE	Approval done
REJECTED	Approval rejected
CONSULTATION_REQUIRED	Approval requires consultation
PROVISIONALLY_ACCEPTED	Approval provisionally accepted

logs[byObjectType]string

Filters the approvals by the type.

Value	Description
APPROVAL_EMPLOYEE_WORKTIME	If working times from stamps must be approved. Configured in Department
EMPLOYEE_APPLICATION	If the employee submits an application: e.g. absence
CUSTOM_FORM_DATA	If custom forms must be approved: Configured in form definition

logs[byObjectId]integer

Filters the approvals by the object. Can be used only in conjunction with the filter "byObjectType".

offsetinteger

Number of records to skip.

limitinteger

The limit parameter defines the maximum number of records that can be retrieved in a single API request, with a max and default value set at 500 records.

Response

Success Response:

offsetinteger

Number of skipped records.

totalCountinteger

Total number of available approvals. (Calculated only if the offset is 0)

Example response

{
  "data": [
    {
      "date": "2015-02-20",
      "notes": [
        {
          "createdAt": "2015-02-20T12:59:21+01:00"
        }
      ],
      "worktimeData": {
        "date": "2015-02-20",
        "shiftStart": "2015-02-20T12:59:21+01:00",
        "shiftEnd": "2015-02-20T12:59:21+01:00",
        "project": {
          "latLng": [
            52.38127828631681,
            7.594243214018696
          ]
        }
      },
      "applicationData": {
        "absenceData": {
          "from": "2015-02-20",
          "to": "2015-02-20"
        },
        "stampData": {
          "time": "2015-02-20T12:59:21+01:00",
          "project": {
            "latLng": [
              52.38127828631681,
              7.594243214018696
            ]
          }
        },
        "accountingEntryData": {
          "project": {
            "latLng": [
              52.38127828631681,
              7.594243214018696
            ]
          }
        }
      },
      "formData": {
        "latLng": [
          52.38127828631681,
          7.594243214018696
        ]
      },
      "createdAt": "2015-02-20T12:59:21+01:00"
    }
  ]
}