Overview

Catalog Management API

Overview

The Item Management API is designed for DoorDash partners to manage information about the items they offer on the platform. It allows partners to add new items to the catalog and update information about existing items. Item information is managed at the business level, and each item is identified by a unique Merchant Supplied Item ID (MSID).

Endpoint URL: https://openapi.doordash.com/marketplace/api/v2/items

Getting Started

Request

• HTTP Method:

  • POST: Add new items to the catalog
  • PATCH: Update information about existing items

• Headers:

  • Refer to the JWT authentication documentation for authentication details.

• Payload Example: View Example JSON

Response

• Success Response:

{
  "operation_id": "string",
  "operation_status": "SUCCESS", // Possible values: "QUEUED" "IN_PROGRESS" "SUCCESS" "FAILED" "PARTIAL_SUCCESS"
  "message": "string"
}

• Fail Response Details:

Response Code	Code	Message	field_errors.field	field_errors.error
400	validation_error	One or more request values couldn't be validated.	Name of the field whose value couldn't be validated.	The error that was encountered when validating the field's value.
401	authentication_error	Default: The [exp] is in the past; the JWT is expired	-	-
403	authorization_error	Default: Authorization error: the credentials provided with the request don't work	-	-
404	unknown_business_id	-	-	-
422	request_rate_limited	-	-	-
429	request_rate_limited	-	-	-
500	service_fault	Default: Internal service failure, please try again later.	-	-

Verification:

Once you believe you have made a successful call to the endpoint, reach out to your DoorDash technical account manager to verify. Please provide an example of the payload used in the request.

FAQ

1. How do I get the required business_id?

   • Your DoorDash technical account manager will provide the business_id for the test and production stores.

2. How long will it take for new items to be created or updated?

   • Current Service Level Agreements (SLAs) range from 5 to 18 days, depending on the number of items involved in the request.

3. Do I need to include all of the fields that are in the payload?

   • No, you do not. However, including more data and ensuring higher data quality will expedite the process of creating or updating items.