# Skills & Verification API

> Unified documentation for Skills management and Record Skills Verification APIs.

## Docs

- [Get Skill Counts](https://docs.userecord.io/api-reference/endpoint/counts.md): A quick snapshot of how many skills are in the database.
- [Add Selected Skill](https://docs.userecord.io/api-reference/endpoint/create.md): Record that a user has selected a skill.
- [Delete Selected Skill](https://docs.userecord.io/api-reference/endpoint/delete.md): Remove a skill from a user's profile. This can't be undone.
- [Get Selected Skills](https://docs.userecord.io/api-reference/endpoint/get.md): Pull up everything a user has selected so far.
- [Search Skills](https://docs.userecord.io/api-reference/endpoint/search.md): Search the skill catalogue by keyword. No auth needed.
- [API Reference](https://docs.userecord.io/api-reference/introduction.md): Authentication, errors, rate limits — the stuff that applies to every endpoint.
- [Get Credential Batch](https://docs.userecord.io/api-reference/issuance/get-batch.md): Retrieve full details of a credential batch including all recipients and their credential URLs.
- [Get Program](https://docs.userecord.io/api-reference/issuance/get-program.md): Retrieve details of a single programme by its ID.
- [Issuance API](https://docs.userecord.io/api-reference/issuance/introduction.md): Issue verifiable credentials to recipients under your programmes.
- [Issue Credentials](https://docs.userecord.io/api-reference/issuance/issue-credentials.md): Issue verifiable credentials to one or more recipients under a programme.
- [List Credential Batches](https://docs.userecord.io/api-reference/issuance/list-batches.md): List all credential batches issued under your organisation.
- [List Programs](https://docs.userecord.io/api-reference/issuance/list-programs.md): Retrieve all programmes belonging to your organisation.
- [Generate Assessment Questions](https://docs.userecord.io/api-reference/verification/assessment-generate.md): Generate AI-powered multiple-choice questions for skill assessment.
- [Get Assessment Questions](https://docs.userecord.io/api-reference/verification/assessment-get.md): Retrieve previously generated questions for a session.
- [Retake Assessment](https://docs.userecord.io/api-reference/verification/assessment-retake.md): Generate fresh questions for a student to retry a failed assessment.
- [Submit Assessment](https://docs.userecord.io/api-reference/verification/assessment-submit.md): Submit answers, score the assessment, and update skill verification statuses.
- [Get Skills for Review](https://docs.userecord.io/api-reference/verification/human-get-skills.md): Return all skills for a verification session — used to render the reviewer's page.
- [Send Reviewer Email](https://docs.userecord.io/api-reference/verification/human-send-email.md): Trigger the human verification flow by sending the reviewer a secure email link.
- [Check Verification Status](https://docs.userecord.io/api-reference/verification/human-status.md): Return the current reviewer session status for a verification.
- [Verify Skills](https://docs.userecord.io/api-reference/verification/human-verify.md): Reviewer submits their endorsement decision.
- [Get Verify Page Data](https://docs.userecord.io/api-reference/verification/human-verify-page.md): Return all data needed to render the reviewer's verification page.
- [Init Session](https://docs.userecord.io/api-reference/verification/init.md): Initialize a skill verification session for a student.
- [Skill Verification API](https://docs.userecord.io/api-reference/verification/introduction.md): Verify student skills through human endorsement or AI-based assessment.
- [Get User Skills](https://docs.userecord.io/api-reference/verification/metadata-user-skills.md): Return all skill verification records for a student, sorted by most recently created.
- [Get Company Name by Website](https://docs.userecord.io/api-reference/verification/reviewer-company-name.md): Look up a company name from previously stored reviewer records by website domain.
- [Get Email Suggestions](https://docs.userecord.io/api-reference/verification/reviewer-email-suggestions.md): Return reviewer autocomplete suggestions filtered by website domain and optional email prefix.
- [Get Reviewer Details](https://docs.userecord.io/api-reference/verification/reviewer-get.md): Fetch the reviewer details stored for a verification session.
- [Store Reviewer Details](https://docs.userecord.io/api-reference/verification/reviewer-store.md): Store the endorser details for a human verification session.
- [Get Stored Skills](https://docs.userecord.io/api-reference/verification/step1-get-skills.md): Fetch all skills stored for a verification session.
- [Store Skills](https://docs.userecord.io/api-reference/verification/step1-store-skills.md): Store the list of skills a student wants verified for a given session.
- [Verify Proof URL](https://docs.userecord.io/api-reference/verification/step1-verify-url.md): Check whether a URL is publicly accessible before storing it as proof.
- [Set Verification Method](https://docs.userecord.io/api-reference/verification/step2-method.md): Choose between human endorsement or AI assessment for the verification.
- [Get Verification Items](https://docs.userecord.io/api-reference/verification/step3-get-items.md): Fetch all stored source items for a verification session.
- [Get Session Data](https://docs.userecord.io/api-reference/verification/step3-session-data.md): Retrieve the full session data stored in Redis for the given session token.
- [Get Session Email](https://docs.userecord.io/api-reference/verification/step3-session-email.md): Return only the email, name, and recordUserId from the session.
- [Store Verification Items](https://docs.userecord.io/api-reference/verification/step3-store-items.md): Attach source items (projects, experience, certificates) to a verification session.
- [Update Session Email](https://docs.userecord.io/api-reference/verification/step3-update-email.md): Update the student's email in both the Redis session and the database.
- [Skills](https://docs.userecord.io/guides/api-skills.md): List available skills and understand how skills are matched to source data.
- [Vault](https://docs.userecord.io/guides/api-vault.md): Retrieve verified skill records from the vault by user ID.
- [Verification](https://docs.userecord.io/guides/api-verification.md): Create and retrieve skill verification sessions via the API.
- [Webhooks](https://docs.userecord.io/guides/api-webhooks.md): Register webhooks to receive real-time verification events and validate payloads with HMAC-SHA256.
- [Authentication](https://docs.userecord.io/guides/authentication.md): How to authenticate API requests using your API key.
- [Edge Cases](https://docs.userecord.io/guides/edge-cases.md): Validation rules for human endorsement and assessment verification flows.
- [Environments](https://docs.userecord.io/guides/environments.md): Test (sandbox) and Production environments — differences and isolation guarantees.
- [FAQ](https://docs.userecord.io/guides/faq.md): Frequently asked questions about the Skill Verification Platform.
- [Introduction](https://docs.userecord.io/guides/introduction.md): Full integration lifecycle for the Skill Verification Platform — SDK, verification flows, webhooks, and vault access.
- [Privacy Policy](https://docs.userecord.io/guides/privacy-policy.md)
- [Sandbox / Testing](https://docs.userecord.io/guides/sandbox.md): How to use the Test environment to validate your integration before going live.
- [SDK Initialization](https://docs.userecord.io/guides/sdk-initialization.md): Initialize the SDK once on app load with your API key and environment mode.
- [SDK Installation](https://docs.userecord.io/guides/sdk-installation.md): Install the Skill Verification SDK via npm, yarn, or a CDN script tag.
- [Source Configuration](https://docs.userecord.io/guides/sdk-source-configuration.md): How to configure and pass project, experience, and certificate source details from your client app to the platform.
- [Vault Popup](https://docs.userecord.io/guides/sdk-vault-popup.md): Open the skill vault popup to let users access and manage their verified skills.
- [Terms of Service](https://docs.userecord.io/guides/terms-of-service.md)
- [Verification Touchpoints](https://docs.userecord.io/guides/touchpoints.md): How verification proofs accumulate across endorsement types and assessments.
- [Authentication](https://docs.userecord.io/smartai/authentication.md): API key setup and HMAC-SHA256 request signing for SmartAI Assessment.
- [AssessmentPortal.close()](https://docs.userecord.io/smartai/frontend-close.md): Programmatically dismiss the assessment overlay from your application code.
- [AssessmentPortal.isOpen()](https://docs.userecord.io/smartai/frontend-is-open.md): Check whether the assessment overlay is currently mounted in the DOM.
- [AssessmentPortal.open()](https://docs.userecord.io/smartai/frontend-open.md): Open the SmartAI assessment modal inside your app. The candidate takes the test without leaving your page.
- [SmartAI Assessment](https://docs.userecord.io/smartai/introduction.md): Plug-and-play AI-proctored assessment platform. Integrate in minutes using our backend and frontend packages.
- [client.acknowledgeWebhookEvents()](https://docs.userecord.io/smartai/sdk-acknowledge-events.md): Remove processed events from the SmartAI queue. Always call this after saving results.
- [client.createSession()](https://docs.userecord.io/smartai/sdk-create-session.md): Create a session token for one or more candidates. Call this inside your session endpoint handler.
- [client.getWebhookEvents()](https://docs.userecord.io/smartai/sdk-get-webhook-events.md): Pull pending assessment-completion events from the SmartAI queue. Run this on a timer in your backend.
- [client.listAssessments()](https://docs.userecord.io/smartai/sdk-list-assessments.md): List all assessment templates configured for your organisation. Use this to build an assessment picker UI.
- [Create Session](https://docs.userecord.io/smartai/session-endpoint.md): Your backend endpoint that creates a session token for the SmartAI portal. Your frontend calls this before opening the assessment.
- [Suggested Database Schema](https://docs.userecord.io/smartai/suggested-db-schema.md): What to store from each WebhookEvent — with idempotent save pattern and recommended indexes.
- [Webhook Event — What You Receive](https://docs.userecord.io/smartai/webhook-event-schema.md): Every field explained in plain English. This is the data you get after a candidate finishes an assessment.
- [What Gets Stored in Redis](https://docs.userecord.io/smartai/webhook-redis-internals.md): Both event types, exact Redis key structure, TTL, and full JSON payloads — read directly from the source code.
- [Webhook Setup & Configuration](https://docs.userecord.io/smartai/webhook-setup.md): Everything you need to configure so your server receives assessment results. What to pass, what comes back, and a complete working setup.

## OpenAPI Specs

- [openapi](https://docs.userecord.io/api-reference/openapi.json)

## Optional

- [Swagger UI](https://api.example.com/api-docs)
- [GitHub](https://github.com/your-org/skills-api)