# Get Rates
## Get Rates
`POST` `https://api-sandbox.shiplemon.com/v1/rates`
This method returns all the rates available in order to create a shipment
#### Request Body
| Name | Type | Description |
| ------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| items | array | This is an array that describes more details about the items that will be sent in the shipment and that you want to get rates for.
Each item in this array is an object in the following format (all the dimensions are in cm and the weight in grams)
For domestic and EU shipments the value parameter is optional.
{"weight":1000,
"height":20,
"width":20,
"length":20,
"value":20,
"notes":"nike air max"}
|
| address\_from | object | This object describes where the pickup of the item will happen. This is the starting point (point A) of the shipment.
This object requires the following details:
{"country": "GR","zip": "14451"}
OR
{"country": "AE","city": "Dubai"}
In cases where zip is available, zip is required. If country doesn't support zip code or postal code, then the city parameter is required.
Here's a list that we adhere to for zip rules per country:
In the country parameter we accept the ALPHA-2 code format. You can find more here:
)
|
| address\_to | object | The same format as the address\_from in order to define the destination of the shipment (point B) |
{% tabs %}
{% tab title="200 " %}
```
```
{% endtab %}
{% endtabs %}
## Specific examples per language
{% tabs %}
{% tab title="cURL" %}
```
curl --location --request POST 'https://api-sandbox.shiplemon.com/v1/rates' \
--header 'x-api-key: ' \
--header 'Content-Type: application/json' \
--data-raw '{
"address_from": {
"country": "GR",
"zip": "14451"
},
"address_to": {
"country": "DE",
"zip": "81667"
},
"items": [
{
"weight": 2000,
"height": 10,
"width": 10,
"length": 10,
"notes": "",
"value": 20
}
]
}'
```
{% endtab %}
{% endtabs %}
## Example data for request
* Weight : Weight of package in grams (int)
* Height : Height of package in cm (int)
* Width : Widht of package in cm (int)
* Lenght : Length of package in cm (int)
* Value : Value of package in designated currency (int)
* Currency : Designated currency. Supports all of ISO currency strings. Default is EUR
```
{
"items": [
{
"weight": 3000,
"height": 10,
"width": 30,
"length": 20,
"notes": "Nike air max",
"value": 10,
"currency": "EUR"
}
],
"address_from": {
"country": "GR",
"zip": "11111",
"name": "John Doe",
"state": "I",
"city": "Athens",
"address": "Jane Street 1",
"email": "john@mail.com",
"phone": "+3000000000",
"notes": ""
},
"address_to": {
"name": "SG2",
"country": "GR",
"state": "I",
"city": "Athens",
"zip": "11111",
"address": "Jane Street 2",
"email": "mary@mail.com",
"phone": "+3000000000"
}
}
```
## Example response
Returns an array of rates for each carrier.
```
{
"id": "dhl_N_eea60867-02d5-4795-b27d-87f85685465c",
"friendly_name": null,
"driver": "dhl",
"provider": {
"name": "DHL Express",
"image": "https://static.shiplemon.com/providers/dhl.svg"
},
"service": {
"code": "dhl_express_domestic",
"name": "Domestic Express",
"estimated_delivery_in_days": 4
},
"total_amount": 11.47,
"total_without_tax_amount": 9.25,
"tax_amount": 2.22,
"currency": "EUR",
"has_cash_on_delivery": false,
"has_custom_credentials": false,
"has_shipment_pickup_combined": false,
"has_pickup": true,
"transportation": "road",
"has_mass_printing": true,
"has_customs_invoice_upload": true,
"has_insurance_ability": false,
"has_saturday_delivery": false,
"has_same_day_pickup": true,
"pickup_slot_length_in_hours": 2,
"pickup_same_day_latest_at": "17:00",
"pickup_earliest_at": "13:00",
"pickup_latest_at": "17:00",
"metadata": {
"items": [
{
"weight": 3000,
"height": 10,
"width": 30,
"length": 20,
"notes": "Nike air max",
"value": 10,
"currency": "EUR"
}
],
"address_from": {
"country": "GR",
"zip": "11111",
"name": "John Doe",
"state": "I",
"city": "Athens",
"address": "Jane Street 1",
"email": "john@mail.com",
"phone": "+3000000000",
"notes": ""
},
"address_to": {
"name": "SG2",
"country": "GR",
"state": "I",
"city": "Athens",
"zip": "11111",
"address": "Jane Street 2",
"email": "mary@mail.com",
"phone": "+3000000000"
}
}
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.shiplemon.com/endpoints/rates/get-rates.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.