# Check Stubs Online public guide access

The public blog provides educational articles about payroll, income records, employment documents and tax forms. This service reads the same currently published library as the website. Drafts and future publication dates are excluded. It does not expose customer records or provide write operations.

## Read a guide as Markdown

Send `Accept: text/markdown` to a canonical article URL, or append `.md` to its path. The homepage alternate is `/index.md`; topic and editorial-policy pages also support `.md`. Ordinary browser requests continue to receive HTML. The response varies on `Accept`, identifies the HTML canonical URL and is marked `noindex` as an alternate representation. Source links, dates, table contents, figure alternatives/captions and qualifications remain with the guide.

## Public JSON API

Base: https://blog.checkstubsonline.com/api/v1

- `GET /articles`: list articles in publication order, or search with `q`.
- `GET /articles/{slug}`: article metadata and complete Markdown.
- `GET /topics`: four topic directories and their current counts. Membership can overlap.
- `GET /health`: availability and the public article count.

`/articles` parameters:

| Parameter | Accepted values | Default |
| --- | --- | --- |
| `q` | UTF-8 public topic query, at most 120 characters | no search |
| `topic` | exact slug returned by `/topics` | all topics |
| `page` | integer 1–100000; must exist in the result set | 1 |
| `limit` | integer 1–50 | 20 |

Search uses all-term keyword matching across the title, description and article body, with additional weight for title matches. It is not semantic search or a personal tax calculation. Result objects include canonical `url`, `markdownUrl`, publication date, genuinely observed modification date when available, author and category. `next` is the next result URL or `null`.

Example: https://blog.checkstubsonline.com/api/v1/articles?q=pay%20period&limit=6

## HTTP behavior

Public reading requires no registration, API key, cookies or OAuth token. Use GET or HEAD. OPTIONS is available for public cross-origin reads; credentials are not required or enabled. Content is briefly cacheable, has an ETag and honors a matching `If-None-Match`. Catalogs and alternate formats have their appropriate media types. Invalid parameters return 400; unknown or non-public articles and unavailable pages return 404; unsupported methods return 405. Errors use `{"error":{"code":"...","message":"..."}}`; a database outage returns 503 without exposing connection details. No request changes article records.

Use public topic words. Do not put private identifiers, account information or sensitive payroll details into search queries. Retain dates, year/jurisdiction limitations, fictional-example assumptions and primary-source citations when using a guide. Document preparation does not independently verify income, submit a filing or guarantee acceptance.

## Discovery

- [OpenAPI](https://blog.checkstubsonline.com/openapi.json)
- [API catalog](https://blog.checkstubsonline.com/.well-known/api-catalog)
- [ARD manifest](https://blog.checkstubsonline.com/.well-known/ard.json)
- [Compatible earlier AI catalog path](https://blog.checkstubsonline.com/.well-known/ai-catalog.json)
- [Guide-reading skill index](https://blog.checkstubsonline.com/.well-known/agent-skills/index.json)
- [Current guide index](https://blog.checkstubsonline.com/llms.txt)
- [Editorial policy](https://blog.checkstubsonline.com/editorial-policy)

The browser exposes read-only search, article-reading and topic tools when WebMCP is supported. It does not add sign-in, publishing, commerce or other privileged actions. An MCP server and an A2A conversational agent are not advertised because this blog does not operate those services.
