DoorDash Drive API

openapi: 3.1.0
info:
  title: DoorDash Drive API
  description: >-
    The DoorDash Drive API enables businesses to request on-demand deliveries
    fulfilled by DoorDash's fleet of Dashers. It provides endpoints for
    checking delivery serviceability, getting delivery quotes, creating and
    managing deliveries, and tracking delivery status in real time. The API
    uses JWT-based authentication and is designed for businesses that want to
    offer delivery from their own ordering experience while leveraging
    DoorDash's logistics network.
  version: '2.0'
  contact:
    name: DoorDash Developer Support
    url: https://developer.doordash.com/en-US/
  termsOfService: https://www.doordash.com/terms/
externalDocs:
  description: DoorDash Drive API Documentation
  url: https://developer.doordash.com/en-US/docs/drive/overview/about_drive/
servers:
- url: https://openapi.doordash.com/drive/v2
  description: Production Server
tags:
- name: Addresses
  description: >-
    Get address auto-completion suggestions based on partial input.
- name: Businesses
  description: >-
    Manage business entities that represent legal entities or owners on the
    DoorDash Drive platform.
- name: Deliveries
  description: >-
    Create, retrieve, update, and cancel on-demand deliveries fulfilled by
    DoorDash Dashers.
- name: Quotes
  description: >-
    Validate delivery serviceability and get pricing quotes before creating
    a delivery.
- name: Stores
  description: >-
    Manage store locations that represent individual pickup points associated
    with a business.
