AI & automated access

Public API documentation

A read-only API for facts that AWG is the authority on: who AWG is, the AWG Standard, what each credential means, whether a credential is valid, what the assessments measure, and what the workforce risk map says. For an overview written for AI agents, see AI & automated access.

Base URL: https://www.withawg.com/api/public/v1
Authentication: None. No API key. Do not send credentials.
Methods: GET only. Nothing in this API can change data.
Format: JSON, UTF-8. CORS is open, so browser-based tools can call it.
Rate limits: Reasonable automated use is welcome. Honour the Cache-Control headers; abusive traffic may be rate limited (HTTP 429).
Freshness: Definitions are cached for up to an hour and risk data for a day. Verification answers are cached for about a minute, so a revoked credential stops verifying almost immediately.
Provenance: Every object includes issuer (always Aligned Workforce Group) and canonical_url, the human-readable page for the same information.
Specification: OpenAPI 3.1 (JSON)

Credential status

verified is true only when status is active. A credential whose term has ended is reported as expired even if nobody has updated its record. A 503 response means verification is unavailable and says nothing about the credential.

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.
invalid_id: The value is not a well-formed AWG certificate ID. HTTP 400.

Example verification responses

These are produced by the API's own serializer from fictitious records, so the shape is exact. The holder and certificate IDs shown do not exist.

A credential in force (fictitious holder)

{
  "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"
}

A credential whose term has ended (fictitious holder)

{
  "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"
}

An old certificate ID replaced by a tier change (fictitious holder)

{
  "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"
}

No record matches (HTTP 404)

{
  "verified": false,
  "status": "not_found",
  "status_meaning": "No AWG credential matches this identifier. This says nothing about whether the organization ever held a credential under a different identifier.",
  "queried_credential_id": "AL-00002B",
  "issuer": {
    "name": "Aligned Workforce Group",
    "url": "https://www.withawg.com/"
  },
  "canonical_url": "https://www.withawg.com/verify"
}

Versioning

The API path carries its version (v1); fields may be added within a version but are not removed or repurposed. The AWG Standard has its own version, and each credential reports the standard_version it was issued against, retrievable at /standard/{version}. Risk map responses carry model_version and data_generated_at; cite both.

What is not available

Individual assessment responses, scores and reports; accounts and contact details; applications and review notes; partner leads and commercial terms; and any administrative function. There is no directory of certified businesses or partner firms. An AI agent is treated exactly like an anonymous visitor.

Organization

GET /awg

The canonical machine-readable description of Aligned Workforce Group, and an index of this API.

Example request

curl https://www.withawg.com/api/public/v1/awg

Responses: 200 Organization description.

Returns Organization

Standard

GET /standard

The version of the AWG Standard currently in force.

Example request

curl https://www.withawg.com/api/public/v1/standard

Responses: 200 Current version.

Returns Standard

GET /standard/{version}

Any published version, current or superseded. Use the standard_version on a credential to retrieve the text it was issued against.

version (path): Version identifier.

Example request

curl https://www.withawg.com/api/public/v1/standard/1.0

Responses: 200 The requested version. · 404 No such version.

Returns Standard

Certifications

GET /certifications

Definitions of all five AWG credentials: requirements, commitments, benefits, pricing and renewal.

Example request

curl https://www.withawg.com/api/public/v1/certifications

Responses: 200 All credential definitions.

Returns CertificationList

GET /certifications/{slug}

Definition of a single credential.

slug (path): One of: ai-aware, ai-aligned, ai-ambassador, certified-provider, strategic-partner.

Example request

curl https://www.withawg.com/api/public/v1/certifications/ai-aligned

Responses: 200 The credential definition. · 404 Unknown slug.

Returns Certification

Verification

GET /verify/{credential_id}

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.

credential_id (path): Certificate ID: prefix AW, AL, AM, CP or SP, five digits, one check letter.

Example request

curl https://www.withawg.com/api/public/v1/verify/AW-46842T

Responses: 200 A matching record, in force or not. Check "verified" and "status". · 400 The ID is not well formed (status "invalid_id"). · 404 No record matches (status "not_found"). · 503 Verification temporarily unavailable.

Returns Verification

GET /verify

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.

name (query): Exact business name, 3 to 200 characters.

Example request

curl https://www.withawg.com/api/public/v1/verify?name=Example%20Bakery%20LLC

