Skip to content

Issuer Authorizations

Get Issuers

Retrieve the set of authorized issuers for an organization.

Request

GET /organizations/<organization_id>/issuers

Response

200 OK

{
  "data": [
    {
      "id": "7afe939e-b907-4234-90dd-a71f60bb1be6",
      "authorization_type": "platform",
      "display_issuer_as": "grantor",
      "restrict_by_badge_templates": false,
      "subscription_type": null,
      "allowed_badge_templates": [

      ],
      "collections": [

      ],
      "issuer": {
        "type": "Organization",
        "id": "4a98b6d0-17c2-41c6-b452-343f447fe31a",
        "name": "Organization 34",
        "vanity_slug": "organization-34",
        "url": "http://www.example.com/",
        "photo": {
          "id": "7c5e4b37-12ea-425c-b376-d26ef6676b25",
          "url": "https://cdn.example.com/path/to/image.png"
        },
        "photo_url": "https://cdn.example.com/path/to/image.png",
        "badge_template_count": 0
      },
      "grantor": {
        "type": "Organization",
        "id": "9caffc27-6f59-4beb-ac27-aee61804ca2b",
        "name": "Organization 33",
        "vanity_slug": "organization-33",
        "url": "http://www.example.com/",
        "photo": {
          "id": "8d1c55df-6ced-450d-a386-7d9628f95f63",
          "url": "/system/test/images/8d1c55df-6ced-450d-a386-7d9628f95f63/large_fake-600x600.png"
        },
        "photo_url": "https://cdn.example.com/path/to/image.png",
        "badge_template_count": 0
      }
    }
  ],
  "metadata": {
    "count": 1,
    "current_page": 1,
    "total_count": 1,
    "total_pages": 1,
    "per": 50,
    "previous_page_url": null,
    "next_page_url": null
  }
}

Get Grantors

Retrieve the list of organizations that have added an organization as an issuer

Request

GET /organizations/<organization_id>/grantors

Response

200 OK

{
  "data": [
    {
      "id": "bf4aec8c-a5cd-4ed9-bcb1-75e3222ecb5d",
      "grantor": {
        "type": "Organization",
        "id": "e43cb779-9858-407b-a22d-6cd8abe893bd",
        "name": "Organization 35",
        "vanity_slug": "organization-35",
        "url": "http://www.example.com/",
        "photo": {
          "id": "24ead5f0-6209-4921-a6a2-95e5716467ca",
          "url": "/system/test/images/24ead5f0-6209-4921-a6a2-95e5716467ca/large_fake-600x600.png"
        },
        "photo_url": "https://cdn.example.com/path/to/image.png",
        "badge_template_count": 0
      }
    }
  ],
  "metadata": {
    "count": 1,
    "current_page": 1,
    "total_count": 1,
    "total_pages": 1,
    "per": 50,
    "previous_page_url": null,
    "next_page_url": null
  }
}

Deauthorize an Issuer

Remove an organization from the list of authorized issuers.

Request

DELETE /organizations/<organization_id>/issuers/<id>

Response

204 No Content