security:
- bearerAuth: []
paths:
  /quotes:
    post:
      operationId: createDeliveryQuote
      summary: DoorDash Create a Delivery Quote
      description: >-
        Creates a delivery quote to confirm that a delivery is serviceable by
        DoorDash and returns the estimated fee and delivery time. Quotes are
        valid for 5 minutes after creation.
      tags:
      - Quotes
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QuoteRequest'
            examples:
              CreateDeliveryQuoteRequestExample:
                summary: Default createDeliveryQuote request
                x-microcks-default: true
                value:
                  external_delivery_id: D-12345
                  pickup_address: 901 Market St, San Francisco, CA 94105
                  pickup_business_name: Acme Pickup Store
                  pickup_phone_number: '+15555551234'
                  dropoff_address: 901 Market St, San Francisco, CA 94105
                  dropoff_business_name: Acme Pickup Store
                  dropoff_phone_number: '+15555551234'
                  order_value: 42
                  pickup_time: '2026-06-02T14:30:00Z'
                  dropoff_time: '2026-06-02T14:30:00Z'
      responses:
        '200':
          description: Delivery quote created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Quote'
              examples:
                CreateDeliveryQuote200Example:
                  summary: Default createDeliveryQuote 200 response
                  x-microcks-default: true
                  value:
                    external_delivery_id: D-12345
                    fee: 42
                    currency: USD
                    delivery_time: '2026-06-02T14:30:00Z'
                    pickup_time: '2026-06-02T14:30:00Z'
                    expires_at: '2026-06-02T14:30:00Z'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CreateDeliveryQuote400Example:
                  summary: Default createDeliveryQuote 400 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CreateDeliveryQuote401Example:
                  summary: Default createDeliveryQuote 401 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /quotes/{external_delivery_id}/accept:
    post:
      operationId: acceptDeliveryQuote
      summary: DoorDash Accept a Delivery Quote
      description: >-
        Accepts a previously created delivery quote and initiates the delivery
        process. The quote must be accepted within 5 minutes of being created.
        You can optionally edit the tip amount when accepting.
      tags:
      - Quotes
      parameters:
      - $ref: '#/components/parameters/ExternalDeliveryId'
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AcceptQuoteRequest'
            examples:
              AcceptDeliveryQuoteRequestExample:
                summary: Default acceptDeliveryQuote request
                x-microcks-default: true
                value:
                  tip: 42
      responses:
        '200':
          description: Quote accepted and delivery initiated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Delivery'
              examples:
                AcceptDeliveryQuote200Example:
                  summary: Default acceptDeliveryQuote 200 response
                  x-microcks-default: true
                  value:
                    external_delivery_id: D-12345
                    delivery_status: created
                    fee: 42
                    currency: USD
                    tip: 42
                    order_value: 42
                    pickup_address: 901 Market St, San Francisco, CA 94105
                    pickup_business_name: Acme Pickup Store
                    pickup_phone_number: '+15555551234'
                    pickup_instructions: Leave at the front desk.
                    pickup_time_estimated: '2026-06-02T14:30:00Z'
                    pickup_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_address: 901 Market St, San Francisco, CA 94105
                    dropoff_business_name: Acme Pickup Store
                    dropoff_phone_number: '+15555551234'
                    dropoff_instructions: Leave at the front desk.
                    dropoff_time_estimated: '2026-06-02T14:30:00Z'
                    dropoff_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_contact_given_name: Acme Pickup Store
                    dropoff_contact_family_name: Acme Pickup Store
                    dasher_id: 42
                    dasher_name: Acme Pickup Store
                    dasher_phone_number: '+15555551234'
                    dasher_location:
                      lat: 37.422
                      lng: -122.084
                    tracking_url: https://example.com/path/abc123
                    contains_alcohol: true
                    force_batch_id: D-12345
                    created_at: '2026-06-02T14:30:00Z'
                    updated_at: '2026-06-02T14:30:00Z'
        '400':
          description: Quote expired or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AcceptDeliveryQuote400Example:
                  summary: Default acceptDeliveryQuote 400 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AcceptDeliveryQuote401Example:
                  summary: Default acceptDeliveryQuote 401 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '404':
          description: Quote not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AcceptDeliveryQuote404Example:
                  summary: Default acceptDeliveryQuote 404 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /deliveries:
    post:
      operationId: createDelivery
      summary: DoorDash Create a Delivery
      description: >-
        Creates a new delivery request directly without first creating a quote.
        DoorDash will assign a Dasher to fulfill the delivery. This is an
        alternative to the quote-then-accept workflow.
      tags:
      - Deliveries
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeliveryRequest'
            examples:
              CreateDeliveryRequestExample:
                summary: Default createDelivery request
                x-microcks-default: true
                value:
                  external_delivery_id: D-12345
                  pickup_address: 901 Market St, San Francisco, CA 94105
                  pickup_business_name: Acme Pickup Store
                  pickup_phone_number: '+15555551234'
                  pickup_instructions: Leave at the front desk.
                  pickup_reference_tag: example
                  dropoff_address: 901 Market St, San Francisco, CA 94105
                  dropoff_business_name: Acme Pickup Store
                  dropoff_phone_number: '+15555551234'
                  dropoff_instructions: Leave at the front desk.
                  dropoff_contact_given_name: Acme Pickup Store
                  dropoff_contact_family_name: Acme Pickup Store
                  order_value: 42
                  tip: 42
                  pickup_time: '2026-06-02T14:30:00Z'
                  dropoff_time: '2026-06-02T14:30:00Z'
                  contains_alcohol: true
                  force_batch_id: D-12345
                  external_business_id: D-12345
                  external_store_id: D-12345
                  items:
                  - name: {}
                    description: {}
                    quantity: {}
                    external_id: {}
                    price: {}
      responses:
        '200':
          description: Delivery created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Delivery'
              examples:
                CreateDelivery200Example:
                  summary: Default createDelivery 200 response
                  x-microcks-default: true
                  value:
                    external_delivery_id: D-12345
                    delivery_status: created
                    fee: 42
                    currency: USD
                    tip: 42
                    order_value: 42
                    pickup_address: 901 Market St, San Francisco, CA 94105
                    pickup_business_name: Acme Pickup Store
                    pickup_phone_number: '+15555551234'
                    pickup_instructions: Leave at the front desk.
                    pickup_time_estimated: '2026-06-02T14:30:00Z'
                    pickup_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_address: 901 Market St, San Francisco, CA 94105
                    dropoff_business_name: Acme Pickup Store
                    dropoff_phone_number: '+15555551234'
                    dropoff_instructions: Leave at the front desk.
                    dropoff_time_estimated: '2026-06-02T14:30:00Z'
                    dropoff_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_contact_given_name: Acme Pickup Store
                    dropoff_contact_family_name: Acme Pickup Store
                    dasher_id: 42
                    dasher_name: Acme Pickup Store
                    dasher_phone_number: '+15555551234'
                    dasher_location:
                      lat: 37.422
                      lng: -122.084
                    tracking_url: https://example.com/path/abc123
                    contains_alcohol: true
                    force_batch_id: D-12345
                    created_at: '2026-06-02T14:30:00Z'
                    updated_at: '2026-06-02T14:30:00Z'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CreateDelivery400Example:
                  summary: Default createDelivery 400 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CreateDelivery401Example:
                  summary: Default createDelivery 401 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /deliveries/{external_delivery_id}:
    get:
      operationId: getDelivery
      summary: DoorDash Get Delivery Details
      description: >-
        Retrieves the current details and status of a delivery using the
        external delivery ID provided during creation.
      tags:
      - Deliveries
      parameters:
      - $ref: '#/components/parameters/ExternalDeliveryId'
      responses:
        '200':
          description: Delivery details retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Delivery'
              examples:
                GetDelivery200Example:
                  summary: Default getDelivery 200 response
                  x-microcks-default: true
                  value:
                    external_delivery_id: D-12345
                    delivery_status: created
                    fee: 42
                    currency: USD
                    tip: 42
                    order_value: 42
                    pickup_address: 901 Market St, San Francisco, CA 94105
                    pickup_business_name: Acme Pickup Store
                    pickup_phone_number: '+15555551234'
                    pickup_instructions: Leave at the front desk.
                    pickup_time_estimated: '2026-06-02T14:30:00Z'
                    pickup_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_address: 901 Market St, San Francisco, CA 94105
                    dropoff_business_name: Acme Pickup Store
                    dropoff_phone_number: '+15555551234'
                    dropoff_instructions: Leave at the front desk.
                    dropoff_time_estimated: '2026-06-02T14:30:00Z'
                    dropoff_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_contact_given_name: Acme Pickup Store
                    dropoff_contact_family_name: Acme Pickup Store
                    dasher_id: 42
                    dasher_name: Acme Pickup Store
                    dasher_phone_number: '+15555551234'
                    dasher_location:
                      lat: 37.422
                      lng: -122.084
                    tracking_url: https://example.com/path/abc123
                    contains_alcohol: true
                    force_batch_id: D-12345
                    created_at: '2026-06-02T14:30:00Z'
                    updated_at: '2026-06-02T14:30:00Z'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                GetDelivery401Example:
                  summary: Default getDelivery 401 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '404':
          description: Delivery not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                GetDelivery404Example:
                  summary: Default getDelivery 404 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    patch:
      operationId: updateDelivery
      summary: DoorDash Update a Delivery
      description: >-
        Updates specified attributes of an existing delivery. Not all fields
        can be updated after creation, and updates may be restricted based on
        the current delivery status.
      tags:
      - Deliveries
      parameters:
      - $ref: '#/components/parameters/ExternalDeliveryId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeliveryUpdateRequest'
            examples:
              UpdateDeliveryRequestExample:
                summary: Default updateDelivery request
                x-microcks-default: true
                value:
                  tip: 42
                  dropoff_instructions: Leave at the front desk.
                  dropoff_phone_number: '+15555551234'
      responses:
        '200':
          description: Delivery updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Delivery'
              examples:
                UpdateDelivery200Example:
                  summary: Default updateDelivery 200 response
                  x-microcks-default: true
                  value:
                    external_delivery_id: D-12345
                    delivery_status: created
                    fee: 42
                    currency: USD
                    tip: 42
                    order_value: 42
                    pickup_address: 901 Market St, San Francisco, CA 94105
                    pickup_business_name: Acme Pickup Store
                    pickup_phone_number: '+15555551234'
                    pickup_instructions: Leave at the front desk.
                    pickup_time_estimated: '2026-06-02T14:30:00Z'
                    pickup_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_address: 901 Market St, San Francisco, CA 94105
                    dropoff_business_name: Acme Pickup Store
                    dropoff_phone_number: '+15555551234'
                    dropoff_instructions: Leave at the front desk.
                    dropoff_time_estimated: '2026-06-02T14:30:00Z'
                    dropoff_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_contact_given_name: Acme Pickup Store
                    dropoff_contact_family_name: Acme Pickup Store
                    dasher_id: 42
                    dasher_name: Acme Pickup Store
                    dasher_phone_number: '+15555551234'
                    dasher_location:
                      lat: 37.422
                      lng: -122.084
                    tracking_url: https://example.com/path/abc123
                    contains_alcohol: true
                    force_batch_id: D-12345
                    created_at: '2026-06-02T14:30:00Z'
                    updated_at: '2026-06-02T14:30:00Z'
        '400':
          description: Invalid update parameters or delivery state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UpdateDelivery400Example:
                  summary: Default updateDelivery 400 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UpdateDelivery401Example:
                  summary: Default updateDelivery 401 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '404':
          description: Delivery not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                UpdateDelivery404Example:
                  summary: Default updateDelivery 404 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /deliveries/{external_delivery_id}/cancel:
    put:
      operationId: cancelDelivery
      summary: DoorDash Cancel a Delivery
      description: >-
        Cancels an active delivery. Deliveries cannot be cancelled after a
        Dasher has been assigned. Cancellation may incur fees depending on
        the delivery state.
      tags:
      - Deliveries
      parameters:
      - $ref: '#/components/parameters/ExternalDeliveryId'
      responses:
        '200':
          description: Delivery cancelled successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Delivery'
              examples:
                CancelDelivery200Example:
                  summary: Default cancelDelivery 200 response
                  x-microcks-default: true
                  value:
                    external_delivery_id: D-12345
                    delivery_status: created
                    fee: 42
                    currency: USD
                    tip: 42
                    order_value: 42
                    pickup_address: 901 Market St, San Francisco, CA 94105
                    pickup_business_name: Acme Pickup Store
                    pickup_phone_number: '+15555551234'
                    pickup_instructions: Leave at the front desk.
                    pickup_time_estimated: '2026-06-02T14:30:00Z'
                    pickup_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_address: 901 Market St, San Francisco, CA 94105
                    dropoff_business_name: Acme Pickup Store
                    dropoff_phone_number: '+15555551234'
                    dropoff_instructions: Leave at the front desk.
                    dropoff_time_estimated: '2026-06-02T14:30:00Z'
                    dropoff_time_actual: '2026-06-02T14:30:00Z'
                    dropoff_contact_given_name: Acme Pickup Store
                    dropoff_contact_family_name: Acme Pickup Store
                    dasher_id: 42
                    dasher_name: Acme Pickup Store
                    dasher_phone_number: '+15555551234'
                    dasher_location:
                      lat: 37.422
                      lng: -122.084
                    tracking_url: https://example.com/path/abc123
                    contains_alcohol: true
                    force_batch_id: D-12345
                    created_at: '2026-06-02T14:30:00Z'
                    updated_at: '2026-06-02T14:30:00Z'
        '400':
          description: Delivery cannot be cancelled in current state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CancelDelivery400Example:
                  summary: Default cancelDelivery 400 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CancelDelivery401Example:
                  summary: Default cancelDelivery 401 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '404':
          description: Delivery not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CancelDelivery404Example:
                  summary: Default cancelDelivery 404 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /businesses:
    get:
      operationId: listBusinesses
      summary: DoorDash List Businesses
      description: >-
        Lists all businesses owned by the authenticated developer account.
      tags:
      - Businesses
      responses:
        '200':
          description: List of businesses retrieved successfully
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Business'
              examples:
                ListBusinesses200Example:
                  summary: Default listBusinesses 200 response
                  x-microcks-default: true
                  value:
                  - external_business_id: D-12345
                    name: Acme Pickup Store
                    description: Leave at the front desk.
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                ListBusinesses401Example:
                  summary: Default listBusinesses 401 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      operationId: createBusiness
      summary: DoorDash Create a Business
      description: >-
        Creates a new Drive business entity representing a legal entity or
        owner on the DoorDash platform.
      tags:
      - Businesses
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BusinessRequest'
            examples:
              CreateBusinessRequestExample:
                summary: Default createBusiness request
                x-microcks-default: true
                value:
                  external_business_id: D-12345
                  name: Acme Pickup Store
                  description: Leave at the front desk.
      responses:
        '200':
          description: Business created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Business'
              examples:
                CreateBusiness200Example:
                  summary: Default createBusiness 200 response
                  x-microcks-default: true
                  value:
                    external_business_id: D-12345
                    name: Acme Pickup Store
                    description: Leave at the front desk.
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CreateBusiness400Example:
                  summary: Default createBusiness 400 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                CreateBusiness401Example:
                  summary: Default createBusiness 401 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC123
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /businesses/{external_business_id}:
    get:
      operationId: getBusiness
      summary: DoorDash Get Business Details
      description: >-
        Retrieves the details of a specific business by its external business ID.
      tags:
      - Businesses
      parameters:
      - $ref: '#/components/parameters/ExternalBusinessId'
      responses:
        '200':
          description: Business details retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Business'
              examples:
                GetBusiness200Example:
                  summary: Default getBusiness 200 response
                  x-microcks-default: true
                  value:
                    external_business_id: D-12345
                    name: Acme Pickup Store
                    description: Leave at the front desk.
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                GetBusiness401Example:
                  summary: Default getBusiness 401 response
                  x-microcks-default: true
                  value:
                    field_errors:
                    - field: example
                      error: example
                    message: example
                    code: ABC1

# --- truncated at 32 KB (67 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/doordash/refs/heads/main/openapi/doordash-drive-openapi.yml