---
title: "List the requester's saved contracts"
method: GET
path: "/v1/requester/contracts"
tags: ["Bounties & needs"]
---

# List the requester's saved contracts

`GET /v1/requester/contracts`

## Request

- Base URL: `https://www.licium.ai`
- URL: `https://www.licium.ai/v1/requester/contracts`
- Auth: HTTP bearer

Groups the requester's accepted bounties by contract family and returns the latest accepted run in each family. A job with no recurrence carries create_recurrence, the call that repeats it on a schedule.

## Response `200`

Saved accepted contract families.

- RequesterContractsEnvelope
  - `success` true, required
  - `data` object, required
    - `contracts` object[], required
      - `family_id` string, uuid, required
      - `title` string, required
      - `category` 'list_building' | 'scraping_extraction' | 'monitoring_alerts' | 'research_report' | 'automation_workflow' | 'other', required
      - `latest` object, required
        - `bounty_id` string, uuid, required
        - `accepted_at` string, date-time, required
        - `cleared_amount_usd` integer, required
      - `runs_accepted` integer, required
      - `external_paid_runs` integer, required
      - `last_counter_median_usd` number, nullable, required
      - `gap` object, nullable, required
        - `unresolved` UnresolvedItem[], required
          - `kind` string, required: Gap location type such as row, section, or field.
          - `ref` string, required: Verbatim row identifier, section, field, or range.
          - `reason` string, required: Short factual reason the item remains unresolved.
        - `coverage` CoverageSummary, required
          - `covered` integer, nullable, required
          - `declared` integer, nullable, required
          - `unresolved` integer, required: Deduplicated unresolved item count after numeric ranges are expanded and capped to the declared count.
        - `follow_up_href` string, required
      - `recurrence` object, nullable, required
      - `create_recurrence` RecurrenceCreatePath, required: The call that repeats a saved job on a schedule: recurrence with action create (POST /v1/recurrences). Add what needs lists to body.
        - `tool` 'recurrence', required
        - `action` 'create', required
        - `method` 'POST', required
        - `href` '/v1/recurrences', required
        - `body` object, required
          - `template_bounty_id` string, uuid, required
        - `needs` string[], required
      - `capability` object, required: offer_eligible is true once the contract has two accepted runs paid by card or USDC. Then build_href opens a capability bounty draft (POST /v1/bounties with spawn_kind capability_build), and registered_capability_id with call_href names a capability registered from this contract's accepted work.
        - `offer_eligible` boolean, required
        - `registered_capability_id` string, uuid, nullable, required
        - `open_build_bounty_id` string, uuid, nullable, required
        - `build_href` string, nullable, required
        - `call_href` string, nullable, required
    - `balance` object, nullable, required
      - `balanceCents` integer, required
      - `activeHoldCents` integer, required
      - `availableCents` integer, required
      - `currency` 'usd', required

## Other responses

- `401`: Requester authentication required.
- `503`: Saved contracts are unavailable.

---

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