---
title: "Accept a DropShipPurchaseOrder (async)"
method: POST
path: "/drop_ship_purchase_orders/accept"
tags: ["Drop Ship Purchase Orders"]
---

# Accept a DropShipPurchaseOrder (async)

`POST /drop_ship_purchase_orders/accept`

## Request

- Base URL: `https://api.liftforward.com`
- URL: `https://api.liftforward.com/drop_ship_purchase_orders/accept`
- Auth: API key in header `Api-Key`

The DropShipPurchaseOrder accept API is used by merchants to accept a drop ship purchase order and provide LiftForward with it's `merchant_drop_ship_purchase_order_id`.

Merchants should use this API after they are notified of a new drop ship purchase order via the notification webhook. Accepting a drop ship purchase order will trigger a confirmation email to the customer and notify LiftForward that a merchant has begun fulfillment of the order.

One of the following 2 unique identifiers for the drop ship purchase order must be provided: - `merchant_drop_ship_purchase_order_id` - The merchant's unique identifier for the drop ship purchase order. - `drop_ship_purchase_order_id` - The LiftForward unique identifier for the drop ship purchase order, as   sent in the drop ship purchase order notification webhook.

When both are provided, the drop ship purchase order is looked up by `drop_ship_purchase_order_id` only. A 404 response means none of the merchant's drop ship purchase orders matched the identifier at the time of the request.

When accepting a DropShipPurchaseOrder merchant are encouraged to provide a `merchant_drop_ship_purchase_order_id`. As this will make calling the fulfill, cancel and return APIs easier. Merchants who choose not to set a `merchant_drop_ship_purchase_order_id` will need to use the LiftForward `drop_ship_purchase_order_id` on subsequent API calls.

## Request body

- PostDropShipPurchaseOrdersAccept: Accept a DropShipPurchaseOrder (async)
  - `drop_ship_purchase_order_accept` DropShipPurchaseOrderAccept, required
    - `drop_ship_purchase_order_id` string: LiftForward's drop ship purchase order Id
    - `merchant_drop_ship_purchase_order_id` string: Merchant's drop ship purchase order Id which is customer displayable
    - `merchant_drop_ship_purchase_order_record_id` string: Merchant's record Id which can be different than the customer displayable `merchant_drop_ship_purchase_order_id`

## Response `201`

Accept a DropShipPurchaseOrder (async)

- ApiAsyncResponse: ApiAsyncResponse model
  - `request_id` string, required: LiftForward's unique ID for a single API request
  - `code` string, required: HTTP response status code
  - `status` string, required: A value of 'success' is returned when status code in the 200 range. This action has been successfully completed or queued for processing and should be considered successful.
  - `message` string: Additional information about the status of the API request.
  - `request_url` string: The API endpoint that was called.
  - `request_parameters` object: Parameters submitted by the API call for confirmation.

## Other responses

- `400`: Invalid parameters
- `401`: Unauthorized
- `405`: Not Allowed
- `408`: Request Time Out
- `500`: Internal Service Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti.md) - [All operations](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti/llms.txt) - [OpenAPI document](https://skmtc.dev/liftforward/apis/device-as-a-service-merchant-apis-lift-daas-service-producti/revisions/5a1383ffd271?raw)