Developer API

Accreditation Verification API

Allow third-party websites and systems to programmatically verify the accreditation status of any GCCTA-registered institution.

Live

REST · JSON

CORS Enabled

API v1.0

Endpoint

POST

/functions/verifyAccreditation

Find the full URL in your dashboard under Code → Functions → verifyAccreditation.

Authentication

Optional API Key: Set the VERIFY_API_KEY secret in your dashboard under Settings → Environment Variables. Once set, all requests must include "api_key" in the request body. If not set, the endpoint is open.

Request Parameters

Parameter	Type	Required	Description
institution_name	string	One of	Exact institution name (case-insensitive)
institution_id	string	One of	The institution's unique GCCTA ID
api_key	string	If set	Your API key for authenticated access

Examples

Verify by Name

POST /functions/verifyAccreditation
Content-Type: application/json

{
  "institution_name": "Grace Seminary International",
  "api_key": "your_api_key_here"
}

Verify by ID

POST /functions/verifyAccreditation
Content-Type: application/json

{
  "institution_id": "abc123def456",
  "api_key": "your_api_key_here"
}

Response Examples

200 — Accredited

{
  "verified": true,
  "institution": {
    "id": "abc123def456",
    "name": "Grace Seminary International",
    "type": "seminary",
    "country": "Nigeria",
    "city": "Lagos",
    "website": "https://graceseminary.org",
    "founding_year": "2005",
    "delivery_format": "hybrid"
  },
  "accreditation": {
    "status": "approved",
    "category": "full_accreditation",
    "is_valid": true,
    "valid_from": "2024-03-15",
    "valid_until": "2027-03-15",
    "issuing_body": "Global Council for Christian Theological Accreditation (GCCTA)",
    "verification_url": "https://gccta.org/directory"
  },
  "meta": {
    "queried_at": "2026-05-19T10:00:00.000Z",
    "api_version": "1.0"
  }
}

404 — Not Found

{
  "verified": false,
  "error": "Not Found",
  "message": "No institution found matching the provided identifier."
}

Notes

Only institutions with approved status return verified: true.
Accreditation validity is calculated as 3 years from the approval date.
The endpoint supports CORS, so it can be called directly from browser-based third-party websites.
Responses always include the meta.queried_at timestamp for audit trails.