---
title: "Get your cart"
method: GET
path: "/api/v1/cart"
tags: ["Cart"]
---

# Get your cart

`GET /api/v1/cart`

## Request

- Base URL: `https://spoofy.social`
- URL: `https://spoofy.social/api/v1/cart`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

Every line at today’s price, with its delivery estimate and anything that stops it, the total of what can go, and your balance. The web app’s cart: an agent may fill it for you to check and pay.

## Response `200`

Your cart.

- object
  - `cart` Cart
    - `items` CartItem[]
      - `id` string
      - `service` object, nullable: null when the service is no longer on sale.
      - `link` string
      - `linkInfo` object, nullable
        - `platform` string
        - `kind` string
        - `label` string
      - `linkKey` string: The tidied link the cart groups by.
      - `quantity` integer, nullable
      - `units` integer, nullable: What is charged: the quantity, or what the order fields come to.
      - `inputs` object, nullable
      - `schedule` ItemSchedule: Deliver this order on a schedule instead of all at once: it becomes an automation (the same fields as `POST /api/v1/automations`, without service, link and quantity). `quantity` is then the automation’s — all of it for `spread`, `split` or `scheduled`, each time for `recurring`. Each part is charged when it goes.
        - `kind` 'spread' | 'scheduled' | 'recurring' | 'split', required
        - `start_at` string: ISO 8601 with an offset; a later start.
        - `timezone` string: IANA zone, e.g. "America/Costa_Rica".
        - `runs` integer: spread: this many runs, `interval_minutes` apart.
        - `interval_minutes` number
        - `over` string: spread: over "1d", "3d", "7d" or "14d" in natural parts.
        - `pace` string: spread: even, steady, front or back.
        - `natural` boolean
        - `every` unknown
        - `times` integer: recurring: how many times.
      - `total` string, nullable: Its price now, USD (a schedule: about its whole plan; the exact plan rounds each part up).
      - `totalMicros` string, nullable
      - `delivery` string, nullable: The delivery estimate in words.
      - `plan` string, nullable: A schedule in words.
      - `problem` object, nullable: Why it cannot go as it is (`code`, `message`), else null.
        - `code` string
        - `message` string
      - `createdAt` string, date-time
    - `count` integer
    - `total` string: Today’s price of the lines that can go. USD as a decimal string.
    - `totalMicros` string
    - `balance` string: Your balance. USD as a decimal string.

## Other responses

- `401`: No valid API key or session.
- `429`: Slow down: too many requests in a short time. Wait `Retry-After` seconds and carry on.

---

[API](https://skmtc.dev/spoofy/apis/spoofy-api.md) · [All operations](https://skmtc.dev/spoofy/apis/spoofy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spoofy/apis/spoofy-api/revisions/58adc986f826?raw)