Astacity for Developers

Build on the catalog.
Trust the certificates.

A read-only REST API for businesses: verify certificates programmatically and embed live courses and career paths in your product. Keyed access, honest data — the same numbers the site shows.

Apply for accessRead the docs

Verify certificates

HR platforms and background-check tools confirm a candidate's Astacity certificate from its serial — the same permanent record the public verification page shows.

Embed the catalog

List live courses — titles, prices, ratings, certification mapping — inside your portal or marketplace, always in sync with what learners see here.

Map career paths

Pull structured career paths with their step sequence and certifications to power curriculum planning and workforce-development tools.

API reference

Version 1. Read-only, JSON over HTTPS, stable paths — breaking changes would ship as /v2.

Authentication

Every request needs your API key as a bearer token. Keys are issued when your application is approved, arrive by email, and are stored on our side only as a hash — treat yours like a password.

curl https://astacity.com/api/v1/courses \
  -H "Authorization: Bearer ask_your_key_here"

Base URL & limits

  • Base URL: https://astacity.com/api/v1
  • Rate limit: 60 requests per minute per key — exceeding it returns 429 RATE_LIMITED.
  • All endpoints are read-only GET; CORS is enabled, so browser calls work.

Endpoints

GET/v1/certificates/{serial}

Verify a certificate by its serial (printed on every certificate and its public page). Returns the holder, what was completed, and the issue date — or 404 if the serial doesn't exist.

curl https://astacity.com/api/v1/certificates/AST-C-2026-000042 \
  -H "Authorization: Bearer ask_…"
Example response
{
  "serial": "AST-C-2026-000042",
  "kind": "COURSE",
  "learnerName": "Priya Sharma",
  "course": {
    "title": "CompTIA Security+ (SY0-701) Complete Prep",
    "slug": "comptia-security-plus-sy0-701",
    "instructor": "Ada Instructor"
  },
  "path": null,
  "issuedAt": "2026-05-14T09:30:00.000Z",
  "verifyUrl": "https://astacity.com/cert/AST-C-2026-000042"
}
GET/v1/courses

The published catalog, most-enrolled first. Ratings appear only when a course has real reviews.

category
filter by category slug (e.g. cloud-computing)
limit
page size, 1–100 (default 20)
offset
pagination offset (default 0)
curl "https://astacity.com/api/v1/courses?category=cybersecurity&limit=2" \
  -H "Authorization: Bearer ask_…"
Example response
{
  "total": 2,
  "limit": 2,
  "offset": 0,
  "items": [
    {
      "slug": "comptia-security-plus-sy0-701",
      "title": "CompTIA Security+ (SY0-701) Complete Prep",
      "subtitle": "…",
      "level": "BEGINNER",
      "priceMinor": 4900,
      "currency": "EUR",
      "rating": { "average": 4.7, "count": 12 },
      "estimatedHours": 40,
      "category": { "name": "Cybersecurity", "slug": "cybersecurity" },
      "instructor": "Ada Instructor",
      "certification": {
        "vendor": "CompTIA",
        "examCode": "SY0-701",
        "examName": "CompTIA Security+"
      },
      "url": "https://astacity.com/course/comptia-security-plus-sy0-701"
    }
  ]
}
GET/v1/courses/{slug}

One course in full: description, curriculum outline (section titles and lesson counts — never the content itself), certification mapping, and the last objective-verification date.

curl https://astacity.com/api/v1/courses/comptia-security-plus-sy0-701 \
  -H "Authorization: Bearer ask_…"
Example response
{
  "slug": "comptia-security-plus-sy0-701",
  "title": "CompTIA Security+ (SY0-701) Complete Prep",
  "description": "…",
  "level": "BEGINNER",
  "priceMinor": 4900,
  "currency": "EUR",
  "rating": { "average": 4.7, "count": 12 },
  "enrollmentCount": 341,
  "prerequisites": "…",
  "lastVerifiedAt": "2026-06-01T00:00:00.000Z",
  "certification": {
    "vendor": "CompTIA",
    "examCode": "SY0-701",
    "examName": "CompTIA Security+",
    "version": "SY0-701",
    "objectivesUrl": "https://…"
  },
  "curriculum": [
    { "position": 1, "title": "General Security Concepts", "lessonCount": 8, "quizCount": 1 }
  ],
  "url": "https://astacity.com/course/comptia-security-plus-sy0-701"
}
GET/v1/paths

Published career paths with their ordered steps and certifications. The outcome and its disclaimer always travel together — quote both.

curl https://astacity.com/api/v1/paths \
  -H "Authorization: Bearer ask_…"
Example response
{
  "total": 6,
  "items": [
    {
      "slug": "cybersecurity-analyst",
      "title": "Cybersecurity Analyst",
      "targetRole": "Security Analyst",
      "estimatedHours": 120,
      "outcome": "…",
      "disclaimer": "…",
      "steps": [
        {
          "position": 1,
          "courseSlug": "comptia-a-plus-core-1",
          "title": "CompTIA A+ Core 1 (220-1201)",
          "certification": { "vendor": "CompTIA", "examCode": "220-1201", "examName": "CompTIA A+ Core 1" }
        }
      ],
      "url": "https://astacity.com/path/cybersecurity-analyst"
    }
  ]
}

Errors

Every error is JSON with the same shape:

{ "error": { "code": "INVALID_KEY", "message": "Unknown API key." } }
StatusCodeMeaning
401MISSING_KEYNo bearer token on the request.
401INVALID_KEYThe key doesn't match any client.
403KEY_SUSPENDEDThe key exists but access is suspended.
429RATE_LIMITEDMore than 60 requests in a minute.
404CERT_NOT_FOUNDNo certificate with that serial.
404COURSE_NOT_FOUNDNo published course with that slug.

Apply for API access

Free during early access. A human reviews every application — approved keys arrive by email, usually within one business day.

Need bulk seats or a custom integration instead? Astacity for Business is the right door.