AI Certificates Content API

openapi: 3.2.0
info:
  title: AI Certificates public Content API
  version: 1.0.0
  summary: Practice-exam readiness data and guide sources for the Claude certifications.
  description: 'AI Certificates publishes original practice questions and study guides for the four

    Anthropic Claude certifications (CCAR-P, CCAR-F, CCDV-F, CCAO-F).


    This API is read-mostly and unauthenticated. Use it to read published cohort

    statistics for the readiness check, and to fetch any study guide as markdown

    instead of scraping the HTML.


    Exams:

    - `ccar-p` — Claude Certified Architect — Professional (CCAR-P), 63 items, fee $175 USD

    - `ccdv-f` — Claude Certified Developer — Foundations (CCDV-F), 53 items, fee $125 USD

    - `ccao-f` — Claude Certified Associate — Foundations (CCAO-F), 60 items, fee $99 USD

    - `ccar-f` — Claude Certified Architect — Foundations (CCAR-F), 60 items, fee $125 USD


    The readiness quiz is 12 questions; 8 answered is the minimum for a percentile.


    Every page also negotiates content: send `Accept: text/markdown` to a guide URL

    and you get the markdown source. Responses carry `Vary: Accept`.'
  contact:
    name: Matthew Hartman
    url: https://aicertificates.study/contact
  license:
    name: All rights reserved
    url: https://aicertificates.study/privacy
servers:
- url: https://aicertificates.study
  description: Production
tags:
- name: Content
  description: Study guides and exam reference material
paths:
  /md/{slug}:
    get:
      tags:
      - Content
      operationId: getGuideMarkdown
      summary: Fetch a study guide as markdown
      description: 'The markdown source of a guide, front matter resolved into a readable header. Equivalent to requesting the guide''s own URL with `Accept: text/markdown`. Every guide slug is listed in /llms.txt.'
      parameters:
      - name: slug
        in: path
        required: true
        description: Guide slug, without a leading slash. See /llms.txt.
        schema:
          type: string
          examples:
          - ccar-p-exam-facts
          - exam-dumps
      responses:
        '200':
          description: The guide, as markdown.
          content:
            text/markdown:
              schema:
                type: string
        '404':
          $ref: '#/components/responses/Error'
components:
  responses:
    Error:
      description: A structured error. `retryable` says whether backing off will help.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
      - error
      - code
      - message
      - hint
      - retryable
      properties:
        error:
          type: string
          description: Legacy string code. Prefer `code`.
        code:
          type: string
          enum:
          - not_configured
          - bad_request
          - bad_json
          - unknown_exam
          - rate_limited
          - unavailable
          - send_failed
          - not_found
          - not_signed_in
          - session_stale
          - already_entitled
          - payments_unavailable
          - single_unavailable
          - seats_unavailable
          - bad_quantity
          - checkout_failed
        message:
          type: string
          description: Human-readable description of what went wrong.
        hint:
          type: string
          description: What to do about it.
        retryable:
          type: boolean
          description: Whether retrying with backoff can succeed.
externalDocs:
  description: Developer and agent reference
  url: https://aicertificates.study/developers