AMCS Group TruxRoute API

The TruxRoute API from AMCS Group — 1 operation(s) for truxroute.

Operations 1

POST /visionai/api/integrator/truxRoutes Create or Update Trux Route Information

Specifications

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.
All 92 tools →

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

amcs-group-truxroute-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Core AccessGroup Trux Route 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: TruxRoute
paths:
  /visionai/api/integrator/truxRoutes:
    post:
      tags:
      - TruxRoute
      summary: Create or Update Trux Route Information
      description: "# Create or Update Trux Route Information\n\nThis endpoint allows external systems to submit route information from Trux, which updates associated assets (vehicles) and creates or updates customer address records.\n\n| Parameter       | Type     | Description                                                         |\n|-----------------|----------|---------------------------------------------------------------------|\n| RouteNumber     | long     | Route identification number                                         |\n| RouteDate       | DateTime | Date and time of the route                                          |\n| VehicleId       | GUID     | ID of the vehicle (Asset) performing the route                      |\n| CompanyCode     | string   | Company code associated with the route                              |\n| CustomerNumber  | string   | Customer identification number                                      |\n| SiteNumber      | string   | Site identification number                                          |\n| ServiceNumber   | string   | Service type identification number                                  |\n| Country         | string   | Country of the customer address                                     |\n| City            | string   | City of the customer address                                        |\n| District        | string   | District of the customer address                                    |\n| Street          | string   | Street address of the customer                                      |\n| PostalCode      | string   | Postal/ZIP code of the customer address                             |\n| Latitude        | double   | Latitude coordinate of the customer address                         |\n| Longitude       | double   | Longitude coordinate of the customer address                        |\n| JobId           | string   | Job identification for the route                                    |\n\n## Sample API Request\n\n```json\n{\n  \"RouteNumber\": 12345678901,\n  \"RouteDate\": \"2026-01-26T08:30:00\",\n  \"VehicleId\": \"B3E43C4D-BC76-4E59-9E2E-25BC33EA2EC4\",\n  \"CompanyCode\": \"COMP123\",\n  \"CustomerNumber\": \"CUST-456789\",\n  \"SiteNumber\": \"SITE-001\",\n  \"ServiceNumber\": \"SVC-789\",\n  \"Country\": \"USA\",\n  \"City\": \"Los Angeles\",\n  \"District\": \"Downtown\",\n  \"Street\": \"123 Main Street\",\n  \"PostalCode\": \"90001\",\n  \"Latitude\": 34.0522,\n  \"Longitude\": -118.2437,\n  \"JobId\": \"JOB-2026-001\"\n}\n```\n\n## Sample API Response\n```json\n{\n  \"resource\": 1\n}\n```\n\n## Behavior\n\n- The system finds the asset by `VehicleId` and updates it with `RouteNumber`, `RouteDate`, and `JobId`\n- The system finds or creates a customer address record using `CustomerNumber` as the foreign ID\n- All address information (location, coordinates, site details) is saved to the customer address record\n- The tenant must be configured with Trux sync type for this endpoint to process data\n- If the vehicle is not found, a warning is logged but the customer address is still created/updated\n"
      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'
components:
  schemas:
    ApiResourceId:
      type: object
      properties:
        errors:
          $ref: '#/components/schemas/ApiResourceErrors'
        status:
          $ref: '#/components/schemas/ApiResourceStatus'
        resource:
          type: guid
      additionalProperties: false
    ApiResourceStatus:
      type: object
      properties:
        id:
          type:
          - integer
          - 'null'
          format: int32
        isSuccess:
          type: boolean
      additionalProperties: false
    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
    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
  responses:
    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
    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
    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
    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
    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
    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