Skip to content

Retrieve all hardware provisioning orders and their current status

Request

Search and list hardware provisioning orders visible to the caller. Results are paginated; use page and perPage to iterate and x-total-count for the total matching set.

Responses from this endpoint are not fully hydrated (for example, node details are omitted).

Requires orders::read permission.

Security
JWTAuthorizer
Query
assigneestring

Filter by assigned Trustgrid user

creatorstring

Filter by order creator user ID

projectIDstring

Filter by project ID

prioritystring(Order Priority)

Filter by priority

Enum:"normal""high""urgent"
statusstring(Order Status)

Filter by status

Enum:"new""on hold per client""gathering info""pending feedback""info received""provisioning""qa""shipped""delivered""installed"
excludeStatusstring(Order Status)

Exclude orders with this status

Enum:"new""on hold per client""gathering info""pending feedback""info received""provisioning""qa""shipped""delivered""installed"
transition-statusstring

Status value to count transitions for

transition-frominteger, (int64)

Start of transition window (unix timestamp)

transition-tointeger, (int64)

End of transition window (unix timestamp; defaults to now)

labelstring

Filter by label

qstring

Free-text search across the order

pageinteger

Page number

perPageinteger

Number of orders per page

sortstring

Sort field and direction (e.g. createdAt:desc)

createdAfterstring, (date-time)

Include orders created at or after this RFC3339 timestamp

createdBeforestring, (date-time)

Include orders created before this RFC3339 timestamp

curl -i -X GET \
  'https://apidocs.trustgrid.io/_mock/provisioning/api/v1/orders?assignee=string&creator=string&projectID=string&priority=normal&status=new&excludeStatus=new&transition-status=string&transition-from=0&transition-to=0&label=string&q=string&page=0&perPage=0&sort=string&createdAfter=2019-08-24T14%3A15%3A22Z&createdBefore=2019-08-24T14%3A15%3A22Z' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Headers
x-total-countinteger

Total number of orders matching the query

Bodyapplication/json
Array [
address1string
address2string
applianceTypestring
assigneestring

Trustgrid user assigned to the order

attachmentsArray of objects(Order Attachment)

Files attached to the order

attnstring
carrierCodestring

Shipping carrier code

cellProviderstring
citystring
clonedFromIdstring

UID of the original order if this order is a clone

clonedFromOrderNumberinteger

Order number of the original order if this order is a clone

clusterIpstring
commentsArray of objects(Order Comment)

Comments on the order

companyNamestring
contactEmailstring
contactNamestring
contactPhonestring
createdAtstring, (date-time)

Timestamp when the order was created

creatorstring

User ID of the order creator

customobject

Custom key-value fields

customerRefNumstring
dataPlanstring
dns1string

Legacy primary DNS

dns2string

Legacy secondary DNS

dueDatestring
endUserAccountNumstring
failoverTypestring
flaggedboolean
haboolean

True when this order is for an HA pair

interfacesCountnumber, [ 1 .. 2 ]

Number of interfaces to configure per node

labelsArray of strings

Labels attached to the order

locationNamestring
natsArray of objects
noBillboolean

Whether the order should not be billed

nodeCountnumber, [ 1 .. 2 ]

Number of nodes needed to fulfill order

nodesArray of objects
notesstring
orderNumnumber

System-wide unique order number

orgIdstring

Organization ID

orgNamestring

Organization display name

prioritystring(Order Priority)

Order priority

Enum:"normal""high""urgent"
projectIDstring

Associated project ID

rackMountsboolean

Whether rack mounts are requested

rmaboolean

Whether this order is an RMA

shippedDatestring, (date-time)

Timestamp when the order shipped

shippingCompanyNamestring
shippingContactEmailstring
shippingStatusstring

Carrier shipping status

shipStationOrderIdinteger

ShipStation order ID

siteNamestring
siteTypestring

Site deployment type

Enum:"primary""secondary""test"
stakeholdersArray of objects(Order Stakeholder)

Order stakeholders

statestring
statusstring(Order Status)

Order status. API-side holistic validations apply to orders whose status is in provisioning, qa, shipped, delivered, installed, and in production.

Enum:"new""on hold per client""gathering info""pending feedback""info received""provisioning""qa""shipped""delivered""installed"
summarystring
technicalContactEmailstring
technicalContactNamestring
technicalContactPhonestring
tgNotesstring

Trustgrid-internal notes (visible only to users with trustgrid::order-notes)

trackingNumberstring

Carrier tracking number

transitionsArray of objects(Order Transition)

Status transition history

uidstring
validationsobject(Order Validation)

Live validation results for the order

zipstring
]
Response
[
  {
    "address1": "string",
    "address2": "string",
    "applianceType": "string",
    "assignee": "string",
    "attachments": [ … ],
    "attn": "string",
    "carrierCode": "string",
    "cellProvider": "string",
    "city": "string",
    "clonedFromId": "string",
    "clonedFromOrderNumber": 0,
    "clusterIp": "string",
    "comments": [ … ],
    "companyName": "string",
    "contactEmail": "string",
    "contactName": "string",
    "contactPhone": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "creator": "string",
    "custom": { … },
    "customerRefNum": "string",
    "dataPlan": "string",
    "dns1": "string",
    "dns2": "string",
    "dueDate": "string",
    "endUserAccountNum": "string",
    "failoverType": "string",
    "flagged": true,
    "ha": true,
    "hyperlinks": [ … ],
    "interfacesCount": 1,
    "labels": [ … ],
    "locationName": "string",
    "nats": [ … ],
    "noBill": true,
    "nodeCount": 1,
    "nodes": [ … ],
    "notes": "string",
    "orderNum": 0,
    "orgId": "string",
    "orgName": "string",
    "priority": "normal",
    "projectID": "string",
    "rackMounts": true,
    "rma": true,
    "shippedDate": "2019-08-24T14:15:22Z",
    "shippingCompanyName": "string",
    "shippingContactEmail": "string",
    "shippingStatus": "string",
    "shipStationOrderId": 0,
    "siteName": "string",
    "siteType": "primary",
    "stakeholders": [ … ],
    "state": "string",
    "status": "new",
    "summary": "string",
    "technicalContactEmail": "string",
    "technicalContactName": "string",
    "technicalContactPhone": "string",
    "tgHyperlinks": [ … ],
    "tgNotes": "string",
    "trackingNumber": "string",
    "transitions": [ … ],
    "uid": "string",
    "validations": { … },
    "zip": "string"
  }
]