AMCS Group ApiTripExternal API
The ApiTripExternal API from AMCS Group — 1 operation(s) for apitripexternal.
The ApiTripExternal API from AMCS Group — 1 operation(s) for apitripexternal.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/amcs-group-apitripexternal-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Core AccessGroup API Trip External API
version: core
servers:
- url: https://rstapi-sbx-svc-core.amcsplatform.com/erp/api/integrator/erp
description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: ApiTripExternal
paths:
/integrator/trips/changes:
get:
tags:
- ApiTripExternal
summary: Get List of Completed Trip Changes
description: '# Get List of Completed Trip Changes
Retrieves completed trips with their associated vehicle information and trip summaries. This endpoint supports incremental data extraction by tracking changes using SQL Server''s row version mechanism.
---
## Query Parameters
| Parameter | Type | Required | Description |
|-----------|--------|----------|-----------------------------------------------------------------------------|
| since | string | No | Base64-encoded row version (from `@@DBTS`). Only returns trips changed after this version. **Must be URL-encoded.** |
| cursor | string | No | Pagination cursor for retrieving next page of results (not used with row version tracking). |
---
## Authentication
Requires authentication via the standard authentication mechanism. The tenant context is automatically determined from the authenticated user.
---
## Output Structure
### Main Response Object
| Property | Type | Description |
|----------|-------------------------------|------------------------------------------------|
| Resource | List\<ApiTripExternalDto\> | List of completed trips with summaries. |
| Extra | object | Additional pagination information (if needed). |
---
### ApiTripExternalDto Object
| Property | Type | Description |
|--------------|-------------------|-------------------------------------------------------|
| VehicleId | Guid? | Unique identifier for the vehicle (Asset GUID). |
| VehicleName | string | Name of the vehicle. |
| TripId | int | Unique identifier for the trip. |
| StartTime | DateTimeOffset | Trip start timestamp. |
| EndTime | DateTimeOffset? | Trip end timestamp. |
| Status | int | Trip status (0=Started, 1=Completed, 2=Invalid). |
| TripSummary | ApiTripSummary | Calculated trip summary with metrics. |
---
### ApiTripSummary Object
| Property | Type | Description |
|----------------------------------|---------|--------------------------------------------------------------|
| TripId | int | Trip identifier. |
| TotalTripMileage | double | Total mileage covered during the trip. Unit of Measure - KM |
| TotalPloughEnabledMileage | double | Mileage covered while plough was enabled. Unit of Measure - KM |
| TotalSpreaderEnabledMileage | double | Mileage covered while spreader was enabled. Unit of Measure - KM |
| SpreaderWidth | double | Spreader width setting. Unit of Measure - Meters |
| TotalSolidMaterialDelivered | double | Total solid material delivered during the trip. Unit of Measure - KG |
| TotalPrewetMaterialDelivered | double | Total prewet material delivered during the trip. Unit of Measure - Liters |
| TotalTripDuration | double | Total trip duration in minutes. Unit of Measure - Minutes |
---'
parameters:
- name: since
in: query
required: false
schema:
type: string
description: Must be URL-encoded.
- name: cursor
in: query
required: false
schema:
type: string
description: Pagination cursor for retrieving next page of results.
responses:
'200':
description: Successful response with completed trip changes.
content:
application/json:
schema:
$ref: '#/components/schemas/TripChangesResponse'
'400':
description: Invalid request parameters.
'401':
description: Unauthorized - authentication required.
'500':
description: Internal server error.
components:
schemas:
ApiTripExternalDto:
type: object
properties:
VehicleId:
type:
- string
- 'null'
format: uuid
description: Unique identifier for the vehicle (Asset GUID).
VehicleName:
type:
- string
- 'null'
description: Name of the vehicle.
TripId:
type: integer
format: int32
description: Unique identifier for the trip.
StartTime:
type: string
format: date-time
description: Trip start timestamp.
EndTime:
type:
- string
- 'null'
format: date-time
description: Trip end timestamp.
Status:
type: integer
format: int32
description: Trip status (0=Started, 1=Completed, 2=Invalid).
TripSummary:
$ref: '#/components/schemas/ApiTripSummary'
description: Calculated trip summary with metrics.
ApiTripSummary:
type: object
properties:
TripId:
type: integer
format: int32
description: Trip identifier.
TotalTripMileage:
type: number
format: double
description: Total mileage covered during the trip. Unit of Measure - Liters
TotalPloughEnabledMileage:
type: number
format: double
description: Mileage covered while plough was enabled. Unit of Measure - Meters
TotalSpreaderEnabledMileage:
type: number
format: double
description: Mileage covered while spreader was enabled. Unit of Measure - Meters
SpreaderWidth:
type: number
format: double
description: Spreader width setting. Unit of Measure - Meters
TotalSolidMaterialDelivered:
type: number
format: double
description: Total solid material delivered during the trip. Unit of Measure - KG
TotalPrewetMaterialDelivered:
type: number
format: double
description: Total prewet material delivered during the trip. Unit of Measure - Liters
TotalTripDuration:
type: number
format: double
description: Total trip duration in minutes. Unit of Measure - Minutes
TripChangesResponse:
type: object
properties:
Resource:
type: array
items:
$ref: '#/components/schemas/ApiTripExternalDto'
Extra:
type:
- object
- 'null'