Andrew's Freebies

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'A guide:SLUG, trial:SLUG, or entitlement:SLUG id returned by search.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id', 'title', 'text', 'url', 'metadata'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'text': {'type': 'string'}, 'title': {'type': 'string'}, 'offers': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'record_type', 'title', 'provider', 'summary', 'status', 'last_checked', 'source_url', 'action_url', 'verification_readiness', 'terms'], 'properties': {'id': {'type': 'string'}, 'terms': {'type': 'object', 'additionalProperties': {'type': ['string', 'null']}}, 'title': {'type': 'string'}, 'status': {'type': 'string'}, 'summary': {'type': 'string'}, 'provider': {'type': 'string'}, 'action_url': {'type': 'string', 'format': 'uri'}, 'source_url': {'type': 'string', 'format': 'uri'}, 'record_type': {'enum': ['trial', 'entitlement'], 'type': 'string'}, 'last_checked': {'type': 'string'}, 'verification_readiness': {'type': 'object', 'required': ['status', 'latest_outcome', 'latest_checked_at', 'interpretation'], 'properties': {'status': {'enum': ['audit-confirmed-exact', 'audit-confirmed-partial', 'audit-inconclusive', 'audit-warning', 'not-audited'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'latest_outcome': {'type': ['string', 'null']}, 'latest_checked_at': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'description': "Current matched records for a guide. Each action_url is a measured redirect to that record's cataloged official destination."}, 'metadata': {'type': 'object', 'required': ['record_type', 'provider', 'status', 'last_checked', 'source_url', 'action_url'], 'properties': {'status': {'type': 'string'}, 'provider': {'type': 'string'}, 'action_url': {'type': ['string', 'null'], 'format': 'uri'}, 'source_url': {'type': 'string', 'format': 'uri'}, 'record_type': {'enum': ['trial', 'entitlement', 'guide'], 'type': 'string'}, 'last_checked': {'type': 'string'}, 'copy_checked_at': {'type': ['string', 'null']}, 'official_action': {'type': 'object', 'required': ['allowed', 'status', 'reason'], 'properties': {'reason': {'type': 'string'}, 'status': {'enum': ['ready', 'source-navigation', 'withheld'], 'type': 'string'}, 'allowed': {'type': 'boolean'}}, 'additionalProperties': False}, 'offers_truncated': {'type': 'boolean'}, 'matched_offer_count': {'type': 'integer', 'minimum': 0}, 'returned_offer_count': {'type': 'integer', 'minimum': 0}, 'verification_readiness': {'type': 'object', 'required': ['status', 'latest_outcome', 'latest_checked_at', 'interpretation'], 'properties': {'status': {'enum': ['audit-confirmed-exact', 'audit-confirmed-partial', 'audit-inconclusive', 'audit-warning', 'not-audited'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'latest_outcome': {'type': ['string', 'null']}, 'latest_checked_at': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'required': ['record_id', 'evidence_url'], 'properties': {'note': {'type': 'string', 'description': 'Optional concise factual observation, up to 1,000 characters; never include credentials or personal data.'}, 'reporter': {'type': 'string', 'description': 'Optional agent or integration label, up to 120 characters; never include a person’s identity.'}, 'record_id': {'type': 'string', 'description': 'Exact existing id returned by Andrew’s Freebies search or record lookup.'}, 'record_type': {'enum': ['trial', 'entitlement'], 'type': 'string', 'description': 'Use the record type returned by search when known; omit only when the id uniquely resolves.'}, 'evidence_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Current first-party HTTP(S) page supporting the report. Do not submit a rumor, search result, directory, or unrelated provider page.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['api_version', 'flag', 'record', 'original_record_unchanged', 'review_status'], 'properties': {'flag': {'type': 'object', 'description': 'Append-only internal review signal receipt.', 'additionalProperties': True}, 'record': {'type': 'object', 'required': ['record_type', 'record_id', 'name', 'web_url'], 'properties': {'name': {'type': 'string'}, 'web_url': {'type': 'string'}, 'record_id': {'type': 'string'}, 'record_type': {'enum': ['trial', 'entitlement'], 'type': 'string'}}, 'additionalProperties': False}, 'api_version': {'type': 'string'}, 'review_status': {'type': 'string', 'const': 'open'}, 'original_record_unchanged': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 100, 'minimum': 1, 'description': 'Maximum matching records to return.'}, 'outcome': {'enum': ['confirmed-exact', 'confirmed-partial', 'terms-changed', 'explicitly-expired', 'moved', 'blocked', 'fetch-error', 'not-found', 'unknown'], 'type': 'string', 'description': 'Optional latest-audit outcome filter; outcomes describe evidence, not guaranteed availability.'}, 'record_id': {'type': 'string', 'maxLength': 200, 'description': 'Optional exact non-directory record id; requires record_type and scopes totals and items to that record.'}, 'record_type': {'enum': ['trial', 'entitlement'], 'type': 'string', 'description': 'Optional corpus filter; required when record_id is provided.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['api_version', 'catalog_scope', 'filters', 'totals', 'by_freshness', 'by_evidence_resolution', 'by_outcome', 'evidence_resolution_interpretation', 'oldest_checked_at', 'newest_checked_at', 'operations', 'items', 'policy'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Newest matching records and their cadence schedules.'}, 'policy': {'type': 'string'}, 'totals': {'type': 'object', 'description': 'Catalog, cadence, attempted-coverage, and supporting-evidence totals.', 'additionalProperties': {'type': 'number'}}, 'filters': {'type': 'object', 'required': ['record_type', 'record_id', 'outcome'], 'properties': {'outcome': {'type': ['string', 'null']}, 'record_id': {'type': ['string', 'null']}, 'record_type': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'by_outcome': {'type': 'object', 'additionalProperties': {'type': 'integer', 'minimum': 0}}, 'operations': {'type': 'object', 'description': 'Scheduler-origin heartbeat and liveness fields.', 'additionalProperties': True}, 'api_version': {'type': 'string'}, 'by_freshness': {'type': 'object', 'additionalProperties': {'type': 'integer', 'minimum': 0}}, 'catalog_scope': {'type': 'string', 'description': 'The exact record population used by cadence and evidence totals.'}, 'newest_checked_at': {'type': ['string', 'null']}, 'oldest_checked_at': {'type': ['string', 'null']}, 'by_evidence_resolution': {'type': 'object', 'additionalProperties': {'type': 'integer', 'minimum': 0}}, 'evidence_resolution_interpretation': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Exact record id returned by search_freebies.'}, 'record_type': {'enum': ['trial', 'entitlement'], 'type': 'string', 'description': 'Use the record_type returned by search_freebies when known.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['record_type', 'id', 'name', 'provider', 'status', 'last_checked', 'source_url', 'action_url', 'official_action', 'verification_readiness'], 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'status': {'type': 'string'}, 'provider': {'type': 'string'}, 'action_url': {'type': ['string', 'null'], 'format': 'uri'}, 'source_url': {'type': 'string', 'format': 'uri'}, 'record_type': {'enum': ['trial', 'entitlement'], 'type': 'string'}, 'last_checked': {'type': 'string'}, 'official_action': {'type': 'object', 'required': ['allowed', 'status', 'reason'], 'properties': {'reason': {'type': 'string'}, 'status': {'enum': ['ready', 'source-navigation', 'withheld'], 'type': 'string'}, 'allowed': {'type': 'boolean'}}, 'additionalProperties': False}, 'verification_readiness': {'type': 'object', 'required': ['status', 'latest_outcome', 'latest_checked_at', 'interpretation'], 'properties': {'status': {'enum': ['audit-confirmed-exact', 'audit-confirmed-partial', 'audit-inconclusive', 'audit-warning', 'not-audited'], 'type': 'string'}, 'interpretation': {'type': 'string'}, 'latest_outcome': {'type': ['string', 'null']}, 'latest_checked_at': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'additionalProperties': True}

{'type': 'object', 'required': ['record_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Maximum append-only audit events to return.'}, 'record_id': {'type': 'string', 'description': 'Exact trial or entitlement id returned by search or search_freebies.'}, 'record_type': {'enum': ['trial', 'entitlement'], 'type': 'string', 'description': 'Use the record type returned by search when known; omit only when the id uniquely resolves.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['api_version', 'record', 'count', 'items', 'append_only'], 'properties': {'count': {'type': 'integer', 'minimum': 0}, 'items': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Newest-first append-only verification events.'}, 'record': {'type': 'object', 'required': ['record_type', 'record_id', 'name', 'category', 'web_url'], 'properties': {'name': {'type': 'string'}, 'web_url': {'type': 'string'}, 'category': {'type': 'string'}, 'record_id': {'type': 'string'}, 'record_type': {'enum': ['trial', 'entitlement'], 'type': 'string'}}, 'additionalProperties': False}, 'api_version': {'type': 'string'}, 'append_only': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query'], 'properties': {'query': {'type': 'string', 'maxLength': 160, 'minLength': 2, 'description': 'The user’s natural-language savings question, including a provider, product, desired value, condition, or task when known.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['results'], 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'title', 'url'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'title': {'type': 'string'}}, 'additionalProperties': False}}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'default': 12, 'maximum': 25, 'minimum': 1, 'description': 'Maximum normalized items to return; answer guides are reported separately.'}, 'query': {'type': 'string', 'maxLength': 160, 'minLength': 2, 'description': "The user's need in natural language, including provider, product, eligibility, or desired value."}, 'scope': {'enum': ['auto', 'actionable', 'software', 'savings', 'public-benefits', 'open-source', 'all'], 'type': 'string', 'default': 'auto', 'description': 'auto routes ordinary requests to actionable trials/savings and explicit public-service needs to the broader benefits corpus.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['api_version', 'query', 'requested_scope', 'resolved_scope', 'count', 'answer_guide_count', 'result_count', 'sources', 'answer_guides', 'items', 'usage'], 'properties': {'count': {'type': 'integer', 'minimum': 0, 'description': 'Normalized record and repository results returned in items.'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['result_type', 'record_type'], 'properties': {'id': {'type': ['string', 'integer']}, 'name': {'type': 'string'}, 'action_url': {'type': ['string', 'null'], 'format': 'uri'}, 'record_type': {'enum': ['trial', 'entitlement', None], 'type': ['string', 'null']}, 'result_type': {'enum': ['trial', 'saving', 'public-benefit', 'open-source-repository'], 'type': 'string'}}, 'additionalProperties': True}, 'description': 'Ranked normalized records or, only under an explicit open-source scope, public repository results.'}, 'query': {'type': 'string', 'description': 'Normalized user query used for retrieval.'}, 'usage': {'type': 'object', 'description': 'Next-step, ranking, and caution guidance for the returned result set.', 'additionalProperties': {'type': 'string'}}, 'sources': {'type': 'object', 'description': 'Per-corpus matched, omitted, and returned counts.', 'additionalProperties': True}, 'api_version': {'type': 'string', 'description': 'Andrew’s Freebies search contract version.'}, 'result_count': {'type': 'integer', 'minimum': 0, 'description': 'Complete count across answer_guides and items.'}, 'answer_guides': {'type': 'array', 'items': {'type': 'object', 'required': ['result_type', 'id', 'title', 'description', 'updated', 'source_backed_matches', 'url', 'markdown_url', 'agent_instruction'], 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string', 'format': 'uri'}, 'title': {'type': 'string'}, 'updated': {'type': 'string'}, 'description': {'type': 'string'}, 'result_type': {'type': 'string', 'const': 'answer-guide'}, 'markdown_url': {'type': 'string', 'format': 'uri'}, 'agent_instruction': {'type': 'string'}, 'source_backed_matches': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'resolved_scope': {'enum': ['actionable', 'software', 'savings', 'public-benefits', 'open-source', 'all'], 'type': 'string'}, 'requested_scope': {'enum': ['auto', 'actionable', 'software', 'savings', 'public-benefits', 'open-source', 'all'], 'type': 'string'}, 'answer_guide_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}