Get the cost of several deliveries

GET/v1/deliveries/costs

The same pricing as GET /deliveries/{id}/cost, for a group of deliveries: the items added up, the totals, and one subtotal per delivery. Give exactly one of delivery_ids, batch_id or pin. Needs deliveries.read.

Typical use, a debt collector's invoice to a debtor: list the debtor's deliveries with GET /deliveries?pin=…, pick the ones for this claim, then ask for their cost here with delivery_ids. Or pass pin to cost everything sent to that person.

Only deliveries you may see count: pin and batch_id leave the others out, and a delivery_ids entry you may not see is delivery_not_found. The totals cover the whole group; limit and cursor page the per-delivery subtotals, newest first. Query strings never reach Parasend's logs, so pin is safe here.

A period. from and to keep the items that arose in it (when the notice, reminder or eID happened, not when the delivery was created), so a monthly run counts each cost once. Both dates are inclusive, whole days in UTC; either may be left out. A bounce in the period of a delivery charged earlier is a credit line with a negative quantity, so a past period never changes and the periods add up to the whole. Only deliveries with something in the period are listed. final is true once nothing more can arise in the period and every item in it is invoiced. Example: ?pin=0101304339&from=2026-10-01&to=2026-10-31.

Query parameters

delivery_idsstring

Up to 100 delivery ids (dlv_…), comma-separated. A repeated id counts once.
batch_idstring

Every delivery in the batch (bat_…).
pinstring

Every delivery to the recipient with this personal code (e.g. kennitala), exact match only; spaces and hyphens are ignored — as pin on GET /deliveries.
fromstring · date

The first day of the period, inclusive, in UTC (Iceland's time). Items that arose before it are left out.
tostring · date

The last day of the period, inclusive, in UTC (Iceland's time). Items that arose after it are left out.
limitinteger

Default 25
cursorstring

Returns

200 application/json. The group's cost so far.

Errors have one shape; see Errors for every code.

Code language

Request

curl "https://api.parasend.com/v1/deliveries/costs?delivery_ids=dlv_01M6R27T05512SCV3852TPM2XY" \
  -H "Authorization: Bearer $PARASEND_KEY"

const res = await fetch('https://api.parasend.com/v1/deliveries/costs?delivery_ids=dlv_01M6R27T05512SCV3852TPM2XY', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.PARASEND_KEY}`,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.parasend.com/v1/deliveries/costs?delivery_ids=dlv_01M6R27T05512SCV3852TPM2XY",
    headers={
        "Authorization": f"Bearer {os.environ['PARASEND_KEY']}",
    },
)
data = res.json()

using var http = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.parasend.com/v1/deliveries/costs?delivery_ids=dlv_01M6R27T05512SCV3852TPM2XY");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("PARASEND_KEY"));
var response = await http.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();

var request = HttpRequest.newBuilder(URI.create("https://api.parasend.com/v1/deliveries/costs?delivery_ids=dlv_01M6R27T05512SCV3852TPM2XY"))
    .header("Authorization", "Bearer " + System.getenv("PARASEND_KEY"))
    .GET()
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.parasend.com/v1/deliveries/costs?delivery_ids=dlv_01M6R27T05512SCV3852TPM2XY', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'),
    ],
]);
$data = json_decode($response->getBody(), true);

Response · 200

{
  "object": "delivery_cost_summary",
  "livemode": false,
  "currency": "ISK",
  "as_of": "2026-11-06T09:15:05.729Z",
  "from": null,
  "to": null,
  "final": false,
  "delivery_count": 1,
  "items": [
    {
      "kind": "delivery",
      "description": {
        "is": "Sending",
        "en": "Delivery"
      },
      "country": null,
      "quantity": 1,
      "unit_amount": 311,
      "amount": 311,
      "vat": 75,
      "total_amount": 386
    }
  ],
  "amount": 311,
  "vat": 75,
  "total_amount": 386,
  "invoices": [],
  "deliveries": [
    {
      "delivery_id": "dlv_01M6R27T05512SCV3852TPM2XY",
      "status": "notified",
      "final": false,
      "free": false,
      "amount": 311,
      "vat": 75,
      "total_amount": 386
    }
  ],
  "has_more": false,
  "next_cursor": null
}