# Wherehouse API

## Docs
- [Structure Overview](https://dev.wherehouse.co.za/structure.md): 
- [Authentication / Obtaining an API Key](https://dev.wherehouse.co.za/authentication.md): 
- [Pagination](https://dev.wherehouse.co.za/pagination.md): 
- [Filtering](https://dev.wherehouse.co.za/filtering.md): 
- [Rate Limits](https://dev.wherehouse.co.za/rate-limits.md): 
- [Webhooks](https://dev.wherehouse.co.za/webhooks.md): 

## API Docs
- Products [/products](https://dev.wherehouse.co.za/products.md): 
- Products [/products/{code}](https://dev.wherehouse.co.za/api-40856354.md): Fetch one product by SKU, including per location `inventory` and the `platforms` marketplace cache.
- Products [/products/{code}](https://dev.wherehouse.co.za/api-40856355.md): Update a product in place, matched on `code` within a catalogue.
- Products [/products/update](https://dev.wherehouse.co.za/api-42695816.md): Update one catalogue product. Put the SKU in `code` on the JSON body, not in the URL, so values like `BLUE+RED5` are not mangled.
- Products [/products](https://dev.wherehouse.co.za/api-40856353.md): Create a product in one of the catalogues your API key can reach.
- Products [/product-batches](https://dev.wherehouse.co.za/api-42695817.md): Queue many product updates and get a ticket back immediately (`202`). Poll `GET /product-batches/{ticket}` for progress.
- Products [/product-batches/{ticket}](https://dev.wherehouse.co.za/api-42695818.md): Poll the status of a product update batch you submitted. Tickets belong to the API key's subscription and expire after 7 days.
- Orders [/orders](https://dev.wherehouse.co.za/orders.md): 
- Offers [/offers](https://dev.wherehouse.co.za/offers.md): 
- Repricers [/repricers](https://dev.wherehouse.co.za/repricers.md): 
- Repricers [/repricers](https://dev.wherehouse.co.za/create-update-repricer.md): Create or update a single repricer for a given offer. Matches based off product SKU.
- Repricers [/repricers/batch](https://dev.wherehouse.co.za/batch-create-update-repricers.md): Create or update a many repricers. The update job is limited to 10 000 repricer updates per batch. Processes asynchronously and reports feedback on /imports endpoint.
- Imports [/imports](https://dev.wherehouse.co.za/api-14167967.md): List all file imports, includes statistics and feedback on the import.
- Product Listings [/product-listings](https://dev.wherehouse.co.za/api-40856356.md): Every listing submission made for the catalogues your API key can reach, newest first. This is the API version of the Listing History view.
- Product Listings [/product-listings/{platform}](https://dev.wherehouse.co.za/api-40856358.md): Submit a product for listing on a marketplace. This is the same AI enrichment flow the Wherehouse app uses: Wherehouse maps your product to a marketplace category, fills the required attributes, and creates the marketplace draft or QC submission.
- [/ping](https://dev.wherehouse.co.za/health-check.md): Test authentication and server connection.

## Schemas
- [Product](https://dev.wherehouse.co.za/schema-5315855.md): 
- [Connector Type](https://dev.wherehouse.co.za/schema-5315865.md): 
- [Repricer](https://dev.wherehouse.co.za/schema-5360827.md): 
- [File Import](https://dev.wherehouse.co.za/schema-5361979.md): 
- [Catalogue](https://dev.wherehouse.co.za/schema-5362035.md): 
- [Order](https://dev.wherehouse.co.za/schema-5362095.md): 
- [Product Sale](https://dev.wherehouse.co.za/schema-5362096.md): 
- [Custom Attributes](https://dev.wherehouse.co.za/schema-12163765.md): 
- [Platform Cache](https://dev.wherehouse.co.za/schema-12165349.md): 
- [Product Update By Body](https://dev.wherehouse.co.za/schema-17363132.md): 
- [Product Inventory](https://dev.wherehouse.co.za/schema-16742167.md): 
- [Product Create](https://dev.wherehouse.co.za/schema-16742805.md): 
- [Product Update](https://dev.wherehouse.co.za/schema-16742806.md): 
- [Product Batch Request](https://dev.wherehouse.co.za/schema-17363133.md): 
- [Public API Error](https://dev.wherehouse.co.za/schema-16742811.md): 
- [Product Batch Ticket](https://dev.wherehouse.co.za/schema-17363134.md): 
- [Product Listing Submission](https://dev.wherehouse.co.za/schema-16742807.md): 
- [Product Batch Item Error](https://dev.wherehouse.co.za/schema-17363135.md): 
- [Listing Submission Result](https://dev.wherehouse.co.za/schema-16742808.md): 
- [Product Listing](https://dev.wherehouse.co.za/schema-16742809.md): 
- [Product Batch Status](https://dev.wherehouse.co.za/schema-17363136.md): 
- [Listing Seller Account](https://dev.wherehouse.co.za/schema-16742810.md): 
- [Public API Auth Error](https://dev.wherehouse.co.za/schema-16742812.md): 
- [Public API Rate Limit Error](https://dev.wherehouse.co.za/schema-16742813.md):