Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
On this page
Table of Contents |
---|
Shipment list
Search for shipments is done by specifying one or more of the following criteria
Info |
---|
Attention! Debit clients We don't return rates for debit customers. The |
Code Block |
---|
GET /v1/organizations/:organization_id/shipments |
Search criteria
Parameter | Type | Description | Example |
---|---|---|---|
| Integer Array | Searches for shipments with given id. Searches for shipments with given ids. |
|
| Date | Searches for shipments created on the day of the parameter. |
|
| Time | Searches for shipments created after given date. Date can be in ISO 8601 format or similar, or a timestamp. |
|
| Time | Searches for shipments created before given date. Date can be in ISO 8601 format or similar, or a timestamp. |
|
| String | Searches for shipments with tracking number matching the string exactly |
|
| String | Searches for shipments with the tracking number, including the given string |
|
| String Array | Searches for shipments with given statuses. Searches for shipments with statuses matching any of the given statuses. |
|
| String Array | Searches for shipments with given service. Searches for shipments with services matching any of the given services. |
|
| String Array | Searches for shipments with given carrier. Searches for shipments with carriers matching any of the given carriers. |
|
| Number | Searches for shipments with insurance equal or higher to the given number |
|
| Number | Searches for shipments with insurance equal or lower to the given number |
|
| Number | Searches for shipments with cod equal or higher to the given number |
|
| Number | Searches for shipments with cod equal or lower to the given number |
|
| String | Searches for shipments for which the receiver first_name, last_name or company_name starts with the given string |
|
| String | Searches for shipments for which receiver address starts with the given string |
|
| String | Searches for shipments with receivers city matching the given string |
|
| String | Searches for shipments which receivers postal code starts with the given string |
|
| String | Searches for shipments with receivers country code matching the given string |
|
| String | Searches for shipments with receivers telephone number matching the given string |
|
| String | Searches for shipments which receivers email starts with the given string |
|
| String | Searches for shipments for which the sender first_name, last_name or company_name starts with the given string |
|
| String | Searches for shipments for which sender address starts with the given string |
|
| String | Searches for shipments with sender city matching the given string |
|
| String | Searches for shipments which sender postal code starts with the given string |
|
| String | Searches for shipments with sender country code matching the given string |
|
| String | Searches for shipments with sender telephone number matching the given string |
|
| String | Searches for shipments which sender email starts with the given string |
|
| String | Searches for shipments for which the status is on the list: dispatched_by_sender, collected_from_sender, taken_by_courier, adopted_at_source_branch, sent_from_source_branch, |
|
| String | Searches for shipments created by a broker for which the id is identical to the given string |
|
| String Array | Searches for shipments with given sending method. Searches for shipments with statuses matching any of the given sending methods. |
|
| Boolean | Searches for shipments that have the |
|
| String | Searches for shipments with given offer status |
|
Result sorting
Search result sorting can be facilitated using the sort_by
attribute, which can take the following values:
sort_by value | Description | Example |
---|---|---|
| Sorts by id |
|
| Sorts by creation date and time |
|
| Sorts by tracking number |
|
| Sorts by service |
|
| Sorts by status |
|
| Sorts by insurance amount |
|
| Sorts by cod amount |
|
| Sorts by brokers external customer id |
|
Sort ordering can be set using sort_order
attribute. By default, the results are sorted in descending order using the created_at
field.
sort_order value | Description | Example |
---|---|---|
| Sorts in ascending order |
|
| Sorts in descending order |
|