---
title: "Search free trials"
method: GET
path: "/api/v1/trials"
---

# Search free trials

`GET /api/v1/trials`

## Request

- Base URL: `https://andrewsfreebies.com`
- URL: `https://andrewsfreebies.com/api/v1/trials`
- Auth: none declared

## Query parameters

- `q` string
- `category` string
- `card` 'no-card'
- `offer_type` 'free-trial' | 'free-plan' | 'money-back-guarantee' | 'promotional-offer' | 'directory-listing'
- `status` 'verified' | 'source-found' | 'conditional' | 'directory-listed'
- `limit` integer
- `offset` integer

## Response `200`

A paginated list of matching trials

- SearchResponse
  - `count` integer
  - `returned` integer
  - `next` string, nullable
  - `items` Trial[]
    - `id` string, required
    - `name` string, required
    - `provider` string, required
    - `offer_type` 'free-trial' | 'free-plan' | 'money-back-guarantee' | 'promotional-offer' | 'directory-listing', required
    - `summary` string
    - `capabilities` string[]
    - `status` string, required
    - `last_checked` string, date
    - `verification_readiness` VerificationReadiness, required
      - `status` 'audit-confirmed-exact' | 'audit-confirmed-partial' | 'audit-inconclusive' | 'audit-warning' | 'not-audited', required
      - `latest_outcome` 'confirmed-exact' | 'confirmed-partial' | 'terms-changed' | 'explicitly-expired' | 'moved' | 'blocked' | 'fetch-error' | 'not-found' | 'unknown', required: Conservative field-level audit result. blocked, fetch-error, not-found, and unknown do not establish expiration.
      - `latest_checked_at` string, date-time, nullable, required
      - `interpretation` string, required: Factual guidance for using the latest audit without treating an inconclusive fetch as expiration.
    - `action_url` string, uri, nullable, required: Measured official-action path; null means the record is inspectable but must not be recommended for action.
    - `official_action` OfficialActionState, required
      - `allowed` boolean, required
      - `status` 'ready' | 'source-navigation' | 'withheld', required
      - `reason` string, required: Instruction for whether an agent may recommend the official action path.
    - `signup_url` string, uri
    - `activation` object, required: Machine-readable navigation quality, kept separate from evidence verification.
      - `direct` boolean
      - `specificity` 'verified-offer-page' | 'offer-page' | 'provider-path' | 'provider-homepage' | 'unknown'
      - `terms_found` boolean
      - `checked_at` string
      - `http_status` integer, nullable
    - `source_url` string, uri
    - `source` object, required
      - `kind` 'provider' | 'directory'
      - `primary_url` string, uri
      - `evidence` object[]
    - `trial` object, required
      - `duration_days` integer, nullable
      - `duration_label` string
      - `credit_card` string
      - `auto_renews` string
      - `post_trial_price` string, nullable
      - `eligibility` string
      - `regions` string[]

---

[API](https://skmtc.dev/andrewsfreebies/apis/andrew-s-freebies-api.md) · [All operations](https://skmtc.dev/andrewsfreebies/apis/andrew-s-freebies-api/llms.txt) · [OpenAPI document](https://skmtc.dev/andrewsfreebies/apis/andrew-s-freebies-api/revisions/2e23a7a12f7a?raw)