> ## Documentation Index
> Fetch the complete documentation index at: https://docs.autosnap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Dealer

> Remove a dealership subscription and stop imports.

`DELETE /v1/dealers/{dealership_id}`

<Note>
  **v1.0 schema lock.** The response shape on this page is the locked v1.0 contract. We will never remove a documented field, never rename a field, and never change a field's type without bumping to v2 (see [Versioning](/get-started/versioning)).
</Note>

Remove a dealership subscription from your account. This deactivates your subscription only — if other clients are also subscribed to the same dealership, their subscriptions and the import schedule remain active. Existing inventory data is retained.

If you are the only subscriber, the import configuration is also deactivated and scheduled imports stop.

To re-add a deleted dealership, call [Setup Dealership](/api-reference/endpoints/setup-dealer) again with the same URL — the existing subscription will be reactivated.

## Parameters

| Name            | Type   | In    | Required | Description                                          |
| --------------- | ------ | ----- | -------- | ---------------------------------------------------- |
| `dealership_id` | string | path  | Yes      | The dealership's public ID (e.g. `dlr_8cfc0b00a98b`) |
| `api_key`       | string | query | Yes      | Your API key                                         |

## Example

```bash theme={null}
curl -X DELETE "https://api.autosnap.com/v1/dealers/dlr_8cfc0b00a98b?api_key=YOUR_API_KEY"
```

## Response

```json theme={null}
{
  "success": true,
  "dealership_id": "dlr_8cfc0b00a98b",
  "message": "Dealership subscription removed"
}
```

## Errors

| Status | Description                                               |
| ------ | --------------------------------------------------------- |
| 404    | Dealership not found or not subscribed under your account |


## OpenAPI

````yaml DELETE /v1/dealers/{dealership_id}
openapi: 3.0.3
info:
  title: AutosnapAI Origin API
  description: Dealer resolution, inventory management, and webhook APIs
  version: 1.0.0
servers:
  - url: https://api.autosnap.com
    description: Production
security: []
paths:
  /v1/dealers/{dealership_id}:
    delete:
      tags:
        - origin
      summary: Delete Dealer
      description: >-
        Remove a dealership subscription. Deactivates the subscription and stops
        imports.
      operationId: delete_dealer_v1_dealers__dealership_id__delete
      parameters:
        - name: dealership_id
          in: path
          required: true
          schema:
            type: string
            title: Dealership Id
        - name: api_key
          in: query
          required: true
          schema:
            type: string
            title: Api Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````