---
# System prepended metadata

title: "\U0001F60D New API Features"

---

# 😍 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":"test@example.com"
   },
   "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
```