---
title: "Fetch project assignment list."
method: GET
path: "/project_assignment/fetch"
tags: ["Projects|Project assignment"]
---

# Fetch project assignment list.

`GET /project_assignment/fetch`

## Query parameters

- `filter[byProjectIds][]` integer[]
- `filter[byTrackerIds][]` integer[]
- `filter[byToolIds][]` integer[]
- `filter[byToolExternalIds][]` string[]
- `filter[fromDate]` string
- `filter[toDate]` string
- `offset` integer
- `limit` integer

## Response `200`

Success Response:

- StandardProjectAssignmentFetchResponse
  - `data` object[] — The project assignments.
    - `id` integer — The id of the project assignment
    - `type` string — | Value | Description | |----------------|-----------------------------| | RELEASE | The given vehicle/tool is assigned to no current project (released) | | FIXED_ASSIGNMENT | The given vehicle/tool is assigned to a fixed project |
    - `assignedProject` StandardProjectAssignmentBaseProjectItem
      - `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.
    - `tracker` StandardProjectAssignmentBaseTrackerItem
      - `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)
    - `tool` StandardToolBaseToolItem
      - `id` integer — The internal id of the tool.
      - `name` string — The name of the tool.
      - `category` string — The name of the tool's category.
      - `serialNumber` string — The serial number of the tool.
      - `inventoryNumber` string — The inventory number of the tool.
      - `externalId` string — The external ID of the tool.
      - `status` string — The status of the tool.
      - `manufacturer` string — The name of the manufacturer of the tool.
      - `vehicleId` string — The id of the assigned locating device if it is a vehicle.
      - `beaconId` string — The id of the assigned locating device if it is a beacon.
      - `currentProject` StandardToolBaseProjectItem
        - `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.
      - `multipleProjectsPossible` boolean — Indicates if multiple current projects were possible.
      - `currentProjectChangedAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
      - `createdAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
      - `licenseNumber` string — The license plate of the tool.
      - `description` string — The description of the tool.
      - `costCenter` string — The Cost Center of the tracker.
      - `beacon` ToolUpsertResponseToolBeaconItem
        - `id` integer — The internal id of the beacon.
        - `name` string — The name of the beacon.
        - `description` string — The description of the beacon.
        - `status` string — The status of the beacon.
        - `currentProjectId` integer — The current project of the beacon.
        - `lastSignalAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
        - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
        - `estimatedPosition` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `tracker` ToolUpsertResponseToolTrackerItem
        - `id` integer — The internal id of the tracker.
        - `name` string — The name of the tracker.
        - `description` string — The description of the tracker.
        - `lastSignalAt` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
        - `latLng` number[] — Represents a geo coordinate. An array of two double values, representing the latitude and longitude.
      - `synchronizeBeacon` boolean — Indicates that the beacon mirrors the device’s metadata. The name, photo, description, and serial number are kept synchronized from the device to the beacon. Whenever any of these fields on the device changes, the beacon is automatically updated accordingly.
    - `from` string — Represents a date and a time. (ISO 8601) ICU-Format: yyyy-MM-dd'T'HH:mm:ssxxx
    - `to` 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 project assignments.

---

[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/869b05603541/schema)