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

# Public API Reference

> Unauthenticated endpoints powering shareable reseller links and the /shop storefront

The Public API backs the two surfaces an end customer can reach without an account: a reseller's shareable link, and the consumer storefront at offergrid.io/shop. No API key is required, and every endpoint re-checks coverage server-side.

<Info>
  **Base URL** `https://api.offergrid.io`

  **Authentication** None. These endpoints are deliberately unauthenticated.

  **OpenAPI spec** [`openapi-public.json`](/docs/openapi/openapi-public.json)
</Info>

## Public

Public: Unauthenticated endpoints for shareable links and the /shop storefront

| Endpoint                                                                                                                                        | Method | Path                               | What it does                                                                                                                                                    |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Get link details](/docs/public-api-reference/public/get-link-details)                                                                               | `GET`  | `/public/links/{slug}`             | Retrieve public information about a shareable link, including the service address and property name.                                                            |
| [Get available offers for a link](/docs/public-api-reference/public/get-available-offers-for-a-link)                                                 | `GET`  | `/public/links/{slug}/offers`      | Retrieve all service offers available for the address associated with this link.                                                                                |
| [Submit an order via a shareable link](/docs/public-api-reference/public/submit-an-order-via-a-shareable-link)                                       | `POST` | `/public/links/{slug}/orders`      | Create a new order for the selected service offers.                                                                                                             |
| [Browse consumer-enabled offers](/docs/public-api-reference/public/browse-consumer-enabled-offers)                                                   | `GET`  | `/public/shop/offers`              | Returns active, consumer-enabled offers, optionally filtered by ZIP/city/state (coverage-checked through the offer's markets) and category.                     |
| [Get a consumer offer by its public slug](/docs/public-api-reference/public/get-a-consumer-offer-by-its-public-slug)                                 | `GET`  | `/public/shop/offers/{publicSlug}` | Full pricing/compliance detail for one consumer-enabled offer.                                                                                                  |
| [Check address-level serviceability for on-screen offers](/docs/public-api-reference/public/check-address-level-serviceability-for-on-screen-offers) | `POST` | `/public/shop/serviceability`      | Given a full street address, returns per-offer serviceability + exact price for offers whose markets reference an external serviceability source.               |
| [Place a checkout-mode shop order](/docs/public-api-reference/public/place-a-checkout-mode-shop-order)                                               | `POST` | `/public/shop/orders`              | Creates an order through the canonical transactional path (idempotent, snapshotted, outbox-emitting), attributed to the house reseller team.                    |
| [Record an outbound shop click](/docs/public-api-reference/public/record-an-outbound-shop-click)                                                     | `POST` | `/public/shop/clicks`              | Logs a click for a consumer offer — a lead\_gen click returns a redirectUrl (the provider URL with Offergrid attribution merged on); a checkout-mode click is … |

## Conventions

Every endpoint on this page follows the shared [API conventions](/docs/api-reference/conventions) for list responses, identifiers, timestamps, and money, and the shared [error format](/docs/api-reference/errors).