Please check the API Reference for all technical details about the API.
The listing of orders requires authorization and needs to be executed on the backend.
Authorization
35up uses the standard HTTP authorization, based on base64 encoding.
Header: Authorization
Value: basic username:password (base64 encoded)
Most tools and libraries will automatically handle this process.
Get a List of Orders
To get a list of all orders, you need to make an authorized GET request to:
https://api.35up.io/v1/orders
The response provides you with a list of orders:
{
"orders": [
{
"id": "42CA346434",
"status": "approved",
"updatedAt": "1603375967",
"createdAt": "1603375967"
}
]
}
- ID: Unique ID of your 35up order. Best practice is to keep this order ID in your database
- Status: Status of the order.
- UpdatedAt: Timestamp of when the order was updated for the last time.
- CreatedAt: Timestamp of when the order was created for the last time.
Status
An order can have one of the following statuses:
- Pending: The default state of a created order; awaits status update to proceed.
- Approved: Order has been approved and will be processed.
- Processing: Order is processing on the vendor side.
- Fulfilled: Vendor shipped the order.
- Delivered: Order arrived to the customer. Status either triggered by tracking or time.
- Pending_cancellation: A cancellation was requested.
- Cancelled: A cancellation was performed.
- Closed: Final state; the order is closed. Status either triggered by time or cancellations.
Get detailed order information.
Based on the ID from the Get Orders request, you can get detailed information about a single order with a GET orders/ID request:
https://api.35up.io/v1/orders/{id}
The response body includes all necessary information:
{
"id": "42CA346434",
"status": "approved",
"partner": {
"id": "yourshop"
},
"customer": {
"firstName": "Jeffrey",
"lastName": "Bazos",
"email": "jeffrey@nile.com",
"phone": "001384859590"
},
"shippingAddress": {
"firstName": "Jeffrey",
"lastName": "Bazos",
"email": "jeffrey@nile.com",
"phone": "001384859590",
"company": "Nile",
"street": "Monopoly Street",
"streetNumber": "66",
"extra": "Top Floor",
"city": "Seattle",
"postcode": "98121",
"state": "WA",
"country": "US"
},
"items": [
{
"id": "5f91935facffbdf7b8c6b347",
"sku": "caseable/HC12PXX127030XXAPIP2P",
"qty": 2,
"status": "approved",
"updatedAt": "1603375967",
"createdAt": "1603375967"
}
],
"updatedAt": "1603375967",
"createdAt": "1603375967"
}
General Information
- ID: Unique id of your 35up order. Best practice is to keep this order ID in your database.
- Status: Status of the order.
- UpdatedAt: Timestamp of when the order was updated for the last time.
- CreatedAt: Timestamp of when the order was created for the last time.
- Partner: Your own shop identifier.
Customer information
- FirstName: Your customer’s first name
- LastName: Your customer’s last name
- Email: Your customer’s email address
- Phone: Your customer’s phone number (optional)
Shipping Address
The shipping address is crucial. Please make sure you always provide the correct information to avoid unhappy customers and additional costs.
- Firstname, lastname, email, phone: These values are optional if they are the same as the information provided under "customer."
- Company: Optional, if the order should be shipped to a company.
- Street: Street name to which the order should be shipped
- StreetNumber: Street number to which the order should be shipped
- Extra: Additional address line, if needed
- City: City to which the order should be shipped
- Postcode: The city's postcode
- State: State to which the order should be shipped in the US and Canada. Please use the two-digit ISO code (ISO 3166-1 alpha-2).
- Country: Country to which the order should be shipped. Please use the two-digit ISO code (ISO 3166-1 alpha-2).
Product Items
The items array provides information about which product should be ordered in what quantity:
- ID: The order’s unique vendor ID
- SKU: Unique product identifier
- QTY: Quantity of the product to be ordered
- Status: Status of the order for that specific item
- UpdatedAt: Timestamp of when the order was updated for that specific item for the last time
- CreatedAt: Timestamp of when the order was created for that specific item for the last time