---
title: "Delete Listing"
url: "https://stage-api-docs.centraldispatch.com/apis/stage-listing-api-2-0-0/versions/6459c118-c2b9-484e-816d-5657457559e4/operations/deleteListing"
---

> Full API specification: https://stage-api-docs.centraldispatch.com/apis/stage-listing-api-2-0-0/versions/6459c118-c2b9-484e-816d-5657457559e4.md

# Delete Listing

`DELETE` `/listings/id/{id}`

Operation ID: `deleteListing`

Delete a listing. #### 👥 Customer Type - Shipper

## Path parameters

- `id` (integer, int64, required) - The ID of the listing.

## Header parameters

- `Accept` (string, required) - The major version of the API to make a request against. This is a custom MIME type that contains `vnd.coxauto.v[#]+`. For example, to request a resource from version 2.x.x of an API, the Accept header should be set to `application/vnd.coxauto.v2+json`.

## Responses

- `204` - No Content. Successful request.
- `401` - Unauthorized. Authentication failed or missing.
- `403` - Forbidden. The attempted action is not permitted.
- `404` - Not Found. **Scenarios:** - Listing not found. - Listing already deleted. - Customer does not own the listing.
- `406` - Not Acceptable **Scenarios:** - `Accept` version header is missing or invalid - v2 API requires: `Accept: application/vnd.coxauto.v2+json`.
- `422` - Unprocessable Entity. Errors found in the request. **Scenarios:** - `id` must not be empty. - '`id` must be greater than or equal to `300000000`. - Business rule violations preventing deletion. - Listing in invalid state for deletion (e.g., has active negotiations).
- `429` - Too Many Requests. Rate limit exceeded.
- `500` - Error.
- `503` - Service Unavailable. Temporary service interruption.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Listing API
  version: 2.0.0
servers:
  - url: https://marketplace-api.centraldispatch.com
    description: Production server
paths:
  /listings/id/{id}:
    delete:
      tags:
        - Listings
      summary: Delete Listing
      description: |-
        
        Delete a listing.

        #### 👥 Customer Type
        - Shipper
      operationId: deleteListing
      parameters:
        - name: id
          in: path
          description: The ID of the listing.
          required: true
          schema:
            type: integer
            format: int64
          example: 42220470
        - name: Accept
          in: header
          description: The major version of the API to make a request against. This is a
            custom MIME type that contains `vnd.coxauto.v[#]+`. For example, to
            request a resource from version 2.x.x of an API, the Accept header
            should be set to `application/vnd.coxauto.v2+json`.
          required: true
          schema:
            type: string
          example: application/vnd.coxauto.v2+json
      responses:
        "204":
          description: No Content. Successful request.
        "401":
          description: Unauthorized. Authentication failed or missing.
        "403":
          description: Forbidden. The attempted action is not permitted.
        "404":
          description: |-
            Not Found.

            **Scenarios:**

             - Listing not found.
             - Listing already deleted.
             - Customer does not own the listing.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Errors"
        "406":
          description: >-
            Not Acceptable


            **Scenarios:**

             - `Accept` version header is missing or invalid - v2 API requires: `Accept: application/vnd.coxauto.v2+json`.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Errors"
        "422":
          description: >-
            Unprocessable Entity. Errors found in the request.


            **Scenarios:**

             - `id` must not be empty.
             - '`id` must be greater than or equal to `300000000`.
             - Business rule violations preventing deletion.
             - Listing in invalid state for deletion (e.g., has active negotiations).
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Errors"
        "429":
          description: Too Many Requests. Rate limit exceeded.
        "500":
          description: Error.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Errors"
        "503":
          description: Service Unavailable. Temporary service interruption.
      security:
        - Bearer: []
security:
  - Bearer: []
components:
  schemas:
    Errors:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: "#/components/schemas/Error"
          description: A collection of errors.
          nullable: true
      description: An error occurred, and the request could not be completed.
    Error:
      type: object
      properties:
        code:
          type: string
          description: The code used for the issue.
          nullable: true
          example: resource.issue_type
        message:
          type: string
          description: A detailed message.
          nullable: true
          example: The issue happened because something is wrong.
        property:
          type: string
          description: The property to which the issue is associated.
          nullable: true
          example: person
        properties:
          type: object
          additionalProperties:
            type: string
          description: Additional properties related to the issue.
          nullable: true
          example:
            firstName: D0nn@
            lastName: Sm!th
      description: Details of an error or issue.
  securitySchemes:
    Bearer:
      type: http
      scheme: Bearer
```