Skip to content

certSchema

type: object

a document that proves successful completion of a course of education or training

id

type: string
optional? yes

an identifier for the certificate

name

type: string

the name of the certificate

field

type: string
optional? yes

the field of study in which the certificate was obtained

period

type: object

the period of study for the certificate

start

type: union

the start date of the period

start/0

type: object
additional validation? yes

a fully-specified date in the Gregorian calendar

year

type: yearSchema

a year in the Gregorian calendar

month

type: monthSchema

a month in the Gregorian calendar

day

type: daySchema

a day of the month in the Gregorian calendar

start/1

type: tuple

a date consisting only of a year

start/1[0]

type: yearSchema

a year in the Gregorian calendar

start/2

type: tuple

a date consisting of a year and a month

start/2[0]

type: yearSchema

a year in the Gregorian calendar

start/2[1]

type: monthSchema

a month in the Gregorian calendar

start/3

type: tuple
additional validation? yes

a date consisting of a year, a month and a day of the month

start/3[0]

type: yearSchema

a year in the Gregorian calendar

start/3[1]

type: monthSchema

a month in the Gregorian calendar

start/3[2]

type: daySchema

a day of the month in the Gregorian calendar

end

type: dateSchema
optional? yes

the end date of a period; If omitted, the period is considered active in the present.

issue

type: union

the date on which the certificate was issued

issue/0

type: object
additional validation? yes

a fully-specified date in the Gregorian calendar

year

type: yearSchema

a year in the Gregorian calendar

month

type: monthSchema

a month in the Gregorian calendar

day

type: daySchema

a day of the month in the Gregorian calendar

issue/1

type: tuple

a date consisting only of a year

issue/1[0]

type: yearSchema

a year in the Gregorian calendar

issue/2

type: tuple

a date consisting of a year and a month

issue/2[0]

type: yearSchema

a year in the Gregorian calendar

issue/2[1]

type: monthSchema

a month in the Gregorian calendar

issue/3

type: tuple
additional validation? yes

a date consisting of a year, a month and a day of the month

issue/3[0]

type: yearSchema

a year in the Gregorian calendar

issue/3[1]

type: monthSchema

a month in the Gregorian calendar

issue/3[2]

type: daySchema

a day of the month in the Gregorian calendar

shortName

type: string
optional? yes

a short informal name for the certificate. This can be an abbreviation.

score

type: string
optional? yes

the score achieved in the certificate examination; This is the overall score (cumulative) for the complete certificate. E.g., “86”, “3.9” or “B-”.

maxScore

type: string
optional? yes

the maximum attainable score in the certificate examination; E.g., “100”, “4.0” or “A+”.

courses

type: array
optional? yes

a list of courses completed to obtain the certificate; E.g., “CS50 - Introduction to Computer Science”

courses[idx]

type: string

expiration

type: dateSchema
optional? yes

the date on which the certificate is set to become invalid; This is to be left blank if the certificate does not expire.

tags

type: array
optional? yes

tags to apply to this certificate; The use of tags is left up to the application (for example, the portfolio uses tags for PDF résumés).

tags[idx]

type: tagSchema

a string that classifies a given entity