---
title: "Notify the result of an accept delivery event"
method: POST
path: "/v1/delivery/{deliveryReferenceId}/accept"
tags: ["delivery_endpoints"]
---

# Notify the result of an accept delivery event

`POST /v1/delivery/{deliveryReferenceId}/accept`

## Request

- Base URL: `https://partners.tryotter.com`
- URL: `https://partners.tryotter.com/v1/delivery/{deliveryReferenceId}/accept`
- Auth: OAuth 2
  - Authorization code: `/v1/auth/oauth2/authorize`
  - Client credentials
  - Token URL: `/v1/auth/token` scopes: `delivery.provider`
- TypeScript: <https://skmtc.dev/cloudkitchens/apis/otter-api/docs/v1/delivery/:deliveryReferenceId/accept/post.ts> (a function with typed inputs; its response is checked against the schema)

Rate limit: 8 requests per minute.

## Path parameters

- `deliveryReferenceId` string, required: A unique identifier of the delivery in a UUID format.

## Headers

- `X-Store-Id` string, required: The unique identifier of the store in your app. This ID, along with the `Application ID`, will be used to match the correct store when performing operations. It cannot be longer than 255 characters and must only contain printable ASCII characters. During on-boarding, this ID will be similar to `onboarding:905bb725-b141-4a9b-832a-1f254f772c94` (where the UUID is the Internal Store ID). During off-boarding, this field will be filled with the last known Store ID, or with an empty string, in case none is found. In that case, please fall back to the provided `internalStoreId` (a.k.a. Sku-Sku ID).
- `X-Event-Id` string, required: Unique identifier of the event that this callback refers to.

## Request body

- AcceptDeliveryCallbackRequest: Delivery information.
  - `deliveryDistance` Distance, nullable: Delivery distance.
    - `unit` 'KILOMETERS' | 'MILES': Distance unit value.
    - `value` number: Distance value.
  - `currencyCode` string: The 3-letter currency code (ISO 4217) to use for all monetary values.
  - `cost` DeliveryCost: Delivery cost details.
    - `baseCost` number, double: Base delivery cost value.
    - `extraCost` number, double: Extra delivery cost value.
  - `fulfillmentPath` FulfillmentPathEntity[], nullable: List of entities involved in the fulfillment processing path.
    - `name` string: Describes the entity name.
    - `type` 'FULFILLMENT_PROCESSOR' | 'INTERMEDIARY': Type of entities in the fulfillment path.
  - `estimatedDeliveryTime` string, date-time, nullable: The expected delivery time.
  - `estimatedPickupTime` string, date-time, nullable: The expected pickup time.
  - `confirmedAt` string, date-time: The time that the request was accepted.
  - `deliveryTrackingUrl` string, nullable: URL to a web page that tracks the delivery.
  - `providerDeliveryId` string, nullable: The provider's internal identifier for the delivery used for tracking purposes.

## Response `204`

The event callback was successfully accepted.

## Other responses

- `400`: The request is malformed.
- `401`: Invalid authorization.
- `403`: Authorization not valid for the requested resource.
- `404`: Resource not found.
- `422`: The request body is not valid.

---

[API](https://skmtc.dev/cloudkitchens/apis/otter-api.md) - [All operations](https://skmtc.dev/cloudkitchens/apis/otter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudkitchens/apis/otter-api/revisions/4c868194a467?raw)