Retrieve Orders API (1.0.0)
Download OpenAPI specification:Download
Based on a user's permission, a user may be able to view their own orders or also the orders from all of the users in their organization. These orders can be filtered by product type, order status, location, or date range. Only orders from the past 12 months will be returned.
Retrieve order permissible IBX locations
The API returns locations (IBXs and Cages) where the user's organization has a presence. The user may be able to view orders related to these locations, depending on their permissions.
header Parameters
Authorization required | string Specify the Access token with prefix 'Bearer'. |
Responses
Response Schema: application/json
object (IBX Detail (Locations Endpoint)) | |||||||||||||||||
| |||||||||||||||||
cages | Array of strings |
Response samples
- 200
- 400
- 403
- 500
[- {
- "ibx": {
- "code": "AT1",
- "metro": "AT",
- "region": "AMER",
- "country": "United States of America",
- "city": "Atlanta",
- "state": "GA",
- "address": "180 Peachtree Street NW, 2nd, 3rd and 6th Floors",
- "postalCode": "30303"
}, - "cages": [
- "SV1:01:0101"
]
}
]
Search Orders History
Based on filtering criteria, this method returns a list of orders from the last 12 months for IBX locations where the user has permissions.
header Parameters
Authorization required | string Specify the Access token with prefix 'Bearer'. |
Request Body schema: application/json
object (Retrieve Order filters) | |||||||||||||
| |||||||||||||
source | Array of strings Items Enum: "ORDER_NUMBER" "PO_NUMBER" "CUSTOMER_REFERENCE_NUMBER" "CONTACT_LAST_NAME" "SR_NUMBER" "TROUBLE_TICKET_NUMBER" "WORK_ACTIVITY_NUMBER" ORDER_NUMBER: Search by order number(1-123456789). | ||||||||||||
q | string Query value to be queried against source values(Or operation against all sources). | ||||||||||||
Array of objects (Sort) | |||||||||||||
Array
| |||||||||||||
object (Page Request) | |||||||||||||
|
Responses
Response Schema: application/json
Array of objects (Order Header) | |||||||||||||||||||||
Array
| |||||||||||||||||||||
Array of objects (Link) | |||||||||||||||||||||
Array
| |||||||||||||||||||||
object (Orders Response Page Details) | |||||||||||||||||||||
|
Request samples
- Payload
{- "filters": {
- "orderStatus": [
- "PENDING_QA",
- "IN_PROGRESS",
- "PARTIAL_SUBMISSION"
], - "productTypes": [
- "SMART_HANDS"
], - "ibxs": [
- "SV1"
], - "fromDate": "05/01/2018",
- "toDate": "05/02/2018"
}, - "source": [
- "ORDER_NUMBER"
], - "q": "1-123456789",
- "sorts": [
- {
- "name": "ORDERING_CONTACT",
- "direction": "ASC"
}
], - "page": {
- "number": 0,
- "size": 25
}
}
Response samples
- 200
- 400
- 403
- 500
{- "content": [
- {
- "orderNumber": "1-12345678",
- "type": [
- "Cross Connect, Smart Hands"
], - "orderStatus": "SUBMITTED",
- "createdAt": "2019-07-02T22:01:50Z",
- "account": {
- "number": 136008,
- "name": "Service Corporation"
}, - "orderingContact": {
- "name": "John Doe",
- "email": "johnDoe@test.com",
- "phone": "+1 408 123 1234"
}, - "notificationContact": {
- "name": "John Doe",
- "email": "johnDoe@test.com",
- "phone": "+1 408 123 1234"
}, - "ibx": [
- "SV1"
], - "customerReferenceNumbers": [
- "cust-100"
],
}
], - "page": {
- "size": "25",
- "totalElements": "160",
- "totalPages": "7",
- "number": "0"
}
}