# Featured Plaques API

This API endpoint allows users to retrieve a list of all featured plaques. Featured plaques are those that have been selected by our team to be highlighted and promoted on our platform.

### Featured Plaques API

<mark style="color:blue;">`GET`</mark> `https://api.stagemeta.dev/plaques/featured`

#### Query Parameters

| Name     | Type   | Description                                                                                                                                                                                                                                                  |
| -------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| skip     | Number |                                                                                                                                                                                                                                                              |
| limit    | Number |                                                                                                                                                                                                                                                              |
| orderBy  | String | `p.id`, `p.updated_at`, `p.updatedAt`, `p.status`, `p.sale_at`, `p.featured_at`, `p.minted_at`                                                                                                                                                               |
| filterBy | String | `p.updated_at`, `p.sale_at`, `p.featured_at`, `p.minted_at`                                                                                                                                                                                                  |
| sort     | String | `ASC`, `DESC`                                                                                                                                                                                                                                                |
| search   | String |                                                                                                                                                                                                                                                              |
| filters  | Object | *Example* : `{ "filters": { "condition": ["VIRGIN", "USED", "DAMAGED"], "marketplace": ["OPENSEA","STAGE"], "status": ["AVAILABLE", "SOLD", "MINTED", "LOCKED"], "featured": true, "from": "2022-03-13T22:25:30.475Z", "to": "2023-03-13T22:25:30.475Z" } }` |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
  "count": 20,
  "plaques": [
    {
      "id": 1000,
      "createdAt": "2023-03-28T15:06:27.483Z",
      "updatedAt": "2023-03-29T10:11:25.086Z",
      "deletedAt": null,
      "name": "tpa-000",
      "alphabetPart": "tpa",
      "numberPart": "000",
      "image": "https://cdn.stagemeta.world/palques/tpa-000.jpg",
      "price": 0,
      "currency": "ETH",
      "marketplace": "stage",
      "tokenId": null,
      "mappedPlaqueId": null,
      "contractAddress": "0x000000000000000000000000000000000000000",
      "featured": true,
      "description": "",
      "standard": "ERC-1155",
      "metadata": null,
      "building_id": null,
      "wallet_address": null,
      "condition": "VIRGIN",
      "assignAt": null,
      "saleAt": null,
      "featuredAt": "2023-03-28T15:06:27.481Z",
      "mintedAt": null,
      "status": "AVAILABLE"
    },
    .
    .
    .
  ],
  
}
```

{% endtab %}

{% tab title="500: Internal Server Error There was an error in preparing the plaque. Please contact Stagemeta support." %}

{% endtab %}

{% tab title="401: Unauthorized The access token provided in the Authorization header is invalid." %}

{% endtab %}

{% tab title="404: Not Found The plaque specified in the endpoint does not exist" %}

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Curl" %}

```bash
curl -X 'GET' \ 'https://api.stagemeta.dev/plaques/featured' \ -H 'accept: */*'
```

{% endtab %}

{% tab title="Node" %}
{% code overflow="wrap" %}

```javascript
fetch('https://api.stagemeta.dev/plaques/featured', {
  method: 'GET',
  headers: {
    'accept': '*/*'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
```

{% endcode %}
{% endtab %}
{% endtabs %}