Public API Reference - Offergrid Docs

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.

Base URL https://api.offergrid.ioAuthentication None. These endpoints are deliberately unauthenticated.OpenAPI spec openapi-public.json

Public

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

Endpoint	Method	Path	What it does
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	`GET`	`/public/links/{slug}/offers`	Retrieve all service offers available for the address associated with this link.
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	`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 id	`GET`	`/public/shop/offers/{id}`	Full pricing/compliance detail for one consumer-enabled offer.
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.
Resolve the electric meter (ESIID) for a service address	`POST`	`/public/shop/esiid-lookup`	Texas (ERCOT) electricity enrollment needs the meter’s ESIID, which a customer would otherwise have to read off a utility bill.
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	`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 …
Withdraw consent to be contacted	`POST`	`/public/consent/revoke`	Backs offergrid.io/opt-out.

Conventions

Every endpoint on this page follows the shared API conventions for list responses, identifiers, timestamps, and money, and the shared error format.