{ "openapi": "3.1.1", "info": { "title": "AsylumCompass exact Context API", "version": "1.0.0", "description": "R2 implemented Context endpoints only. Source editions and cutoffs are returned per response; contentRevision is distinct. No natural-language query, MCP or future dataset endpoints. JSON Schema draft 2020-12 is generated by the executable response contract." }, "servers": [ { "url": "https://asylumcompass.com" } ], "paths": { "/context.json": { "get": { "x-example-request": "/context.json?period=fy2025", "operationId": "context_en_json", "summary": "Exact Context query (en, json)", "description": "Explicit URL chooses the language; Accept-Language does not change it. Only four business parameters are accepted, including empty values as omitted filters. All duplicates (including repeated empty values) are errors. No silent broadening. Context-specific publication preserves each metric population and time basis. ", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" }, "example": { "schema": "asylumcompass-context-response-1", "locale": "en", "state": "exact", "status": 200, "input": [ [ "period", "fy2025" ] ], "inputOmitted": false, "selection": { "court": "", "judge": "", "nationality": "", "period": "fy2025" }, "links": { "canonicalHtmlUrl": "https://asylumcompass.com/context", "citationUrl": "https://asylumcompass.com/context?period=fy2025", "selfUrl": "https://asylumcompass.com/context.json?period=fy2025" }, "alternatives": [], "ok": true, "publication": { "schema": "asylumcompass-context-publication-1", "contentRevision": "2026-10-15.r2.1", "dataVersion": "eoir-2026-08-court-dispositions-v5", "selection": { "defaultsApplied": false, "explicit": { "court": false, "judge": false, "nationality": false, "period": true } }, "identities": { "court": null, "judge": null, "nationality": null }, "sourceCoverage": { "scope": "not_inferred_from_query", "explanation": "Query availability is not edition-wide source coverage. No source coverage counts are inferred from this selection.", "detailsUrl": null }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "title": "Historical asylum records · United States · All nationalities · FY2025", "summary": "Grants: 28810; Denials: 95771; Grant and denial proceeding records (N): 124581. Only recorded asylum grants and denials enter this denominator; other results are excluded. Proceedings are not people. Historical data is not an individual outcome prediction.", "limitations": [ "Only recorded asylum grants and denials enter this denominator; other results are excluded. Proceedings are not people. Historical data is not an individual outcome prediction.", "Each measure below has its own eligible records. Its denominator differs from the grant-and-denial total.", "A filing record is a proxy, not proof of legal assistance or a causal effect.", "A stored in absentia flag is not proof of the reason for nonattendance." ], "metrics": [ { "id": "gd.grants", "label": "Grants", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 28810, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "gd.denials", "label": "Denials", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 95771, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "gd.n", "label": "Grant and denial proceeding records (N)", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 124581, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "gd.recorded_grant_share", "label": "Recorded grant share", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "percent", "state": "available", "reason": null, "value": 23.125516732085952, "numerator": 28810, "denominator": 124581, "formula": "100*grants/(grants+denials)", "denominatorDefinition": "Grant and denial proceeding records (N)", "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "found.grants", "label": "Grants", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 26793, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "found.denials", "label": "Denials", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 70735, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "found.n", "label": "Grant and denial proceeding records (N)", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 97528, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "found.recorded_grant_share", "label": "Recorded grant share", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "percent", "state": "available", "reason": null, "value": 27.4721105733738, "numerator": 26793, "denominator": 97528, "formula": "100*grants/(grants+denials)", "denominatorDefinition": "Grant and denial proceeding records (N)", "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "not_found.grants", "label": "Grants", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 2017, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "not_found.denials", "label": "Denials", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 25036, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "not_found.n", "label": "Grant and denial proceeding records (N)", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 27053, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "not_found.recorded_grant_share", "label": "Recorded grant share", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "percent", "state": "available", "reason": null, "value": 7.4557350386278785, "numerator": 2017, "denominator": 27053, "formula": "100*grants/(grants+denials)", "denominatorDefinition": "Grant and denial proceeding records (N)", "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "in_absentia.flagged", "label": "Flagged records", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "substantive_RMV_DEP_EXC_decisions", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 312196, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "context" ], "methodUrl": "https://asylumcompass.com/methodology.md" }, { "id": "in_absentia.n", "label": "Eligible flag-group records", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "substantive_RMV_DEP_EXC_decisions", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 795091, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "context" ], "methodUrl": "https://asylumcompass.com/methodology.md" } ], "sources": [ { "id": "context", "officialUrl": "https://www.justice.gov/eoir/foia-library-0", "releaseId": "eoir-2026-08-public-context-complete-v1", "manifestUrl": "https://asylumcompass.com/data/complete-editions.json", "payloadUrl": "https://asylumcompass.com/data/public-context-complete-2026-08.json", "sourceSha256": "0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2", "payloadSha256": "383d0b03b69c75c9c5fb2ba15cc96df5f94d4f3c9c41f1d67305ea87c48a6af7", "dataThrough": "2026-08-31" }, { "id": "population", "officialUrl": "https://www.justice.gov/eoir/foia-library-0", "releaseId": "eoir-2026-08-population-history-v1", "manifestUrl": "https://asylumcompass.com/history-data/manifest.json", "sourceSha256": "0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2", "dataThrough": "2026-08-31" }, { "id": "representation", "officialUrl": "https://www.justice.gov/eoir/foia-library-0", "releaseId": "eoir-2026-08-representation-complete-v1", "manifestUrl": "https://asylumcompass.com/data/complete-editions.json", "payloadUrl": "https://asylumcompass.com/data/representation-counts-2026-08.json", "sourceSha256": "0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2", "payloadSha256": "7a9d64c8f080ad5f5a1ffc913fab8498a5bc88e882b2690328c86bff4392028d", "dataThrough": "2026-08-31" } ], "dependencies": [ { "url": "https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/server-capabilities.json", "sha256": "e1ed2242ac9b1ed52819840925a4c612506aa38642e1be2c616aa4bdba8fc6c3" }, { "url": "https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/national.summary.json", "sha256": "89001c73c63a8bcf2e0b3d8906ac5c4b0706a198fdc69df953e1ea30c0b5f2bc" } ], "dataThrough": "2026-08-31", "citation": { "title": "Historical asylum records · United States · All nationalities · FY2025", "url": "https://asylumcompass.com/context?period=fy2025", "sourceReleaseIds": [ "eoir-2026-08-public-context-complete-v1", "eoir-2026-08-population-history-v1", "eoir-2026-08-representation-complete-v1" ], "dataThrough": "2026-08-31" } }, "error": null } } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } } } }, "head": { "operationId": "context_en_json_head", "summary": "Validate the same Context query, without a response body", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } } } } }, "/context.md": { "get": { "x-example-request": "/context.md?period=fy2025", "operationId": "context_en_md", "summary": "Exact Context query (en, md)", "description": "Explicit URL chooses the language; Accept-Language does not change it. Only four business parameters are accepted, including empty values as omitted filters. All duplicates (including repeated empty values) are errors. No silent broadening. Context-specific publication preserves each metric population and time basis. Markdown is a reading representation of the same validated response.", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" }, "example": "# Historical asylum records · United States · All nationalities · FY2025\n\nGrants: 28810; Denials: 95771; Grant and denial proceeding records (N): 124581. Only recorded asylum grants and denials enter this denominator; other results are excluded. Proceedings are not people. Historical data is not an individual outcome prediction.\n\nexact · FY2025\n\n- **Grants**: 28,810 (proceeding_records)\n {\"id\":\"gd.grants\",\"label\":\"Grants\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":28810,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Denials**: 95,771 (proceeding_records)\n {\"id\":\"gd.denials\",\"label\":\"Denials\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":95771,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Grant and denial proceeding records (N)**: 124,581 (proceeding_records)\n {\"id\":\"gd.n\",\"label\":\"Grant and denial proceeding records (N)\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":124581,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Recorded grant share**: 23.13% (percent)\n {\"id\":\"gd.recorded_grant_share\",\"label\":\"Recorded grant share\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"percent\",\"state\":\"available\",\"reason\":null,\"value\":23.125516732085952,\"numerator\":28810,\"denominator\":124581,\"formula\":\"100*grants/(grants+denials)\",\"denominatorDefinition\":\"Grant and denial proceeding records (N)\",\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Grants**: 26,793 (proceeding_records)\n {\"id\":\"found.grants\",\"label\":\"Grants\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":26793,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Denials**: 70,735 (proceeding_records)\n {\"id\":\"found.denials\",\"label\":\"Denials\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":70735,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Grant and denial proceeding records (N)**: 97,528 (proceeding_records)\n {\"id\":\"found.n\",\"label\":\"Grant and denial proceeding records (N)\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":97528,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Recorded grant share**: 27.47% (percent)\n {\"id\":\"found.recorded_grant_share\",\"label\":\"Recorded grant share\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"percent\",\"state\":\"available\",\"reason\":null,\"value\":27.4721105733738,\"numerator\":26793,\"denominator\":97528,\"formula\":\"100*grants/(grants+denials)\",\"denominatorDefinition\":\"Grant and denial proceeding records (N)\",\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Grants**: 2,017 (proceeding_records)\n {\"id\":\"not_found.grants\",\"label\":\"Grants\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":2017,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Denials**: 25,036 (proceeding_records)\n {\"id\":\"not_found.denials\",\"label\":\"Denials\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":25036,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Grant and denial proceeding records (N)**: 27,053 (proceeding_records)\n {\"id\":\"not_found.n\",\"label\":\"Grant and denial proceeding records (N)\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":27053,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Recorded grant share**: 7.46% (percent)\n {\"id\":\"not_found.recorded_grant_share\",\"label\":\"Recorded grant share\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"percent\",\"state\":\"available\",\"reason\":null,\"value\":7.4557350386278785,\"numerator\":2017,\"denominator\":27053,\"formula\":\"100*grants/(grants+denials)\",\"denominatorDefinition\":\"Grant and denial proceeding records (N)\",\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Flagged records**: 312,196 (proceeding_records)\n {\"id\":\"in_absentia.flagged\",\"label\":\"Flagged records\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"substantive_RMV_DEP_EXC_decisions\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":312196,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"context\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n- **Eligible flag-group records**: 795,091 (proceeding_records)\n {\"id\":\"in_absentia.n\",\"label\":\"Eligible flag-group records\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"substantive_RMV_DEP_EXC_decisions\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":795091,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"context\"],\"methodUrl\":\"https://asylumcompass.com/methodology.md\"}\n\n- Only recorded asylum grants and denials enter this denominator; other results are excluded. Proceedings are not people. Historical data is not an individual outcome prediction.\n- Each measure below has its own eligible records. Its denominator differs from the grant-and-denial total.\n- A filing record is a proxy, not proof of legal assistance or a causal effect.\n- A stored in absentia flag is not proof of the reason for nonattendance.\n\nQuery availability is not edition-wide source coverage. No source coverage counts are inferred from this selection.\n\n- context: eoir-2026-08-public-context-complete-v1; https://asylumcompass.com/data/complete-editions.json; 0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2; 383d0b03b69c75c9c5fb2ba15cc96df5f94d4f3c9c41f1d67305ea87c48a6af7\n- population: eoir-2026-08-population-history-v1; https://asylumcompass.com/history-data/manifest.json; 0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2; \n- representation: eoir-2026-08-representation-complete-v1; https://asylumcompass.com/data/complete-editions.json; 0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2; 7a9d64c8f080ad5f5a1ffc913fab8498a5bc88e882b2690328c86bff4392028d\n\n- https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/server-capabilities.json · SHA-256 e1ed2242ac9b1ed52819840925a4c612506aa38642e1be2c616aa4bdba8fc6c3\n- https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/national.summary.json · SHA-256 89001c73c63a8bcf2e0b3d8906ac5c4b0706a198fdc69df953e1ea30c0b5f2bc\n\nSource and edition: 2026-08-31\n\n[Historical asylum records · United States · All nationalities · FY2025](https://asylumcompass.com/context?period=fy2025)\n\n[JSON](https://asylumcompass.com/context.json?period=fy2025) · [Methodology and denominator](https://asylumcompass.com/methodology.md)\n\n2026-10-15.r2.1 · eoir-2026-08-court-dispositions-v5\n" } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } } } }, "head": { "operationId": "context_en_md_head", "summary": "Validate the same Context query, without a response body", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } } } } }, "/es/context.json": { "get": { "x-example-request": "/es/context.json?period=fy2025", "operationId": "context_es_json", "summary": "Exact Context query (es, json)", "description": "Explicit URL chooses the language; Accept-Language does not change it. Only four business parameters are accepted, including empty values as omitted filters. All duplicates (including repeated empty values) are errors. No silent broadening. Context-specific publication preserves each metric population and time basis. ", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" }, "example": { "schema": "asylumcompass-context-response-1", "locale": "es", "state": "exact", "status": 200, "input": [ [ "period", "fy2025" ] ], "inputOmitted": false, "selection": { "court": "", "judge": "", "nationality": "", "period": "fy2025" }, "links": { "canonicalHtmlUrl": "https://asylumcompass.com/es/context", "citationUrl": "https://asylumcompass.com/es/context?period=fy2025", "selfUrl": "https://asylumcompass.com/es/context.json?period=fy2025" }, "alternatives": [], "ok": true, "publication": { "schema": "asylumcompass-context-publication-1", "contentRevision": "2026-10-15.r2.1", "dataVersion": "eoir-2026-08-court-dispositions-v5", "selection": { "defaultsApplied": false, "explicit": { "court": false, "judge": false, "nationality": false, "period": true } }, "identities": { "court": null, "judge": null, "nationality": null }, "sourceCoverage": { "scope": "not_inferred_from_query", "explanation": "La disponibilidad de la consulta no es la cobertura de toda la edición. Esta selección no permite inferir conteos de cobertura de la fuente.", "detailsUrl": null }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "title": "Registros históricos de asilo · Estados Unidos · Todas las nacionalidades · Año fiscal 2025", "summary": "Concesiones: 28810; Denegaciones: 95771; Registros de procedimientos con concesión o denegación (N): 124581. El denominador incluye solo concesiones y denegaciones de asilo registradas; excluye otros resultados. Los procedimientos no son personas. Los datos históricos no predicen un resultado individual.", "limitations": [ "El denominador incluye solo concesiones y denegaciones de asilo registradas; excluye otros resultados. Los procedimientos no son personas. Los datos históricos no predicen un resultado individual.", "Cada medida siguiente tiene sus propios registros elegibles. Su denominador difiere del total de concesiones y denegaciones.", "El registro de presentación es un indicador indirecto, no prueba de asistencia legal ni de un efecto causal.", "El indicador guardado no demuestra el motivo de la incomparecencia." ], "metrics": [ { "id": "gd.grants", "label": "Concesiones", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 28810, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "gd.denials", "label": "Denegaciones", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 95771, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "gd.n", "label": "Registros de procedimientos con concesión o denegación (N)", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 124581, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "gd.recorded_grant_share", "label": "Proporción registrada de concesiones", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "percent", "state": "available", "reason": null, "value": 23.125516732085952, "numerator": 28810, "denominator": 124581, "formula": "100*grants/(grants+denials)", "denominatorDefinition": "Registros de procedimientos con concesión o denegación (N)", "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "found.grants", "label": "Concesiones", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 26793, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "found.denials", "label": "Denegaciones", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 70735, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "found.n", "label": "Registros de procedimientos con concesión o denegación (N)", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 97528, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "found.recorded_grant_share", "label": "Proporción registrada de concesiones", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "percent", "state": "available", "reason": null, "value": 27.4721105733738, "numerator": 26793, "denominator": 97528, "formula": "100*grants/(grants+denials)", "denominatorDefinition": "Registros de procedimientos con concesión o denegación (N)", "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "not_found.grants", "label": "Concesiones", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 2017, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "not_found.denials", "label": "Denegaciones", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 25036, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "not_found.n", "label": "Registros de procedimientos con concesión o denegación (N)", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 27053, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "not_found.recorded_grant_share", "label": "Proporción registrada de concesiones", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "percent", "state": "available", "reason": null, "value": 7.4557350386278785, "numerator": 2017, "denominator": 27053, "formula": "100*grants/(grants+denials)", "denominatorDefinition": "Registros de procedimientos con concesión o denegación (N)", "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "in_absentia.flagged", "label": "Registros marcados", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "substantive_RMV_DEP_EXC_decisions", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 312196, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "context" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" }, { "id": "in_absentia.n", "label": "Registros elegibles del grupo del indicador", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "substantive_RMV_DEP_EXC_decisions", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 795091, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "context" ], "methodUrl": "https://asylumcompass.com/es/methodology.md" } ], "sources": [ { "id": "context", "officialUrl": "https://www.justice.gov/eoir/foia-library-0", "releaseId": "eoir-2026-08-public-context-complete-v1", "manifestUrl": "https://asylumcompass.com/data/complete-editions.json", "payloadUrl": "https://asylumcompass.com/data/public-context-complete-2026-08.json", "sourceSha256": "0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2", "payloadSha256": "383d0b03b69c75c9c5fb2ba15cc96df5f94d4f3c9c41f1d67305ea87c48a6af7", "dataThrough": "2026-08-31" }, { "id": "population", "officialUrl": "https://www.justice.gov/eoir/foia-library-0", "releaseId": "eoir-2026-08-population-history-v1", "manifestUrl": "https://asylumcompass.com/history-data/manifest.json", "sourceSha256": "0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2", "dataThrough": "2026-08-31" }, { "id": "representation", "officialUrl": "https://www.justice.gov/eoir/foia-library-0", "releaseId": "eoir-2026-08-representation-complete-v1", "manifestUrl": "https://asylumcompass.com/data/complete-editions.json", "payloadUrl": "https://asylumcompass.com/data/representation-counts-2026-08.json", "sourceSha256": "0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2", "payloadSha256": "7a9d64c8f080ad5f5a1ffc913fab8498a5bc88e882b2690328c86bff4392028d", "dataThrough": "2026-08-31" } ], "dependencies": [ { "url": "https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/server-capabilities.json", "sha256": "e1ed2242ac9b1ed52819840925a4c612506aa38642e1be2c616aa4bdba8fc6c3" }, { "url": "https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/national.summary.json", "sha256": "89001c73c63a8bcf2e0b3d8906ac5c4b0706a198fdc69df953e1ea30c0b5f2bc" } ], "dataThrough": "2026-08-31", "citation": { "title": "Registros históricos de asilo · Estados Unidos · Todas las nacionalidades · Año fiscal 2025", "url": "https://asylumcompass.com/es/context?period=fy2025", "sourceReleaseIds": [ "eoir-2026-08-public-context-complete-v1", "eoir-2026-08-population-history-v1", "eoir-2026-08-representation-complete-v1" ], "dataThrough": "2026-08-31" } }, "error": null } } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } } } }, "head": { "operationId": "context_es_json_head", "summary": "Validate the same Context query, without a response body", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } } } } }, "/es/context.md": { "get": { "x-example-request": "/es/context.md?period=fy2025", "operationId": "context_es_md", "summary": "Exact Context query (es, md)", "description": "Explicit URL chooses the language; Accept-Language does not change it. Only four business parameters are accepted, including empty values as omitted filters. All duplicates (including repeated empty values) are errors. No silent broadening. Context-specific publication preserves each metric population and time basis. Markdown is a reading representation of the same validated response.", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" }, "example": "# Registros históricos de asilo · Estados Unidos · Todas las nacionalidades · Año fiscal 2025\n\nConcesiones: 28810; Denegaciones: 95771; Registros de procedimientos con concesión o denegación (N): 124581. El denominador incluye solo concesiones y denegaciones de asilo registradas; excluye otros resultados. Los procedimientos no son personas. Los datos históricos no predicen un resultado individual.\n\nexact · Año fiscal 2025\n\n- **Concesiones**: 28.810 (proceeding_records)\n {\"id\":\"gd.grants\",\"label\":\"Concesiones\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":28810,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Denegaciones**: 95.771 (proceeding_records)\n {\"id\":\"gd.denials\",\"label\":\"Denegaciones\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":95771,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Registros de procedimientos con concesión o denegación (N)**: 124.581 (proceeding_records)\n {\"id\":\"gd.n\",\"label\":\"Registros de procedimientos con concesión o denegación (N)\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":124581,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Proporción registrada de concesiones**: 23,13% (percent)\n {\"id\":\"gd.recorded_grant_share\",\"label\":\"Proporción registrada de concesiones\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"percent\",\"state\":\"available\",\"reason\":null,\"value\":23.125516732085952,\"numerator\":28810,\"denominator\":124581,\"formula\":\"100*grants/(grants+denials)\",\"denominatorDefinition\":\"Registros de procedimientos con concesión o denegación (N)\",\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Concesiones**: 26.793 (proceeding_records)\n {\"id\":\"found.grants\",\"label\":\"Concesiones\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":26793,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Denegaciones**: 70.735 (proceeding_records)\n {\"id\":\"found.denials\",\"label\":\"Denegaciones\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":70735,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Registros de procedimientos con concesión o denegación (N)**: 97.528 (proceeding_records)\n {\"id\":\"found.n\",\"label\":\"Registros de procedimientos con concesión o denegación (N)\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":97528,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Proporción registrada de concesiones**: 27,47% (percent)\n {\"id\":\"found.recorded_grant_share\",\"label\":\"Proporción registrada de concesiones\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"percent\",\"state\":\"available\",\"reason\":null,\"value\":27.4721105733738,\"numerator\":26793,\"denominator\":97528,\"formula\":\"100*grants/(grants+denials)\",\"denominatorDefinition\":\"Registros de procedimientos con concesión o denegación (N)\",\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Concesiones**: 2.017 (proceeding_records)\n {\"id\":\"not_found.grants\",\"label\":\"Concesiones\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":2017,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Denegaciones**: 25.036 (proceeding_records)\n {\"id\":\"not_found.denials\",\"label\":\"Denegaciones\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":25036,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Registros de procedimientos con concesión o denegación (N)**: 27.053 (proceeding_records)\n {\"id\":\"not_found.n\",\"label\":\"Registros de procedimientos con concesión o denegación (N)\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":27053,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Proporción registrada de concesiones**: 7,46% (percent)\n {\"id\":\"not_found.recorded_grant_share\",\"label\":\"Proporción registrada de concesiones\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"percent\",\"state\":\"available\",\"reason\":null,\"value\":7.4557350386278785,\"numerator\":2017,\"denominator\":27053,\"formula\":\"100*grants/(grants+denials)\",\"denominatorDefinition\":\"Registros de procedimientos con concesión o denegación (N)\",\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Registros marcados**: 312.196 (proceeding_records)\n {\"id\":\"in_absentia.flagged\",\"label\":\"Registros marcados\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"substantive_RMV_DEP_EXC_decisions\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":312196,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"context\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n- **Registros elegibles del grupo del indicador**: 795.091 (proceeding_records)\n {\"id\":\"in_absentia.n\",\"label\":\"Registros elegibles del grupo del indicador\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"substantive_RMV_DEP_EXC_decisions\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":795091,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"context\"],\"methodUrl\":\"https://asylumcompass.com/es/methodology.md\"}\n\n- El denominador incluye solo concesiones y denegaciones de asilo registradas; excluye otros resultados. Los procedimientos no son personas. Los datos históricos no predicen un resultado individual.\n- Cada medida siguiente tiene sus propios registros elegibles. Su denominador difiere del total de concesiones y denegaciones.\n- El registro de presentación es un indicador indirecto, no prueba de asistencia legal ni de un efecto causal.\n- El indicador guardado no demuestra el motivo de la incomparecencia.\n\nLa disponibilidad de la consulta no es la cobertura de toda la edición. Esta selección no permite inferir conteos de cobertura de la fuente.\n\n- context: eoir-2026-08-public-context-complete-v1; https://asylumcompass.com/data/complete-editions.json; 0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2; 383d0b03b69c75c9c5fb2ba15cc96df5f94d4f3c9c41f1d67305ea87c48a6af7\n- population: eoir-2026-08-population-history-v1; https://asylumcompass.com/history-data/manifest.json; 0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2; \n- representation: eoir-2026-08-representation-complete-v1; https://asylumcompass.com/data/complete-editions.json; 0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2; 7a9d64c8f080ad5f5a1ffc913fab8498a5bc88e882b2690328c86bff4392028d\n\n- https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/server-capabilities.json · SHA-256 e1ed2242ac9b1ed52819840925a4c612506aa38642e1be2c616aa4bdba8fc6c3\n- https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/national.summary.json · SHA-256 89001c73c63a8bcf2e0b3d8906ac5c4b0706a198fdc69df953e1ea30c0b5f2bc\n\nFuente y edición: 2026-08-31\n\n[Registros históricos de asilo · Estados Unidos · Todas las nacionalidades · Año fiscal 2025](https://asylumcompass.com/es/context?period=fy2025)\n\n[JSON](https://asylumcompass.com/es/context.json?period=fy2025) · [Metodología y denominador](https://asylumcompass.com/es/methodology.md)\n\n2026-10-15.r2.1 · eoir-2026-08-court-dispositions-v5\n" } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } } } }, "head": { "operationId": "context_es_md_head", "summary": "Validate the same Context query, without a response body", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } } } } }, "/zh/context.json": { "get": { "x-example-request": "/zh/context.json?period=fy2025", "operationId": "context_zh_CN_json", "summary": "Exact Context query (zh-CN, json)", "description": "Explicit URL chooses the language; Accept-Language does not change it. Only four business parameters are accepted, including empty values as omitted filters. All duplicates (including repeated empty values) are errors. No silent broadening. Context-specific publication preserves each metric population and time basis. ", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" }, "example": { "schema": "asylumcompass-context-response-1", "locale": "zh-CN", "state": "exact", "status": 200, "input": [ [ "period", "fy2025" ] ], "inputOmitted": false, "selection": { "court": "", "judge": "", "nationality": "", "period": "fy2025" }, "links": { "canonicalHtmlUrl": "https://asylumcompass.com/zh/context", "citationUrl": "https://asylumcompass.com/zh/context?period=fy2025", "selfUrl": "https://asylumcompass.com/zh/context.json?period=fy2025" }, "alternatives": [], "ok": true, "publication": { "schema": "asylumcompass-context-publication-1", "contentRevision": "2026-10-15.r2.1", "dataVersion": "eoir-2026-08-court-dispositions-v5", "selection": { "defaultsApplied": false, "explicit": { "court": false, "judge": false, "nationality": false, "period": true } }, "identities": { "court": null, "judge": null, "nationality": null }, "sourceCoverage": { "scope": "not_inferred_from_query", "explanation": "查询可用性不等于整个来源版本的覆盖情况。此选择不用于推断来源覆盖计数。", "detailsUrl": null }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "title": "历史庇护记录 · 美国 · 所有国籍 · FY2025", "summary": "批准: 28810; 拒绝: 95771; 批准与拒绝的程序记录数（N）: 124581. 分母只包括记录中的庇护批准和拒绝，排除其他结果。程序记录不等于人数。历史数据不是个人结果预测。", "limitations": [ "分母只包括记录中的庇护批准和拒绝，排除其他结果。程序记录不等于人数。历史数据不是个人结果预测。", "以下各项指标使用各自的合格记录，分母不同于批准与拒绝记录总数。", "提交记录是代理指标，不证明实际法律协助或因果效果。", "保存的缺席标记不能证明未出席的原因。" ], "metrics": [ { "id": "gd.grants", "label": "批准", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 28810, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "gd.denials", "label": "拒绝", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 95771, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "gd.n", "label": "批准与拒绝的程序记录数（N）", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 124581, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "gd.recorded_grant_share", "label": "记录中的批准占比", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "percent", "state": "available", "reason": null, "value": 23.125516732085952, "numerator": 28810, "denominator": 124581, "formula": "100*grants/(grants+denials)", "denominatorDefinition": "批准与拒绝的程序记录数（N）", "sourceRefs": [ "population" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "found.grants", "label": "批准", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 26793, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "found.denials", "label": "拒绝", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 70735, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "found.n", "label": "批准与拒绝的程序记录数（N）", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 97528, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "found.recorded_grant_share", "label": "记录中的批准占比", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "percent", "state": "available", "reason": null, "value": 27.4721105733738, "numerator": 26793, "denominator": 97528, "formula": "100*grants/(grants+denials)", "denominatorDefinition": "批准与拒绝的程序记录数（N）", "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "not_found.grants", "label": "批准", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 2017, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "not_found.denials", "label": "拒绝", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 25036, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "not_found.n", "label": "批准与拒绝的程序记录数（N）", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 27053, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "not_found.recorded_grant_share", "label": "记录中的批准占比", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "not_found", "timeBasis": "proceeding_completion", "eligibility": "asylum_grant_or_denial", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "percent", "state": "available", "reason": null, "value": 7.4557350386278785, "numerator": 2017, "denominator": 27053, "formula": "100*grants/(grants+denials)", "denominatorDefinition": "批准与拒绝的程序记录数（N）", "sourceRefs": [ "representation" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "in_absentia.flagged", "label": "带标记记录", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "substantive_RMV_DEP_EXC_decisions", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 312196, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "context" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" }, { "id": "in_absentia.n", "label": "标记群体的合格记录数", "population": { "kind": "national", "courtCode": "", "judgeCode": "", "nationalityCode": "", "group": "all", "timeBasis": "proceeding_completion", "eligibility": "substantive_RMV_DEP_EXC_decisions", "attribution": "stored_source_codes" }, "period": { "id": "fy2025", "start": "2024-10-01", "end": "2025-09-30", "isPartial": false, "basis": "complete_source_fiscal_years" }, "unit": "proceeding_records", "state": "available", "reason": null, "value": 795091, "numerator": null, "denominator": null, "formula": null, "denominatorDefinition": null, "sourceRefs": [ "context" ], "methodUrl": "https://asylumcompass.com/zh/methodology.md" } ], "sources": [ { "id": "context", "officialUrl": "https://www.justice.gov/eoir/foia-library-0", "releaseId": "eoir-2026-08-public-context-complete-v1", "manifestUrl": "https://asylumcompass.com/data/complete-editions.json", "payloadUrl": "https://asylumcompass.com/data/public-context-complete-2026-08.json", "sourceSha256": "0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2", "payloadSha256": "383d0b03b69c75c9c5fb2ba15cc96df5f94d4f3c9c41f1d67305ea87c48a6af7", "dataThrough": "2026-08-31" }, { "id": "population", "officialUrl": "https://www.justice.gov/eoir/foia-library-0", "releaseId": "eoir-2026-08-population-history-v1", "manifestUrl": "https://asylumcompass.com/history-data/manifest.json", "sourceSha256": "0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2", "dataThrough": "2026-08-31" }, { "id": "representation", "officialUrl": "https://www.justice.gov/eoir/foia-library-0", "releaseId": "eoir-2026-08-representation-complete-v1", "manifestUrl": "https://asylumcompass.com/data/complete-editions.json", "payloadUrl": "https://asylumcompass.com/data/representation-counts-2026-08.json", "sourceSha256": "0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2", "payloadSha256": "7a9d64c8f080ad5f5a1ffc913fab8498a5bc88e882b2690328c86bff4392028d", "dataThrough": "2026-08-31" } ], "dependencies": [ { "url": "https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/server-capabilities.json", "sha256": "e1ed2242ac9b1ed52819840925a4c612506aa38642e1be2c616aa4bdba8fc6c3" }, { "url": "https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/national.summary.json", "sha256": "89001c73c63a8bcf2e0b3d8906ac5c4b0706a198fdc69df953e1ea30c0b5f2bc" } ], "dataThrough": "2026-08-31", "citation": { "title": "历史庇护记录 · 美国 · 所有国籍 · FY2025", "url": "https://asylumcompass.com/zh/context?period=fy2025", "sourceReleaseIds": [ "eoir-2026-08-public-context-complete-v1", "eoir-2026-08-population-history-v1", "eoir-2026-08-representation-complete-v1" ], "dataThrough": "2026-08-31" } }, "error": null } } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContextResponse" } } } } } }, "head": { "operationId": "context_zh_CN_json_head", "summary": "Validate the same Context query, without a response body", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } } } } }, "/zh/context.md": { "get": { "x-example-request": "/zh/context.md?period=fy2025", "operationId": "context_zh_CN_md", "summary": "Exact Context query (zh-CN, md)", "description": "Explicit URL chooses the language; Accept-Language does not change it. Only four business parameters are accepted, including empty values as omitted filters. All duplicates (including repeated empty values) are errors. No silent broadening. Context-specific publication preserves each metric population and time basis. Markdown is a reading representation of the same validated response.", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" }, "example": "# 历史庇护记录 · 美国 · 所有国籍 · FY2025\n\n批准: 28810; 拒绝: 95771; 批准与拒绝的程序记录数（N）: 124581. 分母只包括记录中的庇护批准和拒绝，排除其他结果。程序记录不等于人数。历史数据不是个人结果预测。\n\nexact · FY2025\n\n- **批准**: 28,810 (proceeding_records)\n {\"id\":\"gd.grants\",\"label\":\"批准\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":28810,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **拒绝**: 95,771 (proceeding_records)\n {\"id\":\"gd.denials\",\"label\":\"拒绝\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":95771,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **批准与拒绝的程序记录数（N）**: 124,581 (proceeding_records)\n {\"id\":\"gd.n\",\"label\":\"批准与拒绝的程序记录数（N）\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":124581,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **记录中的批准占比**: 23.13% (percent)\n {\"id\":\"gd.recorded_grant_share\",\"label\":\"记录中的批准占比\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"percent\",\"state\":\"available\",\"reason\":null,\"value\":23.125516732085952,\"numerator\":28810,\"denominator\":124581,\"formula\":\"100*grants/(grants+denials)\",\"denominatorDefinition\":\"批准与拒绝的程序记录数（N）\",\"sourceRefs\":[\"population\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **批准**: 26,793 (proceeding_records)\n {\"id\":\"found.grants\",\"label\":\"批准\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":26793,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **拒绝**: 70,735 (proceeding_records)\n {\"id\":\"found.denials\",\"label\":\"拒绝\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":70735,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **批准与拒绝的程序记录数（N）**: 97,528 (proceeding_records)\n {\"id\":\"found.n\",\"label\":\"批准与拒绝的程序记录数（N）\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":97528,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **记录中的批准占比**: 27.47% (percent)\n {\"id\":\"found.recorded_grant_share\",\"label\":\"记录中的批准占比\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"percent\",\"state\":\"available\",\"reason\":null,\"value\":27.4721105733738,\"numerator\":26793,\"denominator\":97528,\"formula\":\"100*grants/(grants+denials)\",\"denominatorDefinition\":\"批准与拒绝的程序记录数（N）\",\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **批准**: 2,017 (proceeding_records)\n {\"id\":\"not_found.grants\",\"label\":\"批准\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":2017,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **拒绝**: 25,036 (proceeding_records)\n {\"id\":\"not_found.denials\",\"label\":\"拒绝\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":25036,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **批准与拒绝的程序记录数（N）**: 27,053 (proceeding_records)\n {\"id\":\"not_found.n\",\"label\":\"批准与拒绝的程序记录数（N）\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":27053,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **记录中的批准占比**: 7.46% (percent)\n {\"id\":\"not_found.recorded_grant_share\",\"label\":\"记录中的批准占比\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"not_found\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"asylum_grant_or_denial\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"percent\",\"state\":\"available\",\"reason\":null,\"value\":7.4557350386278785,\"numerator\":2017,\"denominator\":27053,\"formula\":\"100*grants/(grants+denials)\",\"denominatorDefinition\":\"批准与拒绝的程序记录数（N）\",\"sourceRefs\":[\"representation\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **带标记记录**: 312,196 (proceeding_records)\n {\"id\":\"in_absentia.flagged\",\"label\":\"带标记记录\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"substantive_RMV_DEP_EXC_decisions\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":312196,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"context\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n- **标记群体的合格记录数**: 795,091 (proceeding_records)\n {\"id\":\"in_absentia.n\",\"label\":\"标记群体的合格记录数\",\"population\":{\"kind\":\"national\",\"courtCode\":\"\",\"judgeCode\":\"\",\"nationalityCode\":\"\",\"group\":\"all\",\"timeBasis\":\"proceeding_completion\",\"eligibility\":\"substantive_RMV_DEP_EXC_decisions\",\"attribution\":\"stored_source_codes\"},\"period\":{\"id\":\"fy2025\",\"start\":\"2024-10-01\",\"end\":\"2025-09-30\",\"isPartial\":false,\"basis\":\"complete_source_fiscal_years\"},\"unit\":\"proceeding_records\",\"state\":\"available\",\"reason\":null,\"value\":795091,\"numerator\":null,\"denominator\":null,\"formula\":null,\"denominatorDefinition\":null,\"sourceRefs\":[\"context\"],\"methodUrl\":\"https://asylumcompass.com/zh/methodology.md\"}\n\n- 分母只包括记录中的庇护批准和拒绝，排除其他结果。程序记录不等于人数。历史数据不是个人结果预测。\n- 以下各项指标使用各自的合格记录，分母不同于批准与拒绝记录总数。\n- 提交记录是代理指标，不证明实际法律协助或因果效果。\n- 保存的缺席标记不能证明未出席的原因。\n\n查询可用性不等于整个来源版本的覆盖情况。此选择不用于推断来源覆盖计数。\n\n- context: eoir-2026-08-public-context-complete-v1; https://asylumcompass.com/data/complete-editions.json; 0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2; 383d0b03b69c75c9c5fb2ba15cc96df5f94d4f3c9c41f1d67305ea87c48a6af7\n- population: eoir-2026-08-population-history-v1; https://asylumcompass.com/history-data/manifest.json; 0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2; \n- representation: eoir-2026-08-representation-complete-v1; https://asylumcompass.com/data/complete-editions.json; 0a409ce1b175532df7bb2f0c58d06dd20fa6b4d904d749fde7df1b038ac498e2; 7a9d64c8f080ad5f5a1ffc913fab8498a5bc88e882b2690328c86bff4392028d\n\n- https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/server-capabilities.json · SHA-256 e1ed2242ac9b1ed52819840925a4c612506aa38642e1be2c616aa4bdba8fc6c3\n- https://asylumcompass.com/context-view-data/eoir-2026-08-court-dispositions-v5/national.summary.json · SHA-256 89001c73c63a8bcf2e0b3d8906ac5c4b0706a198fdc69df953e1ea30c0b5f2bc\n\n来源与版本: 2026-08-31\n\n[历史庇护记录 · 美国 · 所有国籍 · FY2025](https://asylumcompass.com/zh/context?period=fy2025)\n\n[JSON](https://asylumcompass.com/zh/context.json?period=fy2025) · [方法与分母](https://asylumcompass.com/zh/methodology.md)\n\n2026-10-15.r2.1 · eoir-2026-08-court-dispositions-v5\n" } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } }, "content": { "text/markdown": { "schema": { "type": "string" } } } } } }, "head": { "operationId": "context_zh_CN_md_head", "summary": "Validate the same Context query, without a response body", "parameters": [ { "name": "court", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source court code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "judge", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source judge code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "nationality", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string" }, "description": "Case-sensitive source nationality code. Empty means omitted. Repeated values, including empty, are invalid." }, { "name": "period", "in": "query", "required": false, "allowEmptyValue": true, "schema": { "type": "string", "default": "fy2025", "examples": [ "fy2025", "annual:2024", "annual:2023", "annual:2022", "annual:2021", "fy2023_2025", "fy2021_2025", "FY2025", "annual:2025", "FY2024", "FY2023_2025", "" ] }, "description": "Seven canonical fiscal periods: fy2025, annual:2024, annual:2023, annual:2022, annual:2021, fy2023_2025, fy2021_2025. Empty/omitted defaults to fy2025. Case-insensitive FY2021–FY2025 and annual:2025 aliases; FY2023_2025/FY2021_2025 accepted. Repeated values, including empty, are invalid." } ], "responses": { "200": { "description": "exact, other-metric, valid-empty, judge-only, historical-only or unrelated. Unavailable is never an implicit zero or national fallback.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "304": { "description": "Validated current successful representation matches If-None-Match; no body.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "400": { "description": "Duplicate business field (first priority), then unknown parameter, then original invalid-period classification.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "404": { "description": "Unknown court, judge, nationality (in that order), or excluded court after identity checks.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "405": { "description": "Only GET and HEAD; Allow: GET, HEAD.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } }, "503": { "description": "Required pinned data unavailable, invalid, oversized, interrupted, wrong hash/version or response validation failed; no-store.", "headers": { "Cache-Control": { "schema": { "type": "string" }, "description": "200: public, max-age=0, must-revalidate. Errors: no-store. Current required dependencies are validated before 304." }, "ETag": { "schema": { "type": "string" }, "description": "Successful representation hash; distinguishes locale, format, raw input/selection, content revision and source dependencies. Weak If-None-Match, lists and * are supported." }, "Link": { "schema": { "type": "string" }, "description": "Exact machine self, response schema describedby, and valid HTML canonical; the default period is explicit in self/citation and omitted in the HTML canonical." }, "Access-Control-Allow-Origin": { "schema": { "const": "*" } }, "Allow": { "schema": { "const": "GET, HEAD" } } } } } } } }, "components": { "schemas": { "ContextResponse": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "type": "object", "properties": { "schema": { "type": "string", "const": "asylumcompass-context-response-1" }, "locale": { "type": "string", "enum": [ "en", "es", "zh-CN" ] }, "state": { "type": "string", "enum": [ "exact", "other-metric", "valid-empty", "judge-only", "historical-only", "unrelated" ] }, "status": { "type": "number", "const": 200 }, "input": { "type": "array", "items": { "type": "array", "prefixItems": [ { "type": "string" }, { "type": "string" } ], "items": false, "minItems": 2, "maxItems": 2 } }, "inputOmitted": { "type": "boolean", "const": false }, "selection": { "type": "object", "properties": { "court": { "type": "string" }, "judge": { "type": "string" }, "nationality": { "type": "string" }, "period": { "type": "string" } }, "required": [ "court", "judge", "nationality", "period" ] }, "links": { "type": "object", "properties": { "canonicalHtmlUrl": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] }, "citationUrl": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] }, "selfUrl": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] } }, "required": [ "canonicalHtmlUrl", "citationUrl", "selfUrl" ] }, "alternatives": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "label": { "type": "string", "minLength": 1 } }, "required": [ "url", "label" ] } }, "ok": { "type": "boolean", "const": true }, "publication": { "type": "object", "properties": { "schema": { "type": "string", "const": "asylumcompass-context-publication-1" }, "contentRevision": { "type": "string", "minLength": 1 }, "dataVersion": { "type": "string", "minLength": 1 }, "selection": { "type": "object", "properties": { "defaultsApplied": { "type": "boolean" }, "explicit": { "type": "object", "properties": { "court": { "type": "boolean" }, "judge": { "type": "boolean" }, "nationality": { "type": "boolean" }, "period": { "type": "boolean" } }, "required": [ "court", "judge", "nationality", "period" ] } }, "required": [ "defaultsApplied", "explicit" ] }, "identities": { "type": "object", "properties": { "court": { "anyOf": [ { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "sourceName": { "type": "string", "minLength": 1 }, "slug": { "type": "string" }, "category": { "type": "string", "minLength": 1 }, "sourceLinked": { "type": [ "boolean", "null" ] }, "attribution": { "type": "string", "minLength": 1 } }, "required": [ "code", "name", "sourceName", "slug", "category", "sourceLinked", "attribution" ] }, { "type": "null" } ] }, "judge": { "anyOf": [ { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "sourceName": { "type": "string", "minLength": 1 }, "slug": { "type": "string" }, "category": { "type": "string", "minLength": 1 }, "sourceLinked": { "type": [ "boolean", "null" ] }, "attribution": { "type": "string", "minLength": 1 } }, "required": [ "code", "name", "sourceName", "slug", "category", "sourceLinked", "attribution" ] }, { "type": "null" } ] }, "nationality": { "anyOf": [ { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "name": { "type": "string", "minLength": 1 }, "sourceName": { "type": "string", "minLength": 1 }, "slug": { "type": "string" }, "category": { "type": "string", "minLength": 1 }, "sourceLinked": { "type": [ "boolean", "null" ] }, "attribution": { "type": "string", "minLength": 1 } }, "required": [ "code", "name", "sourceName", "slug", "category", "sourceLinked", "attribution" ] }, { "type": "null" } ] } }, "required": [ "court", "judge", "nationality" ] }, "sourceCoverage": { "type": "object", "properties": { "scope": { "type": "string", "const": "not_inferred_from_query" }, "explanation": { "type": "string", "minLength": 1 }, "detailsUrl": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] } }, "required": [ "scope", "explanation", "detailsUrl" ] }, "period": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "start": { "anyOf": [ { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "string", "pattern": "^\\d{4}-(0[1-9]|1[0-2])$" } ] }, { "type": "null" } ] }, "end": { "anyOf": [ { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "string", "pattern": "^\\d{4}-(0[1-9]|1[0-2])$" } ] }, { "type": "null" } ] }, "isPartial": { "type": [ "boolean", "null" ] }, "basis": { "type": "string", "minLength": 1 } }, "required": [ "id", "start", "end", "isPartial", "basis" ], "additionalProperties": {} }, "title": { "type": "string", "minLength": 1 }, "summary": { "type": "string", "minLength": 1 }, "limitations": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "metrics": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "label": { "type": "string", "minLength": 1 }, "population": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "national", "nationality", "court", "court_nationality", "judge", "judge_nationality" ] }, "courtCode": { "type": "string" }, "judgeCode": { "type": "string" }, "nationalityCode": { "type": "string" }, "group": { "type": "string", "enum": [ "all", "found", "not_found" ] }, "timeBasis": { "type": "string", "enum": [ "proceeding_completion", "proceeding_entry" ] }, "eligibility": { "type": "string", "enum": [ "asylum_grant_or_denial", "substantive_RMV_DEP_EXC_decisions", "asylum_grant_or_denial_with_usable_input_completion_dates", "all_proceeding_entries" ] }, "attribution": { "type": "string", "const": "stored_source_codes" } }, "required": [ "kind", "courtCode", "judgeCode", "nationalityCode", "group", "timeBasis", "eligibility", "attribution" ] }, "period": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "start": { "anyOf": [ { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "string", "pattern": "^\\d{4}-(0[1-9]|1[0-2])$" } ] }, { "type": "null" } ] }, "end": { "anyOf": [ { "anyOf": [ { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, { "type": "string", "pattern": "^\\d{4}-(0[1-9]|1[0-2])$" } ] }, { "type": "null" } ] }, "isPartial": { "type": [ "boolean", "null" ] }, "basis": { "type": "string", "minLength": 1 } }, "required": [ "id", "start", "end", "isPartial", "basis" ], "additionalProperties": {} }, "unit": { "type": "string", "enum": [ "proceeding_records", "percent", "days" ] }, "state": { "type": "string", "enum": [ "available", "not_calculable", "unavailable" ] }, "reason": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "value": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ] }, "numerator": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "denominator": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "formula": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "denominatorDefinition": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "null" } ] }, "sourceRefs": { "minItems": 1, "type": "array", "items": { "type": "string", "minLength": 1 } }, "methodUrl": { "type": "string", "format": "uri" } }, "required": [ "id", "label", "population", "period", "unit", "state", "reason", "value", "numerator", "denominator", "formula", "denominatorDefinition", "sourceRefs", "methodUrl" ] } }, "sources": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1 }, "officialUrl": { "type": "string", "format": "uri" }, "releaseId": { "type": "string", "minLength": 1 }, "manifestUrl": { "type": "string", "format": "uri" }, "payloadUrl": { "type": "string", "format": "uri" }, "sourceSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "payloadSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "checkedOn": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "dataThrough": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "completionBasis": { "type": "string", "minLength": 1 } }, "required": [ "id", "officialUrl" ], "additionalProperties": {} } }, "dependencies": { "minItems": 1, "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "url", "sha256" ] } }, "dataThrough": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "citation": { "anyOf": [ { "type": "object", "properties": { "title": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "sourceReleaseIds": { "type": "array", "items": { "type": "string", "minLength": 1 } }, "dataThrough": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" } }, "required": [ "title", "url", "sourceReleaseIds", "dataThrough" ] }, { "type": "null" } ] } }, "required": [ "schema", "contentRevision", "dataVersion", "selection", "identities", "sourceCoverage", "period", "title", "summary", "limitations", "metrics", "sources", "dependencies", "dataThrough", "citation" ] }, "error": { "type": "null" } }, "required": [ "schema", "locale", "state", "status", "input", "inputOmitted", "selection", "links", "alternatives", "ok", "publication", "error" ] }, { "type": "object", "properties": { "schema": { "type": "string", "const": "asylumcompass-context-response-1" }, "locale": { "type": "string", "enum": [ "en", "es", "zh-CN" ] }, "state": { "type": "string", "enum": [ "malformed", "unknown-parameter", "invalid-period", "unknown-court", "unknown-judge", "unknown-nationality", "excluded-court", "load-failed", "method-not-allowed" ] }, "status": { "anyOf": [ { "type": "number", "const": 400 }, { "type": "number", "const": 404 }, { "type": "number", "const": 405 }, { "type": "number", "const": 503 } ] }, "input": { "type": "array", "items": { "type": "array", "prefixItems": [ { "type": "string" }, { "type": "string" } ], "items": false, "minItems": 2, "maxItems": 2 } }, "inputOmitted": { "type": "boolean" }, "selection": { "anyOf": [ { "type": "object", "properties": { "court": { "type": "string" }, "judge": { "type": "string" }, "nationality": { "type": "string" }, "period": { "type": "string" } }, "required": [ "court", "judge", "nationality", "period" ] }, { "type": "null" } ] }, "links": { "type": "object", "properties": { "canonicalHtmlUrl": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] }, "citationUrl": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] }, "selfUrl": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] } }, "required": [ "canonicalHtmlUrl", "citationUrl", "selfUrl" ] }, "alternatives": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "label": { "type": "string", "minLength": 1 } }, "required": [ "url", "label" ] } }, "ok": { "type": "boolean", "const": false }, "publication": { "type": "null" }, "error": { "type": "object", "properties": { "code": { "type": "string", "minLength": 1 }, "message": { "type": "string", "minLength": 1 }, "allowedParameters": { "type": "array", "items": { "type": "string", "enum": [ "court", "judge", "nationality", "period" ] } } }, "required": [ "code", "message", "allowedParameters" ] } }, "required": [ "schema", "locale", "state", "status", "input", "inputOmitted", "selection", "links", "alternatives", "ok", "publication", "error" ] } ], "$id": "https://asylumcompass.com/schemas/context-response-v1.json", "title": "AsylumCompass Context response v1", "description": "Exact query response; entity publication-v1 is unchanged. Runtime semantic validation additionally binds metrics, identities, provenance and URLs to the current pinned Context resolution." } } }, "x-parameter-policy": { "allowed": [ "court", "judge", "nationality", "period" ], "priority": [ "duplicate business field", "unknown parameter name", "invalid period", "unknown court", "unknown judge", "unknown nationality", "excluded court", "existing association/availability classifier" ] } }