Guides & articles

MOSADAQA integration guide for beneficiary entities

A step-by-step walkthrough for integrating MOSADAQA with your HR, admissions or licensing systems — from sandbox credentials to production cut-over.

6 min readGuides & articles

1. Request sandbox access

Open the contact form, pick "Products & Solutions" → MOSADAQA, and describe the system you want to integrate (HR platform, admissions system, licensing backoffice, etc.). Our integration team replies within two business days with sandbox credentials and the OpenAPI spec.

2. Implement the verification call

Use the provided `POST /v1/verifications` endpoint with the certificate number and beneficiary ID. The response returns an authenticated report containing the issuing institution, graduation year, and a signed verification hash.

3. Handle the async states

Most verifications resolve within seconds. For manual-review cases, poll `GET /v1/verifications/{id}` or register a webhook and wait for the `verification.completed` event.

4. Production go-live

Once your test suite passes against the sandbox, request production credentials. A success manager will walk you through rate limits, monitoring and the rollback plan before your first real request.

Still need a hand?

Open a support request and the right team will reply within one business day.

Contact the support team