# Foundry IMS Storefront API

**Canonical:** https://apis.io/apis/foundryims-com/foundryims-com-storefront-api/  
**Provider:** Foundry IMS — https://apis.io/providers/foundryims-com/  
**Base URL:** https://api.foundryims.com/api/v1/storefront  
**Documentation:** https://foundryims.com/docs/storefront-api/

Foundry IMS Storefront API is published by [Foundry IMS](https://apis.io/providers/foundryims-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Storefront. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The storefront API from Foundry IMS — 16 operation(s) for storefront.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/storefront/products` | List products visible on this storefront channel |
| GET | `/api/v1/storefront/products/{idOrSlug}` | Get a single product with variants, options, and images |
| GET | `/api/v1/storefront/variants/{id}` | Resolve a single variant by id (price, availability, options, product) — for… |
| GET | `/api/v1/storefront/categories` | Hierarchical category tree for this storefront channel |
| GET | `/api/v1/storefront/categories/{slug}/products` | Products in a specific category (slug or id) |
| GET | `/api/v1/storefront/categories/{slug}` | Category detail: descriptions + visible custom fields (by slug) |
| GET | `/api/v1/storefront/navigation` | Typed navigation tree for this storefront (categories + links + groups) |
| GET | `/api/v1/storefront/brands` | Flat list of brands with at least one listed product |
| GET | `/api/v1/storefront/brands/{slug}` | Brand detail: descriptions + visible custom fields (by slug) |
| GET | `/api/v1/storefront/search` | Free-text search across product name + description |
| POST | `/api/v1/storefront/inventory/check` | Real-time inventory check (cart pre-checkout) |
| POST | `/api/v1/storefront/orders` | Create a storefront order |
| POST | `/api/v1/storefront/orders/{id}/regenerate-lookup-token` | Regenerate the customer-facing lookup token |
| GET | `/api/v1/storefront/orders/{lookupToken}` | Customer-facing order status lookup (no auth — token IS the auth) |
| GET | `/api/v1/storefront/webhook` | Current webhook config for this key's channel (no secret) |
| PUT | `/api/v1/storefront/webhook` | Set the outbound webhook delivery URL (https, public host) |
| DELETE | `/api/v1/storefront/webhook` | Stop deliveries by clearing the webhook URL |
| POST | `/api/v1/storefront/webhook/rotate-secret` | Generate a new signing secret (returned once) |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/foundryims-com/openapi/foundryims-com-storefront-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/foundryims-com/json-schema/foundryims-com-storefront-product-detail-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundryims-com/json-schema/foundryims-com-storefront-variant-resolved-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundryims-com/json-schema/foundryims-com-storefront-category-node-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundryims-com/json-schema/foundryims-com-storefront-nav-node-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundryims-com/json-schema/foundryims-com-storefront-category-detail-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundryims-com/json-schema/foundryims-com-storefront-brand-detail-dto-schema.json
- **APIsJSON** — https://artifacts.apis.io/foundryims-com/apis.yml

## Tags

Storefront

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/foundryims-com/foundryims-com-storefront-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/foundryims-com/.