{"openapi":"3.1.0","info":{"title":"AWG Public API","version":"v1","summary":"Authoritative, read-only data from Aligned Workforce Group.","description":"Aligned Workforce Group (AWG) is an independent public-benefit corporation that sets a standard for responsible, workforce-aligned AI adoption by small and medium-sized businesses, and provides assessments, certification, and a vetted partner network against that standard.\n\nThis API lets software and AI agents obtain facts about AWG, the AWG Standard, its credentials, and the standing of any issued credential directly from AWG rather than inferring them from third-party pages or badge images.\n\nNo authentication. Read-only: only GET is supported. Responses are JSON with open CORS. Every object names its issuer and canonical human-readable URL. Individual assessment responses, scores, accounts and any private data are not available through this API.\n\nPlease cache responses according to their Cache-Control headers and keep request rates reasonable; abusive traffic is rate limited.","contact":{"name":"Aligned Workforce Group","email":"contact@withawg.com","url":"https://www.withawg.com/ai"},"termsOfService":"https://www.withawg.com/terms"},"externalDocs":{"description":"Human-readable documentation","url":"https://www.withawg.com/ai/docs"},"servers":[{"url":"https://www.withawg.com/api/public/v1","description":"Production"}],"tags":[{"name":"Organization"},{"name":"Standard"},{"name":"Certifications"},{"name":"Verification","description":"Credential status values: active — The credential is current and in good standing. expired — The credential’s term has ended and it has not been renewed. It was valid until the valid_through date. suspended — AWG has temporarily suspended the credential. It should not be relied on while suspended. revoked — AWG has withdrawn the credential. It is no longer valid. inactive — The credential is not currently in force. superseded — The holder moved to a different tier and this certificate ID was replaced. The response identifies the current credential. not_found — No AWG credential matches this identifier. This says nothing about whether the organization ever held a credential under a different identifier."},{"name":"Partner network"},{"name":"Assessments"},{"name":"Risk map"}],"paths":{"/awg":{"get":{"summary":"About AWG","description":"The canonical machine-readable description of Aligned Workforce Group, and an index of this API.","tags":["Organization"],"responses":{"200":{"description":"Organization description.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Organization"}}}}}}},"/standard":{"get":{"summary":"Current AWG Standard","description":"The version of the AWG Standard currently in force.","tags":["Standard"],"responses":{"200":{"description":"Current version.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Standard"}}}}}}},"/standard/{version}":{"get":{"summary":"A specific AWG Standard version","description":"Any published version, current or superseded. Use the standard_version on a credential to retrieve the text it was issued against.","tags":["Standard"],"parameters":[{"name":"version","in":"path","required":true,"description":"Version identifier.","schema":{"type":"string"},"example":"1.0"}],"responses":{"200":{"description":"The requested version.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Standard"}}}},"404":{"description":"No such version.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/certifications":{"get":{"summary":"Credential definitions","description":"Definitions of all five AWG credentials: requirements, commitments, benefits, pricing and renewal.","tags":["Certifications"],"responses":{"200":{"description":"All credential definitions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CertificationList"}}}}}}},"/certifications/{slug}":{"get":{"summary":"One credential definition","description":"Definition of a single credential.","tags":["Certifications"],"parameters":[{"name":"slug","in":"path","required":true,"description":"One of: ai-aware, ai-aligned, ai-ambassador, certified-provider, strategic-partner.","schema":{"type":"string"},"example":"ai-aligned"}],"responses":{"200":{"description":"The credential definition.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Certification"}}}},"404":{"description":"Unknown slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/verify/{credential_id}":{"get":{"summary":"Verify a credential by certificate ID","description":"The authoritative answer to whether an AWG credential is valid. Works for business certifications and partner credentials. A record that exists but is not in force returns 200 with verified=false and its real status. A 503 means verification is unavailable and says nothing about the credential.","tags":["Verification"],"parameters":[{"name":"credential_id","in":"path","required":true,"description":"Certificate ID: prefix AW, AL, AM, CP or SP, five digits, one check letter.","schema":{"type":"string"},"example":"AW-46842T"}],"responses":{"200":{"description":"A matching record, in force or not. Check \"verified\" and \"status\".","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Verification"},"examples":{"active":{"summary":"A credential in force (fictitious holder)","value":{"verified":true,"status":"active","queried_credential_id":"AL-00001U","queried_id_superseded":false,"holder":{"name":"Example Bakery LLC (fictitious)","name_on_file":true},"credential":{"credential_id":"AL-00001U","name":"AI Aligned","slug":"ai-aligned","type":"business certification","status":"active","status_meaning":"The credential is current and in good standing.","issued_at":"2026-02-01T00:00:00Z","valid_through":"2027-02-01T00:00:00Z","standard_version":"1.0","definition_url":"https://www.withawg.com/api/public/v1/certifications/ai-aligned"},"verification_url":"https://www.withawg.com/verify/AL-00001U","badge_image_url":"https://www.withawg.com/api/credentials/AL-00001U/badge","issuer":{"name":"Aligned Workforce Group","url":"https://www.withawg.com/"},"canonical_url":"https://www.withawg.com/verify/AL-00001U"}},"expired":{"summary":"A credential whose term has ended (fictitious holder)","value":{"verified":false,"status":"expired","queried_credential_id":"AL-00001U","queried_id_superseded":false,"holder":{"name":"Example Bakery LLC (fictitious)","name_on_file":true},"credential":{"credential_id":"AL-00001U","name":"AI Aligned","slug":"ai-aligned","type":"business certification","status":"expired","status_meaning":"The credential’s term has ended and it has not been renewed. It was valid until the valid_through date.","issued_at":"2025-02-01T00:00:00Z","valid_through":"2026-02-01T00:00:00Z","standard_version":"1.0","definition_url":"https://www.withawg.com/api/public/v1/certifications/ai-aligned"},"verification_url":"https://www.withawg.com/verify/AL-00001U","badge_image_url":null,"issuer":{"name":"Aligned Workforce Group","url":"https://www.withawg.com/"},"canonical_url":"https://www.withawg.com/verify/AL-00001U"}},"superseded":{"summary":"An old certificate ID replaced by a tier change (fictitious holder)","value":{"verified":true,"status":"active","queried_credential_id":"AW-00001Q","queried_id_superseded":true,"superseded_note":"The queried certificate ID was replaced when the holder changed tier. The credential below is the current one for the same holder.","holder":{"name":"Example Bakery LLC (fictitious)","name_on_file":true},"credential":{"credential_id":"AL-00001U","name":"AI Aligned","slug":"ai-aligned","type":"business certification","status":"active","status_meaning":"The credential is current and in good standing.","issued_at":"2026-02-01T00:00:00Z","valid_through":"2027-02-01T00:00:00Z","standard_version":"1.0","definition_url":"https://www.withawg.com/api/public/v1/certifications/ai-aligned"},"verification_url":"https://www.withawg.com/verify/AL-00001U","badge_image_url":"https://www.withawg.com/api/credentials/AL-00001U/badge","issuer":{"name":"Aligned Workforce Group","url":"https://www.withawg.com/"},"canonical_url":"https://www.withawg.com/verify/AL-00001U"}}}}}},"400":{"description":"The ID is not well formed (status \"invalid_id\").","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Verification"}}}},"404":{"description":"No record matches (status \"not_found\").","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Verification"}}}},"503":{"description":"Verification temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/verify":{"get":{"summary":"Verify a business by exact name","description":"Credentials currently in force for a business whose name matches exactly (case-insensitive). Deliberately not a partial or fuzzy search. An empty result does not establish that an organization never held a credential. Partner firms can only be verified by certificate ID.","tags":["Verification"],"parameters":[{"name":"name","in":"query","required":true,"description":"Exact business name, 3 to 200 characters.","schema":{"type":"string","minLength":3,"maxLength":200}}],"responses":{"200":{"description":"Match result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameVerification"}}}},"400":{"description":"Missing or invalid name.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Verification temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/partners":{"get":{"summary":"AWG Partner Network","description":"Partner tiers and how to verify a partner firm. No directory of firms is published yet.","tags":["Partner network"],"responses":{"200":{"description":"Partner network description.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerNetwork"}}}}}}},"/assessments":{"get":{"summary":"Assessment descriptions","description":"Describes the three AWG assessments. Never returns any individual responses or scores.","tags":["Assessments"],"responses":{"200":{"description":"Assessment descriptions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Assessments"}}}}}}},"/risk-map/metadata":{"get":{"summary":"Risk map metadata","description":"What the workforce risk map measures, its sources, versions and limitations, and what is observed versus derived versus projected.","tags":["Risk map"],"responses":{"200":{"description":"Metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskMapMetadata"}}}}}}},"/risk-map/counties/{fips}":{"get":{"summary":"Risk map values for a county","description":"Observed snapshot for one US county. Projections are not served.","tags":["Risk map"],"parameters":[{"name":"fips","in":"path","required":true,"description":"5-digit county FIPS code.","schema":{"type":"string"},"example":"17043"}],"responses":{"200":{"description":"County values.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskCounty"}}}},"400":{"description":"Malformed FIPS code.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No data for this county.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/risk-map/states/{code}":{"get":{"summary":"Risk map values for a state","description":"Observed snapshot for one state, employment-weighted across its counties.","tags":["Risk map"],"parameters":[{"name":"code","in":"path","required":true,"description":"2-letter postal code.","schema":{"type":"string"},"example":"IL"}],"responses":{"200":{"description":"State values.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RiskState"}}}},"404":{"description":"No data for this code.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Issuer":{"type":"object","description":"Provenance: the organization asserting this data. Always Aligned Workforce Group.","properties":{"name":{"type":"string","description":"Issuing organization."},"url":{"type":"string","description":"Issuer website.","format":"uri"}},"required":["name","url"]},"Error":{"type":"object","description":"Error envelope. Additional keys may list valid values.","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Stable machine-readable error code."},"message":{"type":"string","description":"Human-readable explanation."}},"required":["code","message"]}},"required":["error"]},"Organization":{"type":"object","properties":{"name":{"type":"string","description":"Organization name."},"legal_name":{"type":"string","description":"Registered legal name."},"short_name":{"type":"string","description":"Common abbreviation."},"organization_type":{"type":"string","description":"Legal form."},"website":{"type":"string","description":"Official website.","format":"uri"},"description":{"type":"string","description":"Official one-paragraph description of AWG."},"what_awg_does":{"type":"array","items":{"type":"string","description":"Activity."},"description":"What AWG does."},"what_awg_does_not_do":{"type":"array","items":{"type":"string","description":"Clarification."},"description":"Common misreadings to avoid."},"founder":{"type":"object","properties":{"name":{"type":"string","description":"Name."},"title":{"type":"string","description":"Title."}},"required":["name","title"]},"contact":{"type":"object","properties":{"general":{"type":"string","description":"Email."},"privacy":{"type":"string","description":"Email."},"legal":{"type":"string","description":"Email."}},"required":["general","privacy","legal"]},"urls":{"type":"object","description":"Canonical human-readable pages.","additionalProperties":{"type":"string","format":"uri"}},"api":{"type":"object","properties":{"version":{"type":"string","description":"API version."},"base_url":{"type":"string","description":"Base URL.","format":"uri"},"documentation":{"type":"string","description":"Human documentation.","format":"uri"},"openapi":{"type":"string","description":"This specification.","format":"uri"},"endpoints":{"type":"object","description":"Endpoint URL templates.","additionalProperties":{"type":"string"}}},"required":["version","base_url","documentation","openapi","endpoints"]},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["name","legal_name","short_name","organization_type","website","description","what_awg_does","what_awg_does_not_do","founder","contact","urls","api","issuer","canonical_url"]},"Principle":{"type":"object","properties":{"number":{"type":"number","description":"Order within its list."},"title":{"type":"string","description":"Principle name."},"statement":{"type":"string","description":"Principle text."}},"required":["number","title","statement"]},"Standard":{"type":"object","properties":{"name":{"type":"string","description":"Name of the standard."},"version":{"type":"string","description":"Version identifier, e.g. \"1.0\"."},"status":{"type":"string","description":"Whether this version is in force.","enum":["current","superseded","draft"]},"effective_date":{"type":["string","null"],"description":"Date the version takes effect (YYYY-MM-DD). Null if not yet announced.","format":"date"},"publication_date":{"type":["string","null"],"description":"Date first published (YYYY-MM-DD).","format":"date"},"supersedes_version":{"type":["string","null"],"description":"The version this one replaced."},"superseded_by_version":{"type":["string","null"],"description":"The version that replaced this one, if any."},"purpose":{"type":"string","description":"The purpose statement of the standard."},"principles":{"type":"object","properties":{"for_businesses":{"type":"array","items":{"$ref":"#/components/schemas/Principle"},"description":"Principles certified businesses commit to."},"for_partners":{"type":"array","items":{"$ref":"#/components/schemas/Principle"},"description":"Principles vetted partner firms commit to."}},"required":["for_businesses","for_partners"]},"certification_relationship":{"type":"string","description":"How credentials relate to the standard."},"certifications_url":{"type":"string","description":"Credential definitions.","format":"uri"},"all_versions":{"type":"array","items":{"type":"object","properties":{"version":{"type":"string","description":"Version."},"status":{"type":"string","description":"Status."},"url":{"type":"string","description":"API URL.","format":"uri"}},"required":["version","status","url"]},"description":"Every published version."},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["name","version","status","effective_date","publication_date","supersedes_version","superseded_by_version","purpose","principles","certification_relationship","certifications_url","all_versions","issuer","canonical_url"]},"Requirement":{"type":"object","properties":{"id":{"type":"string","description":"Stable requirement identifier."},"requirement":{"type":"string","description":"What must be done."},"detail":{"type":"string","description":"Explanation."},"phase":{"type":["string","null"],"description":"Certification phase, where the path is phased."},"how_completion_is_established":{"type":"string","description":"Kind of evidence AWG relies on."},"recurrence":{"type":"string","description":"Whether it recurs at renewal.","enum":["once","annual"]},"target_window":{"type":["string","null"],"description":"Published target timeframe."}},"required":["id","requirement","detail","phase","how_completion_is_established","recurrence","target_window"]},"Certification":{"type":"object","properties":{"slug":{"type":"string","description":"Stable identifier.","enum":["ai-aware","ai-aligned","ai-ambassador","certified-provider","strategic-partner"]},"name":{"type":"string","description":"Official credential name."},"audience":{"type":"string","description":"Who can hold it.","enum":["business","provider"]},"ladder_position":{"type":"number","description":"Position in its ladder; 1 is the entry level."},"builds_on":{"type":["string","null"],"description":"Credential that must be held first."},"status":{"type":"string","description":"Whether AWG currently offers it.","enum":["offered","retired"]},"who_it_is_for":{"type":"string","description":"Intended holder."},"description":{"type":"string","description":"What the credential signifies."},"requirements":{"type":"array","items":{"$ref":"#/components/schemas/Requirement"},"description":"Published requirements checklist. Empty for provider tiers, which apply and are vetted."},"commitments":{"type":"array","items":{"type":"string","description":"Commitment."},"description":"What the holder commits to."},"benefits":{"type":"array","items":{"type":"string","description":"Benefit."},"description":"What the holder receives."},"pricing":{"type":"object","properties":{"annual_price_usd":{"type":"number","description":"Published annual price in US dollars; 0 means free."},"engagement_fee_percent":{"type":["number","null"],"description":"Fee on AWG-sourced engagements; providers only."},"engagement_fee_applies_to":{"type":["string","null"],"description":"What the fee applies to."},"note":{"type":"string","description":"Scope of this pricing information."}},"required":["annual_price_usd","engagement_fee_percent","engagement_fee_applies_to","note"]},"renewal":{"type":"object","properties":{"term_months":{"type":"number","description":"Length of a credential term."},"renewal":{"type":"string","description":"Renewal cadence."}},"required":["term_months","renewal"]},"certificate_id_prefix":{"type":"string","description":"Prefix of certificate IDs for this credential.","enum":["AW","AL","AM","CP","SP"]},"standard_version":{"type":"string","description":"Standard version new credentials are issued against."},"url":{"type":"string","description":"API URL of this definition.","format":"uri"},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["slug","name","audience","ladder_position","builds_on","status","who_it_is_for","description","requirements","commitments","benefits","pricing","renewal","certificate_id_prefix","standard_version","url","issuer","canonical_url"]},"CertificationList":{"type":"object","properties":{"business_certifications":{"type":"array","items":{"$ref":"#/components/schemas/Certification"},"description":"AI Aware, AI Aligned, AI Ambassador, in ladder order."},"provider_certifications":{"type":"array","items":{"$ref":"#/components/schemas/Certification"},"description":"Certified Provider, Strategic Partner."},"naming":{"type":"string","description":"Note on official and retired names."},"verification":{"type":"string","description":"How a credential must be verified."},"verify_url":{"type":"string","description":"Verification URL template."},"standard_version":{"type":"string","description":"Current standard version."},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["business_certifications","provider_certifications","naming","verification","verify_url","standard_version","issuer","canonical_url"]},"Credential":{"type":"object","properties":{"credential_id":{"type":"string","description":"Public certificate ID, e.g. AW-46842T."},"name":{"type":"string","description":"Credential name."},"slug":{"type":["string","null"],"description":"Credential slug."},"type":{"type":"string","description":"Kind of credential.","enum":["business certification","partner network credential"]},"status":{"type":"string","description":"Current standing.","enum":["active","expired","suspended","revoked","inactive","superseded"]},"status_meaning":{"type":"string","description":"Plain-language meaning of the status."},"issued_at":{"type":["string","null"],"description":"When the credential was issued.","format":"date-time"},"valid_through":{"type":["string","null"],"description":"End of the current term. Null if open-ended.","format":"date-time"},"standard_version":{"type":["string","null"],"description":"AWG Standard version the credential was issued against. Null if not recorded."},"definition_url":{"type":["string","null"],"description":"API URL of the credential definition.","format":"uri"}},"required":["credential_id","name","slug","type","status","status_meaning","issued_at","valid_through","standard_version","definition_url"]},"Verification":{"type":"object","description":"Verification answer. When no record matches, only verified, status, status_meaning, queried_credential_id, issuer and canonical_url are present.","properties":{"verified":{"type":"boolean","description":"True only when the credential is in force right now (status \"active\")."},"status":{"type":"string","description":"Standing of the credential, or \"not_found\" / \"invalid_id\".","enum":["active","expired","suspended","revoked","inactive","superseded","not_found","invalid_id"]},"status_meaning":{"type":"string","description":"Present when no record is returned."},"queried_credential_id":{"type":"string","description":"The ID that was asked about."},"queried_id_superseded":{"type":"boolean","description":"True when the queried ID was replaced by a tier change; \"credential\" is its successor."},"superseded_note":{"type":"string","description":"Explanation, present only when queried_id_superseded is true."},"holder":{"type":"object","description":"The organization holding the credential.","properties":{"name":{"type":["string","null"],"description":"Name of the certified organization. Null when AWG has no name on file for this certificate."},"name_on_file":{"type":"boolean","description":"False when the holder name is missing; the record then does not establish who holds the credential."},"note":{"type":"string","description":"Explanation, present only when name_on_file is false."}},"required":["name","name_on_file"]},"credential":{"$ref":"#/components/schemas/Credential"},"verification_url":{"type":"string","description":"Citable human-readable record.","format":"uri"},"badge_image_url":{"type":["string","null"],"description":"Badge image; null unless the credential is active.","format":"uri"},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["verified","status","queried_credential_id","issuer","canonical_url"]},"NameVerification":{"type":"object","properties":{"query":{"type":"object","properties":{"name":{"type":"string","description":"Name searched."},"match":{"type":"string","description":"Matching rule applied."}},"required":["name","match"]},"verified":{"type":"boolean","description":"True when at least one credential in force matches the exact name."},"results":{"type":"array","items":{"type":"object","properties":{"holder":{"type":"object","properties":{"name":{"type":"string","description":"Organization name."},"name_on_file":{"type":"boolean","description":"Always true for name matches."}},"required":["name","name_on_file"]},"credential":{"$ref":"#/components/schemas/Credential"},"verification_url":{"type":"string","description":"Record page.","format":"uri"}},"required":["holder","credential","verification_url"]},"description":"Credentials currently in force for the exact name."},"name_guidance":{"type":"string","description":"Which form of the name to search for."},"note":{"type":"string","description":"How to interpret an empty result."},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["query","verified","results","name_guidance","note","issuer","canonical_url"]},"PartnerNetwork":{"type":"object","properties":{"name":{"type":"string","description":"Program name."},"description":{"type":"string","description":"What the network is."},"engagement_eligibility":{"type":"string","description":"How engagement opportunities are classified between tiers."},"tiers":{"type":"array","items":{"$ref":"#/components/schemas/Certification"},"description":"The two provider credentials."},"how_to_verify_a_partner":{"type":"string","description":"Verification instructions."},"verify_url":{"type":"string","description":"Verification URL template."},"directory":{"type":"object","properties":{"available":{"type":"boolean","description":"Whether a public directory of firms exists."},"note":{"type":"string","description":"Explanation."}},"required":["available","note"]},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["name","description","engagement_eligibility","tiers","how_to_verify_a_partner","verify_url","directory","issuer","canonical_url"]},"Assessments":{"type":"object","properties":{"scoring_version":{"type":"string","description":"Version of the scoring rules."},"assessments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identifier."},"name":{"type":"string","description":"Name."},"focus":{"type":"string","description":"Short focus statement."},"purpose":{"type":"string","description":"What it is for."},"measures":{"type":"array","items":{"type":"string","description":"Dimension."},"description":"What it measures."},"score_direction":{"type":"string","description":"How to read the headline score.","enum":["lower is better","higher is better"]},"format":{"type":"string","description":"Question format."},"approximate_duration":{"type":"string","description":"Typical time to complete."},"cost":{"type":"string","description":"Price."},"sequence":{"type":"number","description":"Recommended order."},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["id","name","focus","purpose","measures","score_direction","format","approximate_duration","cost","sequence","canonical_url"]},"description":"The three assessments."},"privacy":{"type":"string","description":"Statement that individual results are never public."},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["scoring_version","assessments","privacy","issuer","canonical_url"]},"RiskMapMetadata":{"type":"object","properties":{"name":{"type":"string","description":"Dataset name."},"what_it_measures":{"type":"string","description":"Definition of the measure, including what it is not."},"unit":{"type":"string","description":"Unit of the main value."},"model_version":{"type":["number","null"],"description":"Risk model version. Changes when the method changes."},"data_file_version":{"type":"string","description":"Format version of the published data file."},"data_generated_at":{"type":"string","description":"When the published data was last built.","format":"date-time"},"geography":{"type":"object","description":"Coverage and granularity.","additionalProperties":true},"industry_dimension":{"type":"string","description":"Industry breakdown used."},"sources":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Source."},"role":{"type":"string","description":"How it is used."},"url":{"type":"string","description":"Source URL.","format":"uri"}},"required":["name","role","url"]},"description":"Underlying datasets."},"method":{"type":"string","description":"How values are computed."},"value_kinds":{"type":"object","properties":{"observed":{"type":"string","description":"What is observed."},"derived":{"type":"string","description":"What AWG derives."},"projected":{"type":"string","description":"What is projected, and that projections are not served."}},"required":["observed","derived","projected"]},"derived_fields":{"type":"object","description":"Definition of each AWG-derived field returned for a county.","additionalProperties":{"type":"string"}},"tiers":{"type":"object","properties":{"thresholds_pct":{"type":"object","properties":{"high":{"type":"number","description":"Lower bound of \"high\"."},"severe":{"type":"number","description":"Lower bound of \"severe\"."}},"required":["high","severe"]},"meaning":{"type":"string","description":"How tiers are defined."}},"required":["thresholds_pct","meaning"]},"national":{"type":"object","properties":{"kind":{"type":"string","description":"Value kind."},"pct_exposed":{"type":"number","description":"National exposure."},"automation_share":{"type":"number","description":"Automation vs augmentation lean, 0-1."}},"required":["kind","pct_exposed","automation_share"]},"industries":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Sector."},"pct_exposed":{"type":"number","description":"Sector exposure."},"automation_share":{"type":["number","null"],"description":"Automation lean, 0-1."}},"required":["name","pct_exposed","automation_share"]},"description":"National exposure by sector."},"limitations":{"type":"array","items":{"type":"string","description":"Limitation."},"description":"Known limitations. Read before citing a value."},"citation":{"type":"string","description":"How to cite."},"endpoints":{"type":"object","properties":{"county":{"type":"string","description":"County URL template."},"state":{"type":"string","description":"State URL template."}},"required":["county","state"]},"embed_url":{"type":"string","description":"Embeddable map.","format":"uri"},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["name","what_it_measures","unit","model_version","data_file_version","data_generated_at","geography","industry_dimension","sources","method","value_kinds","derived_fields","tiers","national","industries","limitations","citation","endpoints","embed_url","issuer","canonical_url"]},"RiskCounty":{"type":"object","properties":{"fips":{"type":"string","description":"5-digit county FIPS code."},"name":{"type":"string","description":"County name."},"state":{"type":"string","description":"State code."},"model_version":{"type":["number","null"],"description":"Risk model version. Changes when the method changes."},"data_file_version":{"type":"string","description":"Format version of the published data file."},"data_generated_at":{"type":"string","description":"When the published data was last built.","format":"date-time"},"value_kind":{"type":"string","description":"States that values are an observed snapshot."},"source_data":{"type":"object","properties":{"employment":{"type":"number","description":"County employment from the source."},"employment_source":{"type":"string","description":"Source of the employment figure."},"top_industries_by_employment":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Sector."},"employment":{"type":"number","description":"Employment."}},"required":["name","employment"]},"description":"Largest sectors."}},"required":["employment","employment_source","top_industries_by_employment"]},"awg_derived":{"type":"object","properties":{"pct_exposed":{"type":"number","description":"Percent of county employment exposed."},"tier":{"type":"string","description":"Tier relative to other counties.","enum":["moderate","high","severe"]},"tier_meaning":{"type":"string","description":"How tiers are defined."},"risk_index_0_100":{"type":"number","description":"pct_exposed rescaled for display."},"automation_share":{"type":"number","description":"Automation vs augmentation lean, 0-1."},"concentration_bonus":{"type":"number","description":"Amplifier applied for single-industry concentration, 0-0.3."},"dominant_industry":{"type":"string","description":"Sector contributing most."},"industry_pct_exposed":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Sector."},"pct_exposed":{"type":"number","description":"Sector exposure."}},"required":["name","pct_exposed"]},"description":"Exposure of the largest sectors."}},"required":["pct_exposed","tier","tier_meaning","risk_index_0_100","automation_share","concentration_bonus","dominant_industry","industry_pct_exposed"]},"comparison":{"type":"object","properties":{"national_pct_exposed":{"type":"number","description":"National exposure for comparison."}},"required":["national_pct_exposed"]},"interpretation":{"type":"string","description":"How to read the value."},"methodology_url":{"type":"string","description":"Metadata endpoint.","format":"uri"},"citation":{"type":"string","description":"How to cite."},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["fips","name","state","model_version","data_file_version","data_generated_at","value_kind","source_data","awg_derived","comparison","interpretation","methodology_url","citation","issuer","canonical_url"]},"RiskState":{"type":"object","properties":{"state":{"type":"string","description":"State code."},"model_version":{"type":["number","null"],"description":"Risk model version. Changes when the method changes."},"data_file_version":{"type":"string","description":"Format version of the published data file."},"data_generated_at":{"type":"string","description":"When the published data was last built.","format":"date-time"},"value_kind":{"type":"string","description":"States that values are an observed snapshot."},"source_data":{"type":"object","properties":{"employment":{"type":"number","description":"Employment."},"counties_included":{"type":"number","description":"Number of counties aggregated."}},"required":["employment","counties_included"]},"awg_derived":{"type":"object","properties":{"pct_exposed":{"type":"number","description":"Percent of state employment exposed."},"note":{"type":"string","description":"Aggregation note."}},"required":["pct_exposed","note"]},"comparison":{"type":"object","properties":{"national_pct_exposed":{"type":"number","description":"National exposure."}},"required":["national_pct_exposed"]},"interpretation":{"type":"string","description":"How to read the value."},"methodology_url":{"type":"string","description":"Metadata endpoint.","format":"uri"},"citation":{"type":"string","description":"How to cite."},"issuer":{"$ref":"#/components/schemas/Issuer"},"canonical_url":{"type":"string","description":"The human-readable page that is authoritative for this object.","format":"uri"}},"required":["state","model_version","data_file_version","data_generated_at","value_kind","source_data","awg_derived","comparison","interpretation","methodology_url","citation","issuer","canonical_url"]}}}}