Responses: 200 Match result. · 400 Missing or invalid name. · 503 Verification temporarily unavailable.

Returns NameVerification

Partner network

GET /partners

Partner tiers and how to verify a partner firm. No directory of firms is published yet.

Example request

curl https://www.withawg.com/api/public/v1/partners

Responses: 200 Partner network description.

Returns PartnerNetwork

Assessments

GET /assessments

Describes the three AWG assessments. Never returns any individual responses or scores.

Example request

curl https://www.withawg.com/api/public/v1/assessments

Responses: 200 Assessment descriptions.

Returns Assessments

Risk map

GET /risk-map/metadata

What the workforce risk map measures, its sources, versions and limitations, and what is observed versus derived versus projected.

Example request

curl https://www.withawg.com/api/public/v1/risk-map/metadata

Responses: 200 Metadata.

Returns RiskMapMetadata

GET /risk-map/counties/{fips}

Observed snapshot for one US county. Projections are not served.

fips (path): 5-digit county FIPS code.

Example request

curl https://www.withawg.com/api/public/v1/risk-map/counties/17043

Responses: 200 County values. · 400 Malformed FIPS code. · 404 No data for this county.

Returns RiskCounty

GET /risk-map/states/{code}

Observed snapshot for one state, employment-weighted across its counties.

code (path): 2-letter postal code.

Example request

curl https://www.withawg.com/api/public/v1/risk-map/states/IL

Responses: 200 State values. · 404 No data for this code.

Returns RiskState

Response objects

Issuer

Provenance: the organization asserting this data. Always Aligned Workforce Group.

Field	Type	Meaning
name	string	Issuing organization.
url	string	Issuer website.

Error

Error envelope. Additional keys may list valid values.

Field	Type	Meaning
error	object

Organization

Field	Type	Meaning
name	string	Organization name.
legal_name	string	Registered legal name.
short_name	string	Common abbreviation.
organization_type	string	Legal form.
website	string	Official website.
description	string	Official one-paragraph description of AWG.
what_awg_does	array of string	What AWG does.
what_awg_does_not_do	array of string	Common misreadings to avoid.
founder	object
contact	object
urls	object	Canonical human-readable pages.
api	object
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

Principle

Field	Type	Meaning
number	number	Order within its list.
title	string	Principle name.
statement	string	Principle text.

Standard

Field	Type	Meaning
name	string	Name of the standard.
version	string	Version identifier, e.g. "1.0".
status	string (current \| superseded \| draft)	Whether this version is in force.
effective_date	string or null	Date the version takes effect (YYYY-MM-DD). Null if not yet announced.
publication_date	string or null	Date first published (YYYY-MM-DD).
supersedes_version	string or null	The version this one replaced.
superseded_by_version	string or null	The version that replaced this one, if any.
purpose	string	The purpose statement of the standard.
principles	object
certification_relationship	string	How credentials relate to the standard.
certifications_url	string	Credential definitions.
all_versions	array of object	Every published version.
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

Requirement

Field	Type	Meaning
id	string	Stable requirement identifier.
requirement	string	What must be done.
detail	string	Explanation.
phase	string or null	Certification phase, where the path is phased.
how_completion_is_established	string	Kind of evidence AWG relies on.
recurrence	string (once \| annual)	Whether it recurs at renewal.
target_window	string or null	Published target timeframe.

Certification

Field	Type	Meaning
slug	string (ai-aware \| ai-aligned \| ai-ambassador \| certified-provider \| strategic-partner)	Stable identifier.
name	string	Official credential name.
audience	string (business \| provider)	Who can hold it.
ladder_position	number	Position in its ladder; 1 is the entry level.
builds_on	string or null	Credential that must be held first.
status	string (offered \| retired)	Whether AWG currently offers it.
who_it_is_for	string	Intended holder.
description	string	What the credential signifies.
requirements	array of Requirement	Published requirements checklist. Empty for provider tiers, which apply and are vetted.
commitments	array of string	What the holder commits to.
benefits	array of string	What the holder receives.
pricing	object
renewal	object
certificate_id_prefix	string (AW \| AL \| AM \| CP \| SP)	Prefix of certificate IDs for this credential.
standard_version	string	Standard version new credentials are issued against.
url	string	API URL of this definition.
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

CertificationList

