Users

Get a single BadgeUser profile

get

Required scopes

This endpoint requires the following scopes:

• : See who you are
• : Update your profile

Authorizations

oauthaccessToken

OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:

Path parameters

idOrEntityIdstringRequired

Responses

200

OK

application/json

400

Bad Request

*/*

get

/v2/users/{idOrEntityId}

HTTPcURLJavaScriptPython

GET /v2/users/{idOrEntityId} HTTP/1.1
Host: api.badges.parchment.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "status": {
    "success": true,
    "description": "ok"
  },
  "result": [
    {
      "id": "5f16c84d1ff787222b6c4d15",
      "entityType": "BadgeUser",
      "entityId": "Hey7J-GRSJeu6FNnHQwNyw",
      "firstName": "Jane",
      "lastName": "Doe",
      "emails": [
        {
          "email": "[email protected]",
          "verified": true,
          "primary": true,
          "caseVariants": [
            "text"
          ]
        }
      ],
      "url": [
        "https://example.com"
      ],
      "telephone": [
        "text"
      ],
      "badgrDomain": "badgrsupportgroup.badgr.com",
      "agreedTermsVersion": 4,
      "hasAgreedToLatestTermsVersion": true,
      "marketingOptIn": true,
      "hasPasswordSet": true,
      "recipient": {
        "identity": "[email protected]",
        "type": "email"
      }
    }
  ],
  "timestamp": "2026-01-03T00:24:51.487Z",
  "validationErrors": [
    "text"
  ],
  "nonFieldErrors": [
    "text"
  ],
  "fieldErrors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "errorCode": "text",
  "warnings": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "latestTermsVersion": 1
}

Update a BadgeUser

put

Required scopes

This endpoint requires the following scopes:

• : See who you are
• : Update your profile

Authorizations

oauthaccessToken

OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:

Path parameters

idOrEntityIdstringRequired

Body

application/json

firstNamestringOptionalExample: Jane

lastNamestringOptionalExample: Doe

marketingOptInbooleanOptionalExample: true

Responses

200

OK

application/json

400

Bad Request

*/*

put

/v2/users/{idOrEntityId}

HTTPcURLJavaScriptPython

PUT /v2/users/{idOrEntityId} HTTP/1.1
Host: api.badges.parchment.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "firstName": "Jane",
  "lastName": "Doe",
  "marketingOptIn": true
}

{
  "status": {
    "success": true,
    "description": "ok"
  },
  "result": [
    {
      "id": "5f16c84d1ff787222b6c4d15",
      "entityType": "BadgeUser",
      "entityId": "Hey7J-GRSJeu6FNnHQwNyw",
      "firstName": "Jane",
      "lastName": "Doe",
      "emails": [
        {
          "email": "[email protected]",
          "verified": true,
          "primary": true,
          "caseVariants": [
            "text"
          ]
        }
      ],
      "url": [
        "https://example.com"
      ],
      "telephone": [
        "text"
      ],
      "badgrDomain": "badgrsupportgroup.badgr.com",
      "agreedTermsVersion": 4,
      "hasAgreedToLatestTermsVersion": true,
      "marketingOptIn": true,
      "hasPasswordSet": true,
      "recipient": {
        "identity": "[email protected]",
        "type": "email"
      }
    }
  ],
  "timestamp": "2026-01-03T00:24:51.487Z",
  "validationErrors": [
    "text"
  ],
  "nonFieldErrors": [
    "text"
  ],
  "fieldErrors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "errorCode": "text",
  "warnings": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "latestTermsVersion": 1
}

Update a BadgeUser

patch

Required scopes

This endpoint requires the following scopes:

• : See who you are
• : Update your profile

Authorizations

oauthaccessToken

OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:

Path parameters

idOrEntityIdstringRequired

Body

application/json

firstNamestringOptionalExample: Jane

lastNamestringOptionalExample: Doe

marketingOptInbooleanOptionalExample: true

Responses

200

OK

application/json

400

Bad Request

*/*

patch

/v2/users/{idOrEntityId}

HTTPcURLJavaScriptPython

PATCH /v2/users/{idOrEntityId} HTTP/1.1
Host: api.badges.parchment.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "firstName": "Jane",
  "lastName": "Doe",
  "marketingOptIn": true
}

{
  "status": {
    "success": true,
    "description": "ok"
  },
  "result": [
    {
      "id": "5f16c84d1ff787222b6c4d15",
      "entityType": "BadgeUser",
      "entityId": "Hey7J-GRSJeu6FNnHQwNyw",
      "firstName": "Jane",
      "lastName": "Doe",
      "emails": [
        {
          "email": "[email protected]",
          "verified": true,
          "primary": true,
          "caseVariants": [
            "text"
          ]
        }
      ],
      "url": [
        "https://example.com"
      ],
      "telephone": [
        "text"
      ],
      "badgrDomain": "badgrsupportgroup.badgr.com",
      "agreedTermsVersion": 4,
      "hasAgreedToLatestTermsVersion": true,
      "marketingOptIn": true,
      "hasPasswordSet": true,
      "recipient": {
        "identity": "[email protected]",
        "type": "email"
      }
    }
  ],
  "timestamp": "2026-01-03T00:24:51.487Z",
  "validationErrors": [
    "text"
  ],
  "nonFieldErrors": [
    "text"
  ],
  "fieldErrors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "errorCode": "text",
  "warnings": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "latestTermsVersion": 1
}

Get your own BadgeUser profile

get

Required scopes

This endpoint requires the following scopes:

• : See who you are
• : Update your profile

Authorizations

oauthaccessToken

OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:

Responses

200

OK

application/json

400

Bad Request

*/*

