Get contract packages
Get a paginated list of contract packages.
GET /contract-packages
This endpoint allows you to retrieve a paginated list of contract packages. You can filter the results by owner public key, specify the page number and size, and choose the sorting order and field. Additionally, you can include optional deploys number data in the response. The example shows a sample response with relevant details for each contract package, including contract package hash, owner public key, name, description, metadata, latest version contract type ID, timestamp, icon URL, and deploys number.
Query params
owner_public_key
Owner public key filter.
Sorting
timestamp
Sort contract packages by timestamp.
Default sorting is timestamp DESC
Optional properties
deploys_number
int
account_info
ContractPackage owner account info
centralized_account_info
ContractPackage centralized account info
cspr_name
string
Owner's primary CSPR.name
Response
PaginatedResponse
<ContractPackage>
Example
curl -X 'GET' \
'https://api.testnet.cspr.cloud/contract-packages' \
-H 'Accept: application/json' \
-H 'Authorization: 55f79117-fc4d-4d60-9956-65423f39a06a'
{
"data": [
{
"contract_package_hash": "ae2feaa4e86841c1c6f40f1779e1e1cb1d9d4d52a0eb82a8962829646524e744",
"owner_public_key": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef01",
"name": "MyContractPackage1",
"description": "A sample contract package",
"metadata": {
"name": "MyToken1",
"symbol": "MT1",
"decimals": 18,
"balances_uref": "uref-0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef-007",
"total_supply_uref": "uref-abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef-007",
"ownership_mode": 1,
"nft_kind": 2,
"nft_metadata_kind": 1,
"whitelist_mode": 0,
"holder_mode": 1,
"minting_mode": 2,
"burn_mode": 1,
"identifier_mode": 0,
"metadata_mutability": 1,
"owner_reverse_lookup_mode": 1,
"events_mode": 2
},
"latest_version_contract_type_id": 3,
"timestamp": "2023-01-01T12:00:00Z",
"icon_url": "https://example.com/icon1.png",
"website_url": "https://example.com",
"deploys_number": 42
},
{
"contract_package_hash": "be2feaa4e86841c1c6f40f1779e1e1cb1d9d4d52a0eb82a8962829646524e745",
"owner_public_key": "abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
"name": "MyContractPackage2",
"description": "Another sample contract package",
"metadata": {
"name": "MyToken2",
"symbol": "MT2",
"decimals": 18,
"balances_uref": "uref-abcdef0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef-007",
"total_supply_uref": "uref-0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef-007",
"ownership_mode": 1,
"nft_kind": 2,
"nft_metadata_kind": 1,
"whitelist_mode": 0,
"holder_mode": 1,
"minting_mode": 2,
"burn_mode": 1,
"identifier_mode": 0,
"metadata_mutability": 1,
"owner_reverse_lookup_mode": 1,
"events_mode": 2
},
"latest_version_contract_type_id": 4,
"timestamp": "2023-01-02T12:00:00Z",
"icon_url": "https://example.com/icon2.png",
"website_url": "https://example.com",
"deploys_number": 56
},
...
],
"item_count": 100,
"page_count": 10
}
Last updated