# Zip's API discovery

This document describes the public JSON APIs currently advertised for agent discovery.

## DewEze Fitment API

Base URL: `https://zips.com/deweze/api/`

Endpoints:
- `GET /deweze/api/makes`
- `GET /deweze/api/make-options?make={make}`
- `GET /deweze/api/find-product?make={make}&year={year}&engine={engine}&pumpSize={pumpSize}&pumpPort={pumpPort}`

## Part Schematics API

Base URL: `https://zips.com/zips-api/part-schematics/`

Endpoints:
- `GET /zips-api/part-schematics/categories`
- `GET /zips-api/part-schematics/stock/{sku}`

## Status Endpoint

- `GET https://zips.com/healthz`

## Notes

- Browser HTML remains the default representation for storefront pages.
- Requests with `Accept: text/markdown` can receive markdown storefront content for supported public pages.