Carts

Choose pickup or delivery

Changes a ready cart to pickup or delivery, its address, or the driver's tip, and answers with the cart at its new total. Delivery is priced live; when it cannot happen, the cart stays a pickup and fulfillment.deliveryUnavailable says why. Nothing is charged.

post/carts/{cartId}/fulfillment

Request

Base URL: https://api.layout.link/v1
URL: https://api.layout.link/v1/carts/{cartId}/fulfillment
Auth: HTTP bearer

Path parameters

cartIdstring required

The crt_ id.

Headers

Layout-Version'2026-10-01'

The API version you code against. Optional; without it you get 2026-10-01, the current version. Layout answers with the version it used.

Idempotency-Keystring

Optional. Any 1 to 255 visible ASCII characters, unique per real intent. A retry with the same key and the same body gets the stored response for 24 hours, with Idempotent-Replayed: true, and is never run twice. The same key with a different body is 409 idempotency_conflict; while the first request is still running it is 409 in_progress with Retry-After. Only a success is stored: any error releases the key so it can be sent again. A 4xx ran nothing. A 5xx may have run, above all a confirm's 500, so read the resource before sending anything changed.

Request body

Response

The cart at its new total.

Example response

{
  "cart": {
    "order": {
      "id": "ord_7c21e4b9a0d3"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.