---
title: "Fetch order list"
method: GET
path: "/order/fetch"
tags: ["Orders|Order"]
---

# Fetch order list

`GET /order/fetch`

geoCapture orders are detailed assignments created within the geoCapture system to manage and coordinate field
operations such as service visits, maintenance tasks, or deliveries. Each order is a plan that includes important
details like task descriptions, site locations, assigned staff, timelines, and specific activities, which
ensure the accurate execution of field services.

These orders are crucial in geoCapture's tour planning. Efficient routes are created that optimize the itinerary
of each field team for travel time, service duration, and client priorities. For instance, a geoCapture order
might instruct a team to fit hardware at a new client's office. The order is then used to plot a route for the
day, integrating other service calls along the way to reduce downtime and travel distance and, therefore, boost
productivity whilst decreasing operational expenses. The order ensures that the team brings appropriate equipment
and knowledge, resulting in a prosperous installation within the allotted timeframe.

## Query parameters

- `filter[byIds][]` integer[]
- `filter[byExternalReferences][]` string[]
- `filter[byTourIds][]` integer[]
- `filter[byStatusText]` string
- `filter[byOrderType]` string
- `filter[byBounds]` string
- `filter[byUnassigned]` boolean
- `filter[byProjectIds][]` integer[]
- `filter[byTeamIds][]` integer[]
- `offset` integer
- `limit` integer

## Response `200`

Success Response:

- StandardOrderFetchResponse
  - `data` object[] — The orders.
    - `id` integer — The internal id of the order.
    - `reference` string — The customer order number.
    - `externalReference` string — The internal reference for the order.
    - `subject` string — The order subject.
    - `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 orders. (Only calculated if 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/869b05603541/schema)