# Getquip — 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.

> Manage your Quip oral care shopping experience by adding items to your cart, reviewing cart contents, and browsing detailed product information. Get instant access to product specs, pricing, and your current shopping cart status from the Quip store.

**Category:** E-commerce | **Website:** [www.getquip.com/](https://www.getquip.com/) | **Docs:** [parse.bot/marketplace/02f344d7-6fbc-4033-b9b4-62ae3d0cad53/getquip-com-api](https://parse.bot/marketplace/02f344d7-6fbc-4033-b9b4-62ae3d0cad53/getquip-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-getquip-com-api-02f344d7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### add_to_cart

Add a product variant to the shopping cart. Requires a Shopify variant ID (obtainable from get_product). Optionally specify quantity and a selling plan ID for subscription pricing. Returns details of the items successfully added. Each call creates a fresh cart session unless chained with get_cart via session persistence.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `quantity` | integer | No | Number of units to add to cart. |
| `selling_plan` | string | No | Numeric Shopify selling plan ID for subscription pricing. When provided, the item is added at the subscription discount price. |
| `variant_id` | string | Yes | Numeric Shopify variant ID identifying the specific product variant to add (e.g. '41853010575434'). Obtain from get_product endpoint's variants[*].id field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-getquip-com-api-02f344d7/add_to_cart \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"quantity":"<integer>","selling_plan":"<string>","variant_id":"<string>"}'
```

### get_cart

Retrieve the current cart contents including all items, quantities, prices, and totals. Requires a prior add_to_cart call in the same session to have meaningful content (otherwise returns an empty cart).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `encryption_key` | string | Yes | Encryption key from login response |
| `session_id` | string | Yes | Session ID from login response |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-getquip-com-api-02f344d7/get_cart \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"encryption_key":"<string>","session_id":"<string>"}'
```

### get_product

Get product details by handle (URL slug). Returns product information including all available variant IDs needed for add_to_cart, pricing, options, and images.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product URL slug (handle), e.g. 'dusk-quip-ultra-next-generation-smart-sonic-electric-toothbrush'. Found in product page URLs after /products/. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-getquip-com-api-02f344d7/get_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"<string>"}'
```