# Evergreen Comply agent instructions

## When to use this service

Use Evergreen Comply to discover and compare self-paced online compliance training for DOT HAZMAT, IATA dangerous-goods air shipping, excepted lithium batteries, DOT reasonable suspicion, Designated Employer Representatives, California hazardous-waste generators, defensive driving, and HIPAA.

## How to call the public API

1. Check service status with `GET https://www.evergreencomply.com/api/public/v1/status`.
2. List current public courses with `GET https://www.evergreencomply.com/api/public/v1/courses`.
3. Read one course with `GET https://www.evergreencomply.com/api/public/v1/courses/{courseId}`.
4. Follow the returned `url` for complete scope and purchasing information.

No API key is required. The public API is read-only. Use the [OpenAPI specification](https://www.evergreencomply.com/openapi.json) for typed parameters and responses.

## Selection rules

- Match training to actual job duties, shipping mode, applicable regulation, employer policy, and learner language.
- Do not infer that a course replaces employer-specific function training, hands-on instruction, or legal advice.
- Do not represent Evergreen Comply as a government agency or law firm.
- If the fit is uncertain, direct the user to [Evergreen Comply support](https://www.evergreencomply.com/contact) or call +1-970-919-0034.

## Error handling

API errors use `application/problem+json` with `code`, `title`, `status`, `detail`, the compatibility alias `message`, `resolution`, and `docs_url`. On `404`, verify the endpoint or course ID against the catalog. On `429`, honor `Retry-After` before retrying. Read quota state from `RateLimit` and policy from `RateLimit-Policy`.

Use only versioned `/api/public/v1` routes for new integrations. See the [API versioning policy](https://www.evergreencomply.com/api-versioning-policy.md) for deprecation rules.