--- title: "Fetch approval list." method: GET path: "/approval_center/fetch" tags: ["Miscellaneous|Approval"] --- # Fetch approval list. `GET /approval_center/fetch` 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. ## Query parameters - `logs[byAssignee]` integer - `logs[byEmployee]` integer - `logs[byStatuses][]` string[] - `logs[byObjectType]` string - `logs[byObjectId]` integer - `offset` integer - `limit` integer ## Response `200` Success Response: - StandardApprovalCenterFetchResponse - `data` object[] — The approvals. - `id` integer — The internal ID. - `assignee` ApprovalCenterFetchResponseEmployeeItem - `id` integer — The internal employee ID. - `reference` string — The personal number. (max. 20 characters) - `cardNumber` string — The driver card number. - `importSource` string — External data source from which this employee originates. (max. 16 characters) - `importKey` string — External ID from the respective data source. (max. 64 characters) - `firstName` string — The first name of the employee. (max. 128 characters) - `lastName` string — The last name of the Employee. (max. 128 characters) - `name` string — This field is deprecated. Please use firstName The complete Name of the Employee If first name or last name is set, name is ignored. - `employee` ApprovalCenterFetchResponseEmployeeItem - `id` integer — The internal employee ID. - `reference` string — The personal number. (max. 20 characters) - `cardNumber` string — The driver card number. - `importSource` string — External data source from which this employee originates. (max. 16 characters) - `importKey` string — External ID from the respective data source. (max. 64 characters) - `firstName` string — The first name of the employee. (max. 128 characters) - `lastName` string — The last name of the Employee. (max. 128 characters) - `name` string — This field is deprecated. Please use firstName The complete Name of the Employee If first name or last name is set, name is ignored. - `date` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `objectType` string — The type of the approval. | Value | Description | |----------------------------|-----------------------------------------------------| | APPROVAL_EMPLOYEE_WORKTIME | The approval is for verifying work time. | | EMPLOYEE_APPLICATION | The approval is an application of an employee. | | CUSTOM_FORM_DATA | The approval is for verifying a form. | - `objectId` integer — The internal ID of the object to be approved. - `status` string — The current status of the approval. | Value | Description | |---------------------------|---------------------------------------------------------------------------------------------------------| | PENDING | The approval is not yet in place and cannot be processed until the previous application is approved. | | OPEN | The approval is open and unprocessed. | | DONE | The approval has been approved. | | DONE_BY_RELATION | The approval was approved by a dependency. | | REJECTED | The approval was rejected. (Only possible for applications) | | WITHDRAWN | The request for the approval was withdrawn. (Only possible for applications). | | CONSULTATION_REQUIRED | The request for the approval requires consultation. (Only possible for applications) | | PROVISIONALLY_ACCEPTED | The application for the approval has been provisionally approved. (Only possible for applications) | - `notes` object[] — The notes of the approval. - `text` string — The note's text. - `createdAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `worktimeData` ApprovalCenterFetchResponseWorktimeDataItem - `date` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `shiftStart` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `shiftEnd` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `project` ApprovalCenterFetchResponseProjectItem - `id` integer — The internal project ID. - `reference` string — The project number. - `importSource` string — External data source from which this project originated. - `importKey` string — External ID from the respective data source. - `name` string — The project name. (max. 255 characters) - `description` string — The project description. - `extraName1` string — The name1 address addition. (max. 255 characters) - `extraName2` string — The name2 address addition. (max. 255 characters) - `extraName3` string — The name3 address addition. (max. 255 characters) - `street` string — The street. - `zipCode` string — The zip code. - `city` string — The city. - `countryCode` string — The two-digit ISO 3166 country code. - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude. - `costCenter` string — The cost center. (max. 64 characters) - `worktime` integer — The work time in seconds. - `applicationData` ApprovalCenterFetchResponseApplicationDataItem - `type` string — The application type. | Value | Description | |----------------------------------|-------------------------------| | EMPLOYEE_ABSENCE | Absence application | | EMPLOYEE_STAMP | Stamp application | | EMPLOYEE_ACCOUNTING_ENTRY | Accounting entry application | - `priority` string — The application's priority. | Value | Description | |----------------------|--------------------| | HIGH | High | | NORMAL | Normal | | LOW | Low | - `absenceData` ApprovalCenterFetchResponseApplicationAbsenceEntryDataItem - `salaryType` ApprovalCenterFetchResponseSalaryTypeItem - `name` string — The name od the salary type. - `type` string — The salary type. - `isVacationSalaryType` boolean — Whether the salary type is the holiday salary type. - `durationType` string — Duration type. | Value | Description | |----------------------|----------------------| | WHOLE_DAY | Whole day | | HALF_DAY | Half a day | | HOURS | Hours | - `from` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `to` string — Represents a date. (ISO 8601) ICU-Format: yyyy-MM-dd - `duration` integer — Absence time per day in seconds. (Only for type HOURS) - `stampData` ApprovalCenterFetchResponseApplicationStampDataItem - `time` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `state` string — Stamp type | Value | Description | |---------------------|--------------------| | S | Start stamp | | E | End stamp | - `tracker` ApprovalCenterFetchResponseTrackerItem - `id` integer — The internal vehicle ID. - `identifier` string — The customer-specific ID. (max. 64 characters) - `inventoryNumber` string — The inventory number. (max. 128 characters) - `licenseNumber` string — The vehicle license plate. (max. 255 characters) - `identificationNumber` string — The vehicle identification number. (max. 24 characters) - `importSource` string — External data source from which this vehicle originates. (max. 64 characters) - `importKey` string — External ID from the respective data source. (max. 64 characters) - `name` string — The vehicle name. (max. 255 characters) - `project` ApprovalCenterFetchResponseProjectItem - `id` integer — The internal project ID. - `reference` string — The project number. - `importSource` string — External data source from which this project originated. - `importKey` string — External ID from the respective data source. - `name` string — The project name. (max. 255 characters) - `description` string — The project description. - `extraName1` string — The name1 address addition. (max. 255 characters) - `extraName2` string — The name2 address addition. (max. 255 characters) - `extraName3` string — The name3 address addition. (max. 255 characters) - `street` string — The street. - `zipCode` string — The zip code. - `city` string — The city. - `countryCode` string — The two-digit ISO 3166 country code. - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude. - `costCenter` string — The cost center. (max. 64 characters) - `accountingEntryData` ApprovalCenterFetchResponseApplicationAccountingEntryDataItem - `salaryType` ApprovalCenterFetchResponseSalaryTypeItem - `name` string — The name od the salary type. - `type` string — The salary type. - `isVacationSalaryType` boolean — Whether the salary type is the holiday salary type. - `value` number — Value. - `valueUnit` string — Value unit. | Value | Description | |----------------------|----------------------| | HOUR | Hours | | DAY | Days | | CURRENCY | Currency | | QUANTITY | Quantity | - `project` ApprovalCenterFetchResponseProjectItem - `id` integer — The internal project ID. - `reference` string — The project number. - `importSource` string — External data source from which this project originated. - `importKey` string — External ID from the respective data source. - `name` string — The project name. (max. 255 characters) - `description` string — The project description. - `extraName1` string — The name1 address addition. (max. 255 characters) - `extraName2` string — The name2 address addition. (max. 255 characters) - `extraName3` string — The name3 address addition. (max. 255 characters) - `street` string — The street. - `zipCode` string — The zip code. - `city` string — The city. - `countryCode` string — The two-digit ISO 3166 country code. - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude. - `costCenter` string — The cost center. (max. 64 characters) - `formData` ApprovalCenterFetchResponseFormDataItem - `id` integer — The internal ID. - `customFormId` string — The internal ID. - `name` string — Name of the form - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude. - `status` string — Status of the form. | Value | Description | |------------|---------------------------------------| | NEW | Freshly created | | FILLED | Filled out form | | REVIEW | Approval pending | | APPROVED | Approved via associated approval rule | | COMPLETED | Manually approved via user | | REJECTED | Rejected via associated approval rule | | RESET | Approval reverted | | DELETED | Deleted | - `createdAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx - `offset` integer — Number of skipped records. - `totalCount` integer — Total number of available approvals. (Calculated only if the offset is 0) --- [API](https://skmtc.net/geocapture/apis/geocapture-api.md) · [All operations](https://skmtc.net/geocapture/apis/geocapture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geocapture/geocapture-api/versions/15839b24c497/schema)