Get a delivery's cost

GET/v1/deliveries/{id}/cost

Every billable item the delivery has caused so far (the delivery itself, each SMS, each eID verification, each passport or ID-card check) with the unit price, the amount, VAT and total_amount, in your billing currency. Needs deliveries.read; a member or key that sees only its own deliveries gets 404 for anyone else's.

Prices. Once a month is invoiced, an item has the price it was invoiced at (invoice_id). Before that, the price of the plan in effect now; for a month that has ended but is not yet invoiced, the plan on that month's last day, since a month is invoiced at the prices of its last day. A delivery that a plan's monthly fee covers is priced at the plan's price per included delivery, not at 0. Enterprise: the contract's price per committed delivery less its discount, and above the commitment the overage price less the discount. A discount comes off each unit price, so an item can differ by one króna from the invoice. Extras (eID, SMS, passport checks) are at the price list and never discounted, and monthly fees are never spread over deliveries. With no plan, Pay-as-you-go. See GET /billing/prices and parasend.com/pricing.

Free and taken back. A delivery on a free transaction costs 0, every item included (free: true). A bounce after sending takes the delivery charge back; SMS already sent stay.

final is false while the cost can still change: the delivery is still under way, its month is not invoiced, or a plan change this month would reprice it. It is true once the delivery has ended and every item is on an issued invoice. A recipient who opens a delivery confirmed by SMS code again gets a new code, a new item, and final is false again until that is invoiced.

Test mode is never billed. A test delivery's cost is worked out from what it did, priced as if live at the plan in effect now, so you can build against real-looking numbers. final is true once a test delivery has ended.

Path parameters

idstringrequired

The delivery's ID, starting dlv_.

Returns

200 application/json. The cost so far.

Errors have one shape; see Errors for every code.

const res = await fetch('https://api.parasend.com/v1/deliveries/dlv_01M6R27T05512SCV3852TPM2XY/cost', { 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/dlv_01M6R27T05512SCV3852TPM2XY/cost", 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/dlv_01M6R27T05512SCV3852TPM2XY/cost"); 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/dlv_01M6R27T05512SCV3852TPM2XY/cost")) .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/dlv_01M6R27T05512SCV3852TPM2XY/cost', [ 'headers' => [ 'Authorization' => 'Bearer ' . getenv('PARASEND_KEY'), ], ]); $data = json_decode($response->getBody(), true);

{ "object": "delivery_cost", "delivery_id": "dlv_01M6R27T05512SCV3852TPM2XY", "livemode": false, "currency": "ISK", "as_of": "2026-11-06T09:15:05.721Z", "final": false, "free": false, "plan": null, "items": [ { "kind": "delivery", "description": { "is": "Sending", "en": "Delivery" }, "country": null, "quantity": 1, "unit_amount": 311, "amount": 311, "vat": 75, "total_amount": 386, "invoice_id": null } ], "amount": 311, "vat": 75, "total_amount": 386, "invoices": [] }