Routes
Parts

This request gets your Parts usage log.

Return data description

PropertyDescription
metaA call which can be used to quickly look up the Task that this part's usage was recorded on.
nameThe name of the part used.
taskIDThe associated Task where this part was used.
usedCountThe number of parts that were used.
usedPriceThe price per 1 part.
usedOnThe date when the part was used. This is a unix timestamp.
poItemIDThe unique ID of the PO item associated with this usage record.
get/v2/parts/usage

Request

Query parameters

partsinteger

This parameter is used to only get specific Parts. This parameter accepts a comma delimited list of part IDs.

tasksstring

This parameter is used to only get Parts at a specific group of Tasks. This parameter accepts a comma delimited list of Task IDs.

startinteger

This parameter is used to only get Parts that were last edited after the unix timestamp passed into the start parameter. For example, all Assets that were last edited after April 18th, 2018.

endinteger

This parameter is used to only get Parts that were last edited before the unix timestamp passed into the end parameter.

namestring

This parameter is used to string search part names either partial or full name with the wildcard %.

cursorinteger

This parameter is a cursor that selects what partID you want to start receiving results at. e.g. passing 137 here will only get you part usage records with an id greater than 137.

limitinteger

This parameter is a result limiter. The default is set to return no more than 100 results at one time. Maximum allowed value is 1000.

Response

Parts Usage

partIDinteger
namestring
taskIDinteger
usedCountinteger
usedPriceinteger
usedOninteger
poItemIDinteger

Changes

    • warning

      for the query request parameter limit, the max was set to 1000.00

    • warning

      for the query request parameter limit, the min was set to 1.00

    • info

      added the non-success response with the status