# Collections

## Get NFTs

Get on-chain metadata for NFTs in a collection. This API supports pagination support, with a default page size of 10. 

### <mark style="color:green;">**GET**</mark> /sol/v1/collections/get\_nfts

Query Parameters:

* network(optional): Solana blockchain environment (mainnet-beta). Currently, this endpoint works for `mainnet-beta` only.
* collection\_address: On-chain addres&#x73;*(public key)* of the collection.
* page: (optional) The page number to get the results for a particular page. If no page number is specified, then all the collections' nfts are returned in a single request.
* size: (optional) The number of results to be returned for each page. The default number is 10 and maximum 50 allowed.

Response:

* `nfts`: An array of on-chain and off-chain metadata of NFTs. The size of the array is equal to `size` the param, used in the input request.
* total\_pages: The total number of pages for the NFTs, according to the `size` param. Not present if the `page` is not sent in the API request.
* total\_count: Total number of NFTs in this collection.
* page: Represents the present page number. Not present if the `page` param is not mentioned in the request.
* size: Represents the page size used. Not present if the `page` param is not mentioned in the request.

{% tabs %}
{% tab title="JS" %}
{% code overflow="wrap" %}

```javascript
var myHeaders = new Headers();
myHeaders.append("x-api-key", "<YOUR-API-KEY>");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://api.shyft.to/sol/v1/collections/get_nfts?network=mainnet-beta&collection_address=1ascapYyxEYhbmmUcgXEsg9Nkdk9eZwPBohRCJCZSx3&page=5&size=2", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));
```

{% endcode %}
{% endtab %}

{% tab title="Response" %}

```json
{
    "success": true,
    "message": "Collection Nfts retrieved successfully",
    "result": {
        "nfts": [
            {
                "mint": "12f4gcftZZ626PyttLTpBP8LoBmvPkbQiLZGRtrJb4AC",
                "collection_data": {
                    "address": "1ascapYyxEYhbmmUcgXEsg9Nkdk9eZwPBohRCJCZSx3",
                    "verified": true
                },
                "creators": [
                    {
                        "address": "7rK2nh1hfALTjQcauAUXR2eg74UcgTpQzPZG79XTS9au",
                        "verified": true,
                        "share": 0
                    },
                    {
                        "address": "Hmi7WNiQEumHHezXw5cdJrWFF3QpKXHTmDDBTFkE5KL1",
                        "verified": false,
                        "share": 100
                    }
                ],
                "is_mutable": true,
                "metadata_uri": "https://arweave.net/y1rc3Rf5f7mEZVwRByzE5Y5F5zkdPE3-cDeSzN2UTLw",
                "name": "Shiba 2132",
                "primary_sale_happened": true,
                "royalty": 2.5,
                "symbol": "SSHIBAS",
                "update_authority": "padaSLVyzU91GkTVVHFfzLD8ec86Svnv9T1HJ2E9qKW"
            },
            {
                "mint": "12kng5FSiJ64TFbu55Hd3xK3WCdnPpDbUiLFxmWiVKyV",
                "collection_data": {
                    "address": "1ascapYyxEYhbmmUcgXEsg9Nkdk9eZwPBohRCJCZSx3",
                    "verified": true
                },
                "creators": [
                    {
                        "address": "7rK2nh1hfALTjQcauAUXR2eg74UcgTpQzPZG79XTS9au",
                        "verified": true,
                        "share": 0
                    },
                    {
                        "address": "Hmi7WNiQEumHHezXw5cdJrWFF3QpKXHTmDDBTFkE5KL1",
                        "verified": false,
                        "share": 100
                    }
                ],
                "is_mutable": true,
                "metadata_uri": "https://arweave.net/ey35rG-OOYzwgjLZbPKDwhR__YTp1KidY65SXloCBFE",
                "name": "Shiba 3703",
                "primary_sale_happened": true,
                "royalty": 2.5,
                "symbol": "SSHIBAS",
                "update_authority": "padaSLVyzU91GkTVVHFfzLD8ec86Svnv9T1HJ2E9qKW"
            }
        ],
        "total_pages": 4962,
        "total_count": 9924,
        "page": 5,
        "size": 2
    }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.shyft.to/solana-apis/collections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.