get

/v2/users/self

HTTPcURLJavaScriptPython

GET /v2/users/self HTTP/1.1
Host: api.badges.parchment.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "status": {
    "success": true,
    "description": "ok"
  },
  "result": [
    {
      "id": "5f16c84d1ff787222b6c4d15",
      "entityType": "BadgeUser",
      "entityId": "Hey7J-GRSJeu6FNnHQwNyw",
      "firstName": "Jane",
      "lastName": "Doe",
      "emails": [
        {
          "email": "[email protected]",
          "verified": true,
          "primary": true,
          "caseVariants": [
            "text"
          ]
        }
      ],
      "url": [
        "https://example.com"
      ],
      "telephone": [
        "text"
      ],
      "badgrDomain": "badgrsupportgroup.badgr.com",
      "agreedTermsVersion": 4,
      "hasAgreedToLatestTermsVersion": true,
      "marketingOptIn": true,
      "hasPasswordSet": true,
      "recipient": {
        "identity": "[email protected]",
        "type": "email"
      }
    }
  ],
  "timestamp": "2026-01-03T00:24:51.487Z",
  "validationErrors": [
    "text"
  ],
  "nonFieldErrors": [
    "text"
  ],
  "fieldErrors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "errorCode": "text",
  "warnings": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "latestTermsVersion": 1
}

Update your own BadgeUser

put

Required scopes

This endpoint requires the following scopes:

• : See who you are
• : Update your profile

Authorizations

oauthaccessToken

OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:

Body

application/json

firstNamestringOptionalExample: Jane

lastNamestringOptionalExample: Doe

marketingOptInbooleanOptionalExample: true

Responses

200

OK

application/json

400

Bad Request

*/*

put

/v2/users/self

HTTPcURLJavaScriptPython

PUT /v2/users/self HTTP/1.1
Host: api.badges.parchment.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "firstName": "Jane",
  "lastName": "Doe",
  "marketingOptIn": true
}

{
  "status": {
    "success": true,
    "description": "ok"
  },
  "result": [
    {
      "id": "5f16c84d1ff787222b6c4d15",
      "entityType": "BadgeUser",
      "entityId": "Hey7J-GRSJeu6FNnHQwNyw",
      "firstName": "Jane",
      "lastName": "Doe",
      "emails": [
        {
          "email": "[email protected]",
          "verified": true,
          "primary": true,
          "caseVariants": [
            "text"
          ]
        }
      ],
      "url": [
        "https://example.com"
      ],
      "telephone": [
        "text"
      ],
      "badgrDomain": "badgrsupportgroup.badgr.com",
      "agreedTermsVersion": 4,
      "hasAgreedToLatestTermsVersion": true,
      "marketingOptIn": true,
      "hasPasswordSet": true,
      "recipient": {
        "identity": "[email protected]",
        "type": "email"
      }
    }
  ],
  "timestamp": "2026-01-03T00:24:51.487Z",
  "validationErrors": [
    "text"
  ],
  "nonFieldErrors": [
    "text"
  ],
  "fieldErrors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "errorCode": "text",
  "warnings": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "latestTermsVersion": 1
}

Update your own BadgeUser

patch

Required scopes

This endpoint requires the following scopes:

• : See who you are
• : Update your profile

Authorizations

oauthaccessToken

OAuth2authorizationCodeRequired

OAuth2 authorizationCode flow is currently not functional on the Swagger UI.

Authorization URL: Token URL:

Body

application/json

firstNamestringOptionalExample: Jane

lastNamestringOptionalExample: Doe

marketingOptInbooleanOptionalExample: true

Responses

200

OK

application/json

400

Bad Request

*/*

patch

/v2/users/self

HTTPcURLJavaScriptPython

PATCH /v2/users/self HTTP/1.1
Host: api.badges.parchment.com
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "firstName": "Jane",
  "lastName": "Doe",
  "marketingOptIn": true
}

{
  "status": {
    "success": true,
    "description": "ok"
  },
  "result": [
    {
      "id": "5f16c84d1ff787222b6c4d15",
      "entityType": "BadgeUser",
      "entityId": "Hey7J-GRSJeu6FNnHQwNyw",
      "firstName": "Jane",
      "lastName": "Doe",
      "emails": [
        {
          "email": "[email protected]",
          "verified": true,
          "primary": true,
          "caseVariants": [
            "text"
          ]
        }
      ],
      "url": [
        "https://example.com"
      ],
      "telephone": [
        "text"
      ],
      "badgrDomain": "badgrsupportgroup.badgr.com",
      "agreedTermsVersion": 4,
      "hasAgreedToLatestTermsVersion": true,
      "marketingOptIn": true,
      "hasPasswordSet": true,
      "recipient": {
        "identity": "[email protected]",
        "type": "email"
      }
    }
  ],
  "timestamp": "2026-01-03T00:24:51.487Z",
  "validationErrors": [
    "text"
  ],
  "nonFieldErrors": [
    "text"
  ],
  "fieldErrors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "errorCode": "text",
  "warnings": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "latestTermsVersion": 1
}