---
title: "Free sample: a few NAIC IID entities plus the latest edition's changes"
method: GET
path: "/v1/eligibility/sample"
---

# Free sample: a few NAIC IID entities plus the latest edition's changes

`GET /v1/eligibility/sample`

## Request

- Base URL: `https://api.querylines.com`
- URL: `https://api.querylines.com/v1/eligibility/sample`
- Auth: none declared

Free -- the teaser for /v1/eligibility. A few alien companies and Lloyd's syndicates from the current roster, plus recent additions/removals. Full lookup by name or alien ID, the full roster list, and state-specific restriction checks are paid.

## Response `200`

A handful of companies/syndicates plus the latest edition's changes.

- object
  - `authority` string, required
  - `sample` boolean, required
  - `companies` object[], required
    - `alien_id` string, required: NAIC IID identity key, e.g. "AA-1344102" -- stable across name changes.
    - `name` string, nullable, required
    - `entity_type` 'alien_company' | 'lloyds_syndicate', required
    - `country` string, nullable, required
    - `syndicate_no` string, nullable, required: Lloyd's syndicate number; null for alien companies.
    - `managing_agent` string, nullable, required: Lloyd's managing agent; null for alien companies.
    - `status` 'listed' | 'removed', required
    - `eligibility` 'eligible' | 'limited' | 'ineligible' | 'removed', required: Derived eligibility. 'limited' entities are downgraded to 'ineligible' in the response when ?state matches the state named in `restriction` -- never read a restricted entity as plainly 'eligible'.
    - `restriction` string, nullable, required: Paraphrased NAIC footnote (never verbatim); null = no restriction.
    - `listed_since` string, nullable, required: Earliest attributable edition date (YYYY-MM-DD).
    - `listed_since_kind` 'added_on' | 'min_known' | 'null', nullable, required: 'added_on' when a printed Addition pins the date exactly; 'min_known' when it predates our oldest loaded edition.
  - `syndicates` object[], required
    - `alien_id` string, required: NAIC IID identity key, e.g. "AA-1344102" -- stable across name changes.
    - `name` string, nullable, required
    - `entity_type` 'alien_company' | 'lloyds_syndicate', required
    - `country` string, nullable, required
    - `syndicate_no` string, nullable, required: Lloyd's syndicate number; null for alien companies.
    - `managing_agent` string, nullable, required: Lloyd's managing agent; null for alien companies.
    - `status` 'listed' | 'removed', required
    - `eligibility` 'eligible' | 'limited' | 'ineligible' | 'removed', required: Derived eligibility. 'limited' entities are downgraded to 'ineligible' in the response when ?state matches the state named in `restriction` -- never read a restricted entity as plainly 'eligible'.
    - `restriction` string, nullable, required: Paraphrased NAIC footnote (never verbatim); null = no restriction.
    - `listed_since` string, nullable, required: Earliest attributable edition date (YYYY-MM-DD).
    - `listed_since_kind` 'added_on' | 'min_known' | 'null', nullable, required: 'added_on' when a printed Addition pins the date exactly; 'min_known' when it predates our oldest loaded edition.
  - `recent_additions` object[], required
    - `alien_id` string, required: NAIC IID identity key, e.g. "AA-1344102" -- stable across name changes.
    - `name` string, nullable, required
    - `entity_type` 'alien_company' | 'lloyds_syndicate', required
    - `country` string, nullable, required
    - `syndicate_no` string, nullable, required: Lloyd's syndicate number; null for alien companies.
    - `managing_agent` string, nullable, required: Lloyd's managing agent; null for alien companies.
    - `status` 'listed' | 'removed', required
    - `eligibility` 'eligible' | 'limited' | 'ineligible' | 'removed', required: Derived eligibility. 'limited' entities are downgraded to 'ineligible' in the response when ?state matches the state named in `restriction` -- never read a restricted entity as plainly 'eligible'.
    - `restriction` string, nullable, required: Paraphrased NAIC footnote (never verbatim); null = no restriction.
    - `listed_since` string, nullable, required: Earliest attributable edition date (YYYY-MM-DD).
    - `listed_since_kind` 'added_on' | 'min_known' | 'null', nullable, required: 'added_on' when a printed Addition pins the date exactly; 'min_known' when it predates our oldest loaded edition.
  - `recent_removals` object[], required
    - `alien_id` string, required: NAIC IID identity key, e.g. "AA-1344102" -- stable across name changes.
    - `name` string, nullable, required
    - `entity_type` 'alien_company' | 'lloyds_syndicate', required
    - `country` string, nullable, required
    - `syndicate_no` string, nullable, required: Lloyd's syndicate number; null for alien companies.
    - `managing_agent` string, nullable, required: Lloyd's managing agent; null for alien companies.
    - `status` 'listed' | 'removed', required
    - `eligibility` 'eligible' | 'limited' | 'ineligible' | 'removed', required: Derived eligibility. 'limited' entities are downgraded to 'ineligible' in the response when ?state matches the state named in `restriction` -- never read a restricted entity as plainly 'eligible'.
    - `restriction` string, nullable, required: Paraphrased NAIC footnote (never verbatim); null = no restriction.
    - `listed_since` string, nullable, required: Earliest attributable edition date (YYYY-MM-DD).
    - `listed_since_kind` 'added_on' | 'min_known' | 'null', nullable, required: 'added_on' when a printed Addition pins the date exactly; 'min_known' when it predates our oldest loaded edition.
  - `note` string, required
  - `source` string, nullable, required
  - `data_as_of` string, nullable, required: Latest edition's month, YYYY-MM.
  - `report_date` string, nullable, required: Latest edition's effective date.
  - `edition` number, nullable, required: Latest edition number.

---

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