---
title: "Read the conditions and details you can ask for on one record type"
method: GET
path: "/v1/spec-options/{target}"
---

# Read the conditions and details you can ask for on one record type

`GET /v1/spec-options/{target}`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/spec-options/{target}`
- Auth: API key in header `Authorization`

## Path parameters

- `target` string, required

## Response `200`

Request options

- object
  - `data` SpecOptionsData, required
    - `semantic_binding` SemanticBinding
      - `spec_version` 'semantic_binding.v1'
      - `catalog_sha256` string, required
      - `target_id` string, required
      - `footprint_id` string, nullable
    - `target_refinements` TargetDefinition[]
      - `target_id` string, required
      - `entity_type` 'local_business' | 'creator' | 'organization' | 'storefront_product' | 'app_listing' | 'job_posting' | 'scholarly_work' | 'tender' | 'grant' | 'software_repository' | 'software_package' | 'dataset' | 'clinical_trial' | 'regulatory_document' | 'vulnerability' | 'book' | 'podcast' | 'web_page' | 'knowledge_entity' | 'person', required
      - `grain` string, required
      - `phrases` string[]
      - `retrieval_noun` string, required
      - `retrieval_aliases` string[]
      - `footprint_id` string, nullable
    - `entity_type` 'local_business' | 'creator' | 'organization' | 'storefront_product' | 'app_listing' | 'job_posting' | 'scholarly_work' | 'tender' | 'grant' | 'software_repository' | 'software_package' | 'dataset' | 'clinical_trial' | 'regulatory_document' | 'vulnerability' | 'book' | 'podcast' | 'web_page' | 'knowledge_entity' | 'person', required
    - `target_label` string, required
    - `must_match` MustMatchOption[], required
      - `field_id` string, required
      - `label` string, required
      - `value_type` string, required
      - `operators` PredicateOp[], required
    - `bring_back` BringBackOption[], required
      - `field_id` string, required
      - `label` string, required
      - `value_type` string, required
      - `recommended` boolean, required
      - `contact` boolean, required
      - `definition` string

## Other responses

- `default`: Error envelope

---

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