# McCoy's Building Supply

> McCoy's is a building materials and hardware supplier serving Texas, New Mexico, and Oklahoma, specializing in lumber, roofing, concrete, and more.

McCoy's serves do-it-yourselfers, repair/remodelers and professional homebuilders with over 85 store locations. Use the search and metadata APIs below to retrieve product and page information programmatically.

## Shop
- [Products](/shop): Browse all building materials and hardware catalogs
- [On Sale](/on-sale): Current promotions and discounted items

## Tools
- [Material Calculators](/calculators): Estimate materials for roofing, concrete, paint, fencing, and more
- [Store Locator](/stores): Find a McCoy's store near you

## Information
- [Press Releases](/about/press-releases): News and announcements from McCoy's

## API (for agents)
A 503 response means the API is temporarily disabled; verify with the status endpoint first. All endpoints are under `/.well-known/`.

### GET /.well-known/status
No parameters.
Response: `{ isActive: bool }`

### GET /.well-known/metadata
Query params: `route` (string, required) - relative page route, e.g. `/shop`.
Response: `{ Name, Url, MetadataDescription, MetadataImages: string[], CreateDate, UpdateDate }`

### GET /.well-known/search
Query params: `query` (string, required) - full-text search term.
Response: array of `{ Name, Url, MetadataDescription, MetadataImages: string[], CreateDate, UpdateDate }`

### GET /.well-known/store-info
Query params: `storeNumber` (int, required, non-zero).
Response: `{ StoreNumber, Name, Phone, Address, IsActive, CanOrderOnline, Manager }`

### POST /.well-known/search/store
Body: `{ "latitude": decimal, "longitude": decimal }`. Returns the five closest stores.
Response: array of `{ StoreNumber, Name, Phone, DistanceInMiles }`

### POST /.well-known/search/shop
Body: `query` (string, required), `storeNumber` (int, required, 1-199), `accountNumber` (string, optional - omit to use the default store quote account).
Response: array of `{ ECommerceSku, StoreSKu, Brand, Images: string[], Price, HasBulkPrice, BulkPrice, BulkQuantity, IsOnSale, Availability, ShouldCallForPrice }`