Field	Type	Meaning
business_certifications	array of Certification	AI Aware, AI Aligned, AI Ambassador, in ladder order.
provider_certifications	array of Certification	Certified Provider, Strategic Partner.
naming	string	Note on official and retired names.
verification	string	How a credential must be verified.
verify_url	string	Verification URL template.
standard_version	string	Current standard version.
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

Credential

Field	Type	Meaning
credential_id	string	Public certificate ID, e.g. AW-46842T.
name	string	Credential name.
slug	string or null	Credential slug.
type	string (business certification \| partner network credential)	Kind of credential.
status	string (active \| expired \| suspended \| revoked \| inactive \| superseded)	Current standing.
status_meaning	string	Plain-language meaning of the status.
issued_at	string or null	When the credential was issued.
valid_through	string or null	End of the current term. Null if open-ended.
standard_version	string or null	AWG Standard version the credential was issued against. Null if not recorded.
definition_url	string or null	API URL of the credential definition.

Verification

Verification answer. When no record matches, only verified, status, status_meaning, queried_credential_id, issuer and canonical_url are present.

Field	Type	Meaning
verified	boolean	True only when the credential is in force right now (status "active").
status	string (active \| expired \| suspended \| revoked \| inactive \| superseded \| not_found \| invalid_id)	Standing of the credential, or "not_found" / "invalid_id".
status_meaningoptional	string	Present when no record is returned.
queried_credential_id	string	The ID that was asked about.
queried_id_supersededoptional	boolean	True when the queried ID was replaced by a tier change; "credential" is its successor.
superseded_noteoptional	string	Explanation, present only when queried_id_superseded is true.
holderoptional	object	The organization holding the credential.
credentialoptional	Credential	See Credential.
verification_urloptional	string	Citable human-readable record.
badge_image_urloptional	string or null	Badge image; null unless the credential is active.
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

NameVerification

Field	Type	Meaning
query	object
verified	boolean	True when at least one credential in force matches the exact name.
results	array of object	Credentials currently in force for the exact name.
name_guidance	string	Which form of the name to search for.
note	string	How to interpret an empty result.
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

PartnerNetwork

Field	Type	Meaning
name	string	Program name.
description	string	What the network is.
engagement_eligibility	string	How engagement opportunities are classified between tiers.
tiers	array of Certification	The two provider credentials.
how_to_verify_a_partner	string	Verification instructions.
verify_url	string	Verification URL template.
directory	object
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

Assessments

Field	Type	Meaning
scoring_version	string	Version of the scoring rules.
assessments	array of object	The three assessments.
privacy	string	Statement that individual results are never public.
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

RiskMapMetadata

Field	Type	Meaning
name	string	Dataset name.
what_it_measures	string	Definition of the measure, including what it is not.
unit	string	Unit of the main value.
model_version	number or null	Risk model version. Changes when the method changes.
data_file_version	string	Format version of the published data file.
data_generated_at	string	When the published data was last built.
geography	object	Coverage and granularity.
industry_dimension	string	Industry breakdown used.
sources	array of object	Underlying datasets.
method	string	How values are computed.
value_kinds	object
derived_fields	object	Definition of each AWG-derived field returned for a county.
tiers	object
national	object
industries	array of object	National exposure by sector.
limitations	array of string	Known limitations. Read before citing a value.
citation	string	How to cite.
endpoints	object
embed_url	string	Embeddable map.
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

RiskCounty

Field	Type	Meaning
fips	string	5-digit county FIPS code.
name	string	County name.
state	string	State code.
model_version	number or null	Risk model version. Changes when the method changes.
data_file_version	string	Format version of the published data file.
data_generated_at	string	When the published data was last built.
value_kind	string	States that values are an observed snapshot.
source_data	object
awg_derived	object
comparison	object
interpretation	string	How to read the value.
methodology_url	string	Metadata endpoint.
citation	string	How to cite.
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.

RiskState

Field	Type	Meaning
state	string	State code.
model_version	number or null	Risk model version. Changes when the method changes.
data_file_version	string	Format version of the published data file.
data_generated_at	string	When the published data was last built.
value_kind	string	States that values are an observed snapshot.
source_data	object
awg_derived	object
comparison	object
interpretation	string	How to read the value.
methodology_url	string	Metadata endpoint.
citation	string	How to cite.
issuer	Issuer	See Issuer.
canonical_url	string	The human-readable page that is authoritative for this object.