# 😍 New API Features

Here are a few of our new API capabilities.

## Award badge by name

Create an Assertion and include the `badgeclassName` in the request body. If a single matching BadgeClass is found the assertion will be created. If a BadgeClass name is not unique or does not match the request will fail.

**Example JSON body request payload:**

{
   "recipient":{
      "identity":"[e-mail]"
   },
   "badgeclassName":"Some Badge"
}

`POST /v2/issuers/{entity_id}/assertions`

## Fetch assertions by recipient

To filter assertions include one or more `recipient` parameters in the request. Each value should be url-encoded. Both Issuer and BadgeClass associated assertions can be requested and filtered.

GET /v2/badgeclasses/{entity_id}/assertions?recipient={id1}&recipient={id2}

GET /v2/issuers/{entity_id}/assertions?recipient={id1}

**Example requests:**

To request all the assertions awarded by Issuer with entity_id `abc123` to recipients `https://example.com/123` and `https://example.com/456`:

/v2/issuers/abc123/assertions?recipient=https%3A%2F%2Fexample.com%2F123&recipient=https%3A%2F%2Fexample.com%2F456

To request all the assertions associated with the BadgeClass with entity_id `abc123` to recipients `https://example.com/123`:

/v2/badgeclasses/abc123/assertions?recipient=https%3A%2F%2Fexample.com%2F123