This API call is used to returns the list of all insured parcel informations.
This API call is made through the GET protocol with the sending of a some arguments. Authentication is required and works with the rules of HTTP basic access authentication.
This API call haven't required argument.
Entry | Data type | Description |
---|---|---|
limit | Int | Pagination limit. Default value: 100. |
start | Int | Pagination offset start. |
order_field | String | Ordering field. Possible values on the bottom list. |
order_dir | String | Ordering direction. Two possible values: "asc" or "desc". Default value: "asc". |
search_field | String | Selected field for search. Possible values on the bottom list. |
search_value | String | Your registered parcel insurance identifier. |
You can make search or ordering with the following fields :
first_name
, last_name
, email
, company
, full_address
, carrier_name
, carrier_code
, tracking_number
, country_origin
, country_destination
, internal_reference
, currency
, parcel_value
, price
, parcel_value_eur
, price_eur
, recipient_email
, order_id
, created_at
.
The response data contains these informations :
Entry | Data type | Description |
---|---|---|
type | String | Object type called by the API request. |
id | String | Registered parcel insurance identifier. |
first_name | String | Customer first name. |
last_name | String | Customer last name. |
String | Customer email address. | |
company | String | Customer company name. |
full_address | String | Customer full address. |
parcel_value | Integer | Total value of the order in currency cents. |
price | Integer | Amount of insurance fees in currency cents. |
currency | String | Currency code used for the insurance. |
parcel_value_eur | Integer | Converted total value of the order in euro cents. |
price_eur | Integer | Converted amount of insurance fees in euro cents. |
invoice_id | String | Returns the related invoice number of the parcel. If isn't exist return null. |
mode | String | Returns if registered parcel is in test mode or in production mode. |
creation | Datetime | Creation date of the insurance order. |
curl https://developer.secursus.com/api/parcels/:id \
-u your_apiKey:your_secretKey
{
"response": {
"success": true,
"status": "200",
"title": "OK",
"detail": "Parcel found."
},
"data": {
"type": "parcel",
"id": "201905-XXXXXXXX",
"attributes": {
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@domain.com",
"company": "John Doe Inc.",
"full_address": "10 test road, SW1A 1AA London, UK",
"parcel_value": 8000,
"price": 500,
"currency": "gbp",
"parcel_value_eur": 9391,
"price_eur": 587,
"invoice_id": null,
"mode": "production",
"creation": "2019-05-25 17:51:51"
}
}
}