---
title: "Class XII Marksheet"
method: POST
path: "/hscer/certificate"
tags: ["APIs"]
---

# Class XII Marksheet

`POST /hscer/certificate`

API to verify Class XII Marksheet.

## Request body

- object
  - `certificateParameters` object
    - `FullName` string, required — Full name
    - `examtype` string, required — Examination Type
    - `rollno` string, required — Roll No
    - `year` string, required — Year
  - `consentArtifact` ConsentArtifactSchema
    - `consent` object, required
      - `consentId` string, uuid, required — A unique consent id in UUID format.
      - `data` object, required
        - `id` string, required
      - `dataConsumer` object, required
        - `id` string, required
      - `dataProvider` object, required
        - `id` string, required
      - `permission` object, required
        - `access` string, required
        - `dateRange` object, required
          - `from` string, date-time, required — Date time format in UTC, includes miliseconds YYYY-MM-DDThh:mm:ss.vZ
          - `to` string, date-time, required — Date time format in UTC, includes miliseconds YYYY-MM-DDThh:mm:ss.vZ
        - `frequency` object, required
          - `repeats` number, required
          - `unit` string, required
          - `value` number, required
      - `purpose` object, required
        - `description` string, required
      - `timestamp` string, date-time, required — Date time format in UTC, includes miliseconds YYYY-MM-DDThh:mm:ss.vZ
      - `user` object, required
        - `email` string, required
        - `idNumber` string, required
        - `idType` string, required
        - `mobile` string, required
    - `signature` object, required
      - `signature` string, required
  - `format` 'pdf', required — The format of the certificate in response.
  - `txnId` string, uuid, required — A unique transaction id for this request in UUID format. It is used for tracking the request.

## Response `200`

The certificate data in response body in PDF, XML or JSON format as requested in format parameter.

## Other responses

- `400` — Bad request
- `401` — Unauthorized access
- `404` — No record found
- `500` — Internal server error
- `502` — Bad gateway
- `503` — Service unavailable
- `504` — Gateway timeout

---

[API](https://skmtc.net/apisetu/apis/cgbse.md) · [All operations](https://skmtc.net/apisetu/apis/cgbse/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apisetu/cgbse/versions/5b0cf0fba5e5/schema)