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/trimble:trimble-tickets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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: 3.2.0
info:
title: Vista Material Sales v2 Direct Tickets API
description: For assistance, please visit our Customer Support page.
contact:
name: Customer Support
version: '2'
x-logo:
url: https://cdn.brandfolder.io/IH4HLZST/at/pwwq8z7wf64v8jxbtrgnpwqr/TrimbleR-Horiz-RGB-Blue.png
altText: Trimble logo
servers:
- url: https://{apiHost}/connect/v1/
description: App Xchange API (choose region)
variables:
apiHost:
default: api.xchange.trimble.com
description: Regional API hostname. Application keys and subscriber codes are environment-specific.
enum:
- api.xchange.trimble.com
- api-ap-au.xchange.trimble.com
security:
- {}
tags:
- name: Tickets
paths:
/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache:
get:
tags:
- Tickets
summary: Gets all Tickets objects from the cache
description: 'Tickets.
Vista view: MSTD'
operationId: GET/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache
parameters:
- $ref: '#/components/parameters/subscriber_code'
- $ref: '#/components/parameters/X-Application-Key'
- $ref: '#/components/parameters/limit_continuation'
- $ref: '#/components/parameters/modifiedUTCSince'
- $ref: '#/components/parameters/continuationToken'
responses:
'200':
description: Success
content:
application/json:
schema:
required:
- limit
- data
- next
- continuationToken
type: object
properties:
limit:
type: integer
data:
type: array
items:
$ref: '#/components/schemas/data_tickets_withKeys'
next:
type: string
continuationToken:
type: string
'400':
$ref: '#/components/responses/errorResponse'
'401':
$ref: '#/components/responses/unauth'
'403':
$ref: '#/components/responses/forbidden'
x-operation-id-source: normalized
x-operation-id-original: GET /direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache
/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/search:
post:
tags:
- Tickets
summary: Search through Tickets objects in the data cache
description: 'Tickets.
Vista view: MSTD'
operationId: POST/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/search/search
parameters:
- $ref: '#/components/parameters/subscriber_code'
- $ref: '#/components/parameters/X-Application-Key'
requestBody:
content:
application/json:
schema:
type: object
properties:
modifiedUtcAfter:
maxLength: 28
minLength: 28
type: string
description: 'Returns objects that were modified after the specified date (ISO 8601 format). Format: yyyy-MM-ddThh:mm:ss.fffffffZ. Example ''2019-12-11T20:16:58.3419275Z''. If provided on the first call, the same value must be provided on all subsequent calls as you use the continuation token for the next result set.'
format: date-time
modifiedUtcBefore:
maxLength: 28
minLength: 28
type: string
description: 'Returns objects that were modified before the specified date (ISO 8601 format). Format: yyyy-MM-ddThh:mm:ss.fffffffZ. Example ''2019-12-11T20:16:58.3419275Z''. If provided on the first call, the same value must be provided on all subsequent calls as you use the continuation token for the next result set.'
format: date-time
continuationToken:
type: string
description: Supplying this token will result in retrieving the next chunk of data if the first request contained more than 100 (up to) records or greater than 1 megabyte in size. On your first call, you must omit or provide an empty string. On subsequent calls, provide the continuationToken from the previous result.
filters:
type: array
items:
oneOf:
- required:
- propertyName
- value
- operator
type: object
properties:
propertyName:
type: string
description: Name of the property to apply the filter on. Nested properties are supported with a dot (.) delimiter. E.g. 'PONumber' or 'Sender.LastName'.
value:
type: integer
description: You must match the JSON type value to the propertyName JSON type. There is no type coercion.
operator:
enum:
- Equal
- GreaterThan
- GreaterThanOrEqual
- LessThan
- LessThanOrEqual
- NotEqual
type: string
additionalProperties: false
description: ''
- required:
- propertyName
- value
- operator
type: object
properties:
propertyName:
type: string
description: Name of the property to apply the filter on. Nested properties are supported with a dot (.) delimiter. E.g. 'PONumber' or 'Sender.LastName'.
value:
type: string
description: You must match the JSON type value to the propertyName JSON type. There is no type coercion.
operator:
enum:
- Equal
- GreaterThan
- GreaterThanOrEqual
- LessThan
- LessThanOrEqual
- NotEqual
- Like
- EndsWith
- StartsWith
- Contains
type: string
additionalProperties: false
description: ''
- required:
- propertyName
- value
- operator
type: object
properties:
propertyName:
type: string
description: Name of the property to apply the filter on. Nested properties are supported with a dot (.) delimiter. E.g. 'PONumber' or 'Sender.LastName'.
value:
type: boolean
description: You must match the JSON type value to the propertyName JSON type. There is no type coercion.
operator:
enum:
- Equal
- NotEqual
type: string
additionalProperties: false
description: ''
- required:
- propertyName
- value
- operator
type: object
properties:
propertyName:
type: string
description: Name of the property to apply the filter on. Nested properties are supported with a dot (.) delimiter. E.g. 'PONumber' or 'Sender.LastName'.
value:
type: array
items:
oneOf:
- type: string
- type: number
description: ' This oneOf option is to be used for null values for all data types. You must match the JSON type value to the propertyName JSON type. There is no type coercion.'
operator:
enum:
- In
type: string
additionalProperties: false
description: ''
description: All provided filters are combined with AND conditions. E.g. filter1 AND filter2 AND filter3. Not providing a filter will result in an unfiltered result. Filtering can be performed on nested object properties but can not be performed on array item properties. If provided on the first call, the same value must be provided on all subsequent calls as you use the continuation token for the next result set.
additionalProperties: false
responses:
'200':
description: Success
content:
application/json:
schema:
required:
- count
- data
type: object
properties:
count:
type: integer
data:
type: array
items:
$ref: '#/components/schemas/data_tickets_withKeys'
continuationToken:
type: string
description: Supply this token on the next request to get the next chunk of data. This will have a value if the result set contains more than 100 records or the set is greater than 1 megabyte.
'400':
$ref: '#/components/responses/errorResponse'
'401':
$ref: '#/components/responses/unauth'
'403':
$ref: '#/components/responses/forbidden'
x-operation-id-source: normalized
x-operation-id-original: POST /direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/search/search
/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/{ryvitId_value}:
get:
tags:
- Tickets
summary: Gets one Tickets object from the cache
description: 'Tickets.
Vista view: MSTD'
operationId: GET/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/{ryvitId_value}
parameters:
- $ref: '#/components/parameters/subscriber_code'
- $ref: '#/components/parameters/X-Application-Key'
- name: ryvitId_value
in: path
description: The code of the data object you want to get.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/data_tickets_withKeys'
'401':
$ref: '#/components/responses/unauth'
'403':
$ref: '#/components/responses/forbidden'
'404':
$ref: '#/components/responses/notFound'
x-operation-id-source: normalized
x-operation-id-original: GET /direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/{ryvitId_value}
/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/__ryvitId/{ryvitId_value}:
get:
tags:
- Tickets
summary: Gets one Tickets object from the cache
description: 'Tickets.
Vista view: MSTD'
operationId: GET/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/__ryvitId/{ryvitId_value}
parameters:
- $ref: '#/components/parameters/subscriber_code'
- $ref: '#/components/parameters/X-Application-Key'
- name: ryvitId_value
in: path
description: The code of the data object you want to get.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/data_tickets_withKeys'
'401':
$ref: '#/components/responses/unauth'
'403':
$ref: '#/components/responses/forbidden'
'404':
$ref: '#/components/responses/notFound'
x-operation-id-source: normalized
x-operation-id-original: GET /direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/__ryvitId/{ryvitId_value}
/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/keyid/{KeyID}:
get:
tags:
- Tickets
summary: Gets one Tickets object from the cache
description: 'Tickets.
Vista view: MSTD'
operationId: GET/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/keyid/{KeyID}
parameters:
- $ref: '#/components/parameters/subscriber_code'
- $ref: '#/components/parameters/X-Application-Key'
- name: KeyID
in: path
description: The KeyID portion of the key used to identify the object.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/data_tickets_withKeys'
'401':
$ref: '#/components/responses/unauth'
'403':
$ref: '#/components/responses/forbidden'
'404':
$ref: '#/components/responses/notFound'
x-operation-id-source: normalized
x-operation-id-original: GET /direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/keyid/{KeyID}
/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/natural/{MSCo}/{Mth}/{MSTrans}:
get:
tags:
- Tickets
summary: Gets one Tickets object from the cache
description: 'Tickets.
Vista view: MSTD'
operationId: GET/direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/natural/{MSCo,Mth,MSTrans}
parameters:
- $ref: '#/components/parameters/subscriber_code'
- $ref: '#/components/parameters/X-Application-Key'
- name: MSCo
in: path
description: The MSCo portion of the key used to identify the object.
required: true
schema:
type: string
- name: Mth
in: path
description: The Mth portion of the key used to identify the object.
required: true
schema:
type: string
- name: MSTrans
in: path
description: The MSTrans portion of the key used to identify the object.
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/data_tickets_withKeys'
'401':
$ref: '#/components/responses/unauth'
'403':
$ref: '#/components/responses/forbidden'
'404':
$ref: '#/components/responses/notFound'
x-operation-id-source: normalized
x-operation-id-original: GET /direct/subscribers/{subscriber_code}/vista/ms/2/data/tickets/cache/natural/{MSCo,Mth,MSTrans}
components:
parameters:
X-Application-Key:
name: X-Application-Key
in: header
description: Used to authorize access to the Direct API.
required: true
schema:
type: string
continuationToken:
name: continuationToken
in: query
description: A URL Encoded continuationToken value from a previous GET response. When provided, the next set of results for the original GET will be returned.
schema:
type: string
subscriber_code:
name: subscriber_code
in: path
description: The code of the subscriber that you are making this request for.
required: true
schema:
type: string
modifiedUTCSince:
name: modifiedUTCSince
in: query
description: A string specifies a datetime against which to filter the results. When specified the result will be ordered oldest __modifiedUTC to newest. Example 2019-12-11T20:16:58.3419275Z. Optional. If unspecified, all cached objects will be returned.
schema:
type: string
limit_continuation:
name: limit
in: query
description: Limits the number of records returned by the API, up to a maximum of 1,000. The API may return less than the limit even when more records exist. Always examine the 'next' and 'continuationToken' properties to determine if more records are available.
schema:
type: integer
responses:
errorResponse:
description: Describes issues with the request.
content:
application/json:
schema:
$ref: '#/components/schemas/errorSchema'
unauth:
description: You have not provided a proper X-Application-Key in the header of this request.
notFound:
description: The object with the given ID was not found OR a subscriber with the given URL was not found.
forbidden:
description: The X-Application-Key provided is valid but the key does not have access to this resource.
schemas:
data_tickets_withKeys:
allOf:
- type: object
properties:
__ryvitKeys:
type: array
items:
type: string
description: Array of key paths that can be used to retrieve this object.
example:
- keyid/{KeyID}
__modifiedUTC:
type: string
description: UTC timestamp of when this object was last modified in the cache.
example: '2020-01-01T13:01:01.1234567Z'
- $ref: '#/components/schemas/data_tickets'
errorSchema:
type: object
properties:
error:
type: object
properties:
message:
type: string
details:
type: array
items:
type: object
properties:
target:
title: Describes which field in the request has an issue.
type: string
message:
title: The error message describing the issue.
type: string
data_tickets:
required:
- MSCo
- Mth
- MSTrans
type: object
properties:
MSCo:
type: integer
description: ''
Mth:
type: string
description: 'Format: YYYY-MM-01.'
MSTrans:
type: integer
description: ''
HaulTrans:
type:
- integer
- 'null'
description: ''
SaleDate:
type: string
description: 'Format: YYYY-MM-DD'
Ticket:
maxLength: 10
type:
- string
- 'null'
description: ''
FromLoc:
maxLength: 10
type: string
description: ''
VendorGroup:
type:
- integer
- 'null'
description: ''
MatlVendor:
type:
- integer
- 'null'
description: ''
SaleType:
maxLength: 1
type: string
description: ''
CustGroup:
type:
- integer
- 'null'
description: ''
Customer:
type:
- integer
- 'null'
description: ''
CustJob:
maxLength: 20
type:
- string
- 'null'
description: ''
CustPO:
maxLength: 20
type:
- string
- 'null'
description: ''
PaymentType:
maxLength: 1
type:
- string
- 'null'
description: ''
CheckNo:
maxLength: 10
type:
- string
- 'null'
description: ''
Hold:
enum:
- Y
- N
type: string
description: ''
JCCo:
type:
- integer
- 'null'
description: ''
Job:
maxLength: 10
type:
- string
- 'null'
description: ''
PhaseGroup:
type:
- integer
- 'null'
description: ''
INCo:
type:
- integer
- 'null'
description: ''
ToLoc:
maxLength: 10
type:
- string
- 'null'
description: ''
MatlGroup:
type: integer
description: ''
Material:
maxLength: 20
type: string
description: ''
UM:
maxLength: 3
type: string
description: ''
MatlPhase:
maxLength: 20
type:
- string
- 'null'
description: ''
MatlJCCType:
type:
- integer
- 'null'
description: ''
GrossWght:
pattern: ^[-+]?[0-9]{1,9}(?:.[0-9]{0,3})?$
type: string
description: ''
TareWght:
pattern: ^[-+]?[0-9]{1,9}(?:.[0-9]{0,3})?$
type: string
description: ''
WghtUM:
maxLength: 3
type:
- string
- 'null'
description: ''
MatlUnits:
pattern: ^[-+]?[0-9]{1,9}(?:.[0-9]{0,3})?$
type: string
description: ''
UnitPrice:
pattern: ^[-+]?[0-9]{1,11}(?:.[0-9]{0,5})?$
type: string
description: ''
ECM:
maxLength: 1
type: string
description: ''
MatlTotal:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type: string
description: ''
MatlCost:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type: string
description: ''
HaulerType:
maxLength: 1
type: string
description: ''
HaulVendor:
type:
- integer
- 'null'
description: ''
Truck:
maxLength: 10
type:
- string
- 'null'
description: ''
Driver:
maxLength: 30
type:
- string
- 'null'
description: ''
EMCo:
type:
- integer
- 'null'
description: ''
Equipment:
maxLength: 10
type:
- string
- 'null'
description: ''
EMGroup:
type:
- integer
- 'null'
description: ''
PRCo:
type:
- integer
- 'null'
description: ''
Employee:
type:
- integer
- 'null'
description: ''
TruckType:
maxLength: 10
type:
- string
- 'null'
description: ''
StartTime:
type:
- string
- 'null'
description: 'Format: YYYY-MM-DD'
StopTime:
type:
- string
- 'null'
description: 'Format: YYYY-MM-DD'
Loads:
type: integer
description: ''
Miles:
pattern: ^[-+]?[0-9]{1,9}(?:.[0-9]{0,3})?$
type: string
description: ''
Hours:
pattern: ^[-+]?[0-9]{1,8}(?:.[0-9]{0,2})?$
type: string
description: ''
Zone:
maxLength: 10
type:
- string
- 'null'
description: ''
HaulCode:
maxLength: 10
type:
- string
- 'null'
description: ''
HaulPhase:
maxLength: 20
type:
- string
- 'null'
description: ''
HaulJCCType:
type:
- integer
- 'null'
description: ''
HaulBasis:
pattern: ^[-+]?[0-9]{1,9}(?:.[0-9]{0,3})?$
type: string
description: ''
HaulRate:
pattern: ^[-+]?[0-9]{1,11}(?:.[0-9]{0,5})?$
type: string
description: ''
HaulTotal:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type: string
description: ''
PayCode:
maxLength: 10
type:
- string
- 'null'
description: ''
PayBasis:
pattern: ^[-+]?[0-9]{1,9}(?:.[0-9]{0,3})?$
type: string
description: ''
PayRate:
pattern: ^[-+]?[0-9]{1,11}(?:.[0-9]{0,5})?$
type: string
description: ''
PayTotal:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type: string
description: ''
RevCode:
maxLength: 10
type:
- string
- 'null'
description: ''
RevBasis:
pattern: ^[-+]?[0-9]{1,9}(?:.[0-9]{0,3})?$
type: string
description: ''
RevRate:
pattern: ^[-+]?[0-9]{1,11}(?:.[0-9]{0,5})?$
type: string
description: ''
RevTotal:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type: string
description: ''
TaxGroup:
type:
- integer
- 'null'
description: ''
TaxCode:
maxLength: 10
type:
- string
- 'null'
description: ''
TaxType:
type:
- integer
- 'null'
description: ''
TaxBasis:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type: string
description: ''
TaxTotal:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type: string
description: ''
DiscBasis:
pattern: ^[-+]?[0-9]{1,9}(?:.[0-9]{0,3})?$
type: string
description: ''
DiscRate:
pattern: ^[-+]?[0-9]{1,11}(?:.[0-9]{0,5})?$
type: string
description: ''
DiscOff:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type: string
description: ''
TaxDisc:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type: string
description: ''
Void:
enum:
- Y
- N
type: string
description: ''
MSInv:
maxLength: 10
type:
- string
- 'null'
description: ''
APRef:
maxLength: 30
type:
- string
- 'null'
description: ''
VerifyHaul:
enum:
- Y
- N
type: string
description: ''
BatchId:
type: integer
description: ''
InUseBatchId:
type:
- integer
- 'null'
description: ''
AuditYN:
enum:
- Y
- N
type: string
description: ''
Purge:
enum:
- Y
- N
type: string
description: ''
Changed:
enum:
- Y
- N
type: string
description: ''
ReasonCode:
maxLength: 10
type:
- string
- 'null'
description: ''
ShipAddress:
maxLength: 60
type:
- string
- 'null'
description: ''
City:
maxLength: 30
type:
- string
- 'null'
description: ''
State:
maxLength: 4
type:
- string
- 'null'
description: ''
Zip:
maxLength: 12
type:
- string
- 'null'
description: ''
UniqueAttchID:
maxLength: 36
minLength: 36
pattern: '[0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}'
type:
- string
- 'null'
description: ''
APCo:
type:
- integer
- 'null'
description: ''
APMth:
type:
- string
- 'null'
description: 'Format: YYYY-MM-01.'
MatlAPCo:
type:
- integer
- 'null'
description: ''
MatlAPMth:
type:
- string
- 'null'
description: 'Format: YYYY-MM-01.'
MatlAPRef:
maxLength: 30
type:
- string
- 'null'
description: ''
Country:
maxLength: 2
type:
- string
- 'null'
description: ''
KeyID:
type: integer
description: ''
SurchargeKeyID:
type:
- integer
- 'null'
description: ''
SurchargeCode:
type:
- integer
- 'null'
description: ''
HaulPayTaxCode:
maxLength: 10
type:
- string
- 'null'
description: ''
HaulPayTaxRate:
pattern: ^[-+]?[0-9]{1,11}(?:.[0-9]{0,5})?$
type:
- string
- 'null'
description: ''
HaulPayTaxAmt:
pattern: ^[-+]?[0-9]{1,10}(?:.[0-9]{0,2})?$
type:
- string
- 'null'
description: ''
HaulPayTaxType:
type:
- integer
- 'null'
description: ''
HaulAPTLKeyID:
type:
- integer
- 'null'
description: ''
MatlAPTLKeyID:
type:
- integer
- 'null'
description: ''
__custom_fields:
type: object
description: This property will be added if there are any custom fields defined for this object in Vista. Each custom field will be a property of this object.