# Groupon — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find and access verified discount codes from Groupon Coupons for your favorite stores to save money on purchases. Get current active coupon codes that have been validated and are ready to use.

**Category:** E-commerce | **Website:** [www.groupon.com/](https://www.groupon.com/) | **Docs:** [parse.bot/marketplace/b1d268fe-69ad-4796-b5a0-0e130e64875d/groupon-com-api](https://parse.bot/marketplace/b1d268fe-69ad-4796-b5a0-0e130e64875d/groupon-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-groupon-com-api-b1d268fe/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_verified_codes

Retrieves active, verified promo codes for a given store. Returns only codes (not deals) that carry Groupon's Verified badge, sorted by popularity (uses today, descending). Each code includes the discount title, the actual promo code string, usage count, and expiry date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store` | string | Yes | Store slug as it appears in the Groupon Coupons URL path (e.g. 'amazon', 'nike', 'target'). Lowercase alphanumeric with hyphens. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-groupon-com-api-b1d268fe/get_verified_codes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"<string>"}'
```