Skip to main content
POST
/
v1
/
certifications
Create certification for the token subject
curl --request POST \
  --url https://api.natecosmic.com/v1/certifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "organization_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "external_id": "<string>",
  "external_source": "<string>",
  "certification_type_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source": "manual",
  "issued_on": "2023-12-25",
  "expires_on": "2023-12-25",
  "issuer_name": "<string>",
  "serial_number": "<string>"
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "external_id": "<string>",
    "external_source": "<string>",
    "certification_type_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "lifecycle_status": "active",
    "source": "manual",
    "issued_on": "2023-12-25",
    "expires_on": "2023-12-25",
    "issuer_name": "<string>",
    "serial_number": "<string>",
    "verification_status": "unverified",
    "validity_status": "valid",
    "verification_method": "<string>",
    "last_verified_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "certification_type": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "slug": "<string>",
      "title": "<string>",
      "status": "active"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Send the access token as a bearer credential. Available scopes: certification_records:read, certification_records:write, certification_types:read, certification_types:write, job_roles:read, job_roles:write, organization_members:read, organization_members:write, organizations:read, organizations:write, qualifications:read, qualifications:write. The scope query parameter on the OAuth authorize URL (for example openid, email, profile) only affects sign-in and identity; it is separate from these API scopes, which are configured per app in the developer portal and returned by GET /v1/me.

Headers

​
Idempotency-Key
string

Optional idempotency key for create/upsert. Same key with the same payload must not create duplicate resources.

Body

application/json

Create a certification. For org routes, organization_member_id is required when creating for a specific member.

​
organization_member_id
string<uuid>
​
external_id
string
​
external_source
string
​
certification_type_id
string<uuid>
​
source
enum<string>
Available options:
manual,
import,
api,
self-reported
​
issued_on
string<date>
​
expires_on
string<date>
​
issuer_name
string
​
serial_number
string

Response

Created

​
data
object
required