Organizations

Get a list of Organizations where the authenticated user is admin

get

Required scopes

This endpoint requires the following scopes:

• : Read organization data

Authorizations

oauthaccessToken

OAuth2authorizationCodeRequired

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

Authorization URL: Token URL:

Responses

200

OK

application/jsonapplication/ld+json

400

Bad Request

*/*

get

/v2/organizations

HTTPcURLJavaScriptPython

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

{
  "organizations": [
    {
      "id": "67ae3efe2ee1d96b56fc1957",
      "name": "University of Credentials",
      "profile": {
        "url": "https://www.example.com",
        "email": "[email protected]",
        "description": "A university that issues credentials.",
        "imageUrl": "https://www.example.com/logo.png"
      }
    }
  ]
}

List public issuers for the specified organization with pagination and optional name filtering

get

Authorizations

accessToken

HTTPRequired

Path parameters

idstringRequired

Query parameters

nameQuerystring · max: 256Optional

Case-insensitive filter for the name of the issuers

numstring · max: 9223372036854776000Optional

Number of items to return per page

Example: 10

pagestring · min: 1Optional

Index of the requested page (1-based)

Example: 1

Responses

200

OK

application/jsonapplication/ld+json

400

Bad Request

*/*

get

/v2/organizations/{id}/public-issuers

HTTPcURLJavaScriptPython

GET /v2/organizations/{id}/public-issuers HTTP/1.1
Host: api.badges.parchment.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "pagination": {
    "previousLink": "text",
    "nextLink": "text",
    "totalPages": 6,
    "currentPage": 1,
    "pageSize": 10,
    "totalCount": 100,
    "hasNextPage": true
  },
  "items": [
    {
      "issuerId": "67e9d238c5afe622816febb3",
      "organizationId": "65e9d238c5afe622816febb3",
      "obIssuer": {
        "id": "text",
        "@context": "text",
        "name": "text",
        "url": "text",
        "email": "text",
        "description": "text",
        "image": "text"
      },
      "badgeSkillLinkingPreferences": {
        "type": "TALENT_NEURON",
        "serverUri": "https://example.com/",
        "linkMode": "DEFAULT",
        "indeedRegion": "us"
      }
    }
  ]
}