AMCS Group TruxRoute API
The TruxRoute API from AMCS Group — 1 operation(s) for truxroute.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/amcs-group-truxroute-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
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 Specification
openapi: 3.2.0
info:
description: '**Download Trux JSON**
---
# Getting Started
## Document Purpose and Scope
The VisionAI REST API endpoints are technically described in this document.'
title: External Trux Route API
version: external
servers:
- url: https://o1-dev-svc-core.amcsplatform.com/
description: AMCS VisionAI Developer Environment
security:
- cookieAuth: []
tags:
- name: TruxRoute
paths:
/visionai/api/integrator/truxRoutes:
post:
tags:
- TruxRoute
summary: Create or Update Trux Route Information
description: '# Create or Update Trux Route Information
This endpoint allows external systems to submit route information from Trux, which updates associated assets (vehicles) and creates or updates customer address records.
| Parameter | Type | Description |
|-----------------|----------|---------------------------------------------------------------------|
| RouteNumber | long | Route identification number |
| RouteDate | DateTime | Date and time of the route |
| VehicleId | GUID | ID of the vehicle (Asset) performing the route |
| CompanyCode | string | Company code associated with the route |
| CustomerNumber | string | Customer identification number |
| SiteNumber | string | Site identification number |
| ServiceNumber | string | Service type identification number |
| Country | string | Country of the customer address |
| City | string | City of the customer address |
| District | string | District of the customer address |
| Street | string | Street address of the customer |
| PostalCode | string | Postal/ZIP code of the customer address |
| Latitude | double | Latitude coordinate of the customer address |
| Longitude | double | Longitude coordinate of the customer address |
| JobId | string | Job identification for the route |
## Sample API Request
```json
{
"RouteNumber": 12345678901,
"RouteDate": "2026-01-26T08:30:00",
"VehicleId": "B3E43C4D-BC76-4E59-9E2E-25BC33EA2EC4",
"CompanyCode": "COMP123",
"CustomerNumber": "CUST-456789",
"SiteNumber": "SITE-001",
"ServiceNumber": "SVC-789",
"Country": "USA",
"City": "Los Angeles",
"District": "Downtown",
"Street": "123 Main Street",
"PostalCode": "90001",
"Latitude": 34.0522,
"Longitude": -118.2437,
"JobId": "JOB-2026-001"
}
```
## Sample API Response
```json
{
"resource": 1
}
```
## Behavior
- The system finds the asset by `VehicleId` and updates it with `RouteNumber`, `RouteDate`, and `JobId`
- The system finds or creates a customer address record using `CustomerNumber` as the foreign ID
- All address information (location, coordinates, site details) is saved to the customer address record
- The tenant must be configured with Trux sync type for this endpoint to process data
- If the vehicle is not found, a warning is logged but the customer address is still created/updated'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AMCS.IoT.Contamination.Api.Integrator.Trux.ApiTruxRoute'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ApiResourceId'
'400':
$ref: '#/components/responses/BadRequest'
'401':
description: Unauthorized
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiauthTokens500Error'
'501':
$ref: '#/components/responses/NotImplemented'
'502':
$ref: '#/components/responses/BadGateway'
'503':
$ref: '#/components/responses/ServiceUnavailable'
'504':
$ref: '#/components/responses/GatewayTimeout'
operationId: postVisionaiApiIntegratorTruxRoutes
x-operation-id-source: derived
components:
responses:
BadGateway:
description: Bad Gateway - The upstream server returned an invalid response.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Temporary issue with the server. Please try again later.
additionalProperties: false
ServiceUnavailable:
description: Service Unavailable - The server is currently unavailable.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Service is currently unavailable. Please try again later.
additionalProperties: false
BadRequest:
description: Bad Request - Invalid input parameters.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Invalid request. Please check your input parameters.
additionalProperties: false
GatewayTimeout:
description: Gateway Timeout - The server took too long to respond.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: The request timed out. Please try again later.
additionalProperties: false
NotImplemented:
description: This feature is not implemented.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: This feature is not implemented.
additionalProperties: false
Forbidden:
description: Forbidden - Access denied.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: You do not have permission to access this resource.
additionalProperties: false
NotFound:
description: Not Found - The requested resource was not found.
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: The requested resource was not found.
additionalProperties: false
schemas:
AMCS.IoT.Contamination.Api.Integrator.Trux.ApiTruxRoute:
type: object
properties:
isValid:
type: boolean
readOnly: true
id:
type:
- integer
- 'null'
format: int32
readOnly: true
id32:
type: integer
format: int32
readOnly: true
guid:
type:
- string
- 'null'
format: uuid
lastChangeReasonId:
type:
- integer
- 'null'
format: int32
tempIdentifier:
type:
- string
- 'null'
routeNumber:
type:
- integer
- 'null'
format: int64
routeDate:
type:
- string
- 'null'
format: dateTime
example: '2000-01-01 00:00:00.000'
vehicleId:
type: string
format: uuid
companyCode:
type:
- string
- 'null'
customerNumber:
type:
- string
- 'null'
siteNumber:
type:
- string
- 'null'
serviceNumber:
type:
- string
- 'null'
country:
type:
- string
- 'null'
city:
type:
- string
- 'null'
district:
type:
- string
- 'null'
street:
type:
- string
- 'null'
postalCode:
type:
- string
- 'null'
latitude:
type:
- number
- 'null'
format: double
longitude:
type:
- number
- 'null'
format: double
jobId:
type:
- string
- 'null'
additionalProperties: false
ApiResourceStatus:
type: object
properties:
id:
type:
- integer
- 'null'
format: int32
isSuccess:
type: boolean
additionalProperties: false
ApiauthTokens500Error:
type: object
properties:
message:
type:
- string
- 'null'
type:
type:
- string
- 'null'
stackTrace:
type:
- string
- 'null'
additionalProperties: false
ApiResourceErrors:
type: object
properties:
errors:
type:
- string
- 'null'
additionalProperties: false
ApiResourceId:
type: object
properties:
errors:
$ref: '#/components/schemas/ApiResourceErrors'
status:
$ref: '#/components/schemas/ApiResourceStatus'
resource:
type: guid
additionalProperties: false