# DeliveryRateEvaluationRequest

The body Flint sends to a delivery rate callback's URL to price delivery methods for a quote. Verify the signature against the raw body before parsing it, then answer with a DeliveryRateEvaluationResponse.

- `buyer_location` (object; optional; nullable: false): The buyer's location for local delivery, limited like destination. It adds latitude and longitude when a candidate lists buyer_location.coordinate. Omitted when no candidate lists a buyer_location field.
  - [read_schema {"schema":"DeliveryRateEvaluationRequest","pointer":"/buyer_location"}](/docs/api/schemas/DeliveryRateEvaluationRequest.md?pointer=%2Fbuyer_location)
- `candidates` (array of object; required; nullable: false): The delivery methods to price, sorted by delivery_method_revision_id. Every candidate in a request has the same execution legs; methods that ship from different Locations get separate requests. → DeliveryRateEvaluationCandidate (delivery_method_id, delivery_method_revision_id, execution_legs, pricing) · [read_schema {"schema":"DeliveryRateEvaluationCandidate"}](/docs/api/schemas/DeliveryRateEvaluationCandidate.md)
- `checkout_session_id` (string; required; nullable: true; example: "cs_01KEZF7C004JRWFW43H037MQRN"): The checkout session being quoted. `null` when a delivery preview prices the methods, because a preview has no checkout session. A test delivery sends an ID that matches no checkout session.
- `choice_group_fingerprint` (string; required; nullable: false): Opaque fingerprint of the choice group's items and quantities. Equal fingerprints mean the same contents.
- `currency` (string; required; nullable: false; minLength: 3; maxLength: 3; pattern: "^[A-Z]{3}$"; example: "USD"): The checkout currency as an ISO 4217 code. Every amount in the response must use it.
- `delivery_choice_group_id` (string; required; nullable: false; example: "dcgrp_01KEZF7C00KYKJQ897HWM86AT8"): The choice group being priced: the line items that ship together under one delivery method.
- `delivery_feasibility_plan_fingerprint` (string; required; nullable: false): Opaque fingerprint of the plan Flint priced: its origins and the allocations each one ships. Equal fingerprints mean the same plan.
- `delivery_quote_expires_at` (string; required; nullable: false; format: date-time; example: "2026-08-02T16:00:00Z"): When the quote expires, in RFC 3339 format truncated to whole seconds. Every expires_at in the response must be no later than this. It is up to 15 minutes after evaluated_at, or just under 5 minutes for a cart with tracked inventory.
- `delivery_rate_callback_revision_id` (string; required; nullable: false; example: "dcbr_01KEZF7C003QAPFXXMCHC59T5J"): The delivery rate callback revision whose configuration sent this request.
- `delivery_rate_callback_signing_key_id` (string; required; nullable: false; example: "cbkey_00112233445566778899aabb"): ID of the current HMAC signing key when hmac signing is enabled, or an empty string for a JWT-only callback. It is the first ID in the Flint-Signing-Key-Ids header and is unrelated to the JWT header's kid.
- `delivery_rate_evaluation_id` (string; required; nullable: false; example: "dreval_01KEZF7C00X0Q3Z075W9W90ZGC"): Identifies this evaluation. A retry reuses it with the same body, and each new quote gets a new one. The webhook-id header carries the same value. Echo it in the response.
- `destination` (object; optional; nullable: false): The delivery address, limited to the fields that a candidate method lists in quote_input_fields. Omitted when no candidate lists an address field.
  - [read_schema {"schema":"DeliveryRateEvaluationRequest","pointer":"/destination"}](/docs/api/schemas/DeliveryRateEvaluationRequest.md?pointer=%2Fdestination)
- `evaluated_at` (string; required; nullable: false; format: date-time; example: "2026-08-02T16:00:00Z"): The quote's evaluation time, in RFC 3339 format with up to nine fractional digits. Compute every time in the response from this value, not from your server's clock.
- `order_id` (string; required; nullable: false; example: "ord_01KEZF7C0054GQKJ142A8X367A"): The order whose items are being priced.
- `quote_creation_identity` (string; required; nullable: false): Opaque identity of the quote attempt this evaluation belongs to.
- `test` (boolean; optional; nullable: false): `true` on a test delivery sent by createDeliveryRateCallbackTestDelivery, whose IDs don't refer to stored checkout sessions or orders. Omitted on live requests.
