Membership Tier

Get all membershipTiers for entity

This endpoint retrieves all the membershipTiers of an entity.

GEThttps://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers

Path parameters

entityId*string

Query parameters

Header parameters

Response

200400500

Successful response

Body

application/json

successboolean

dataarray of MembershipTier (object)

Request

JavaScriptCurl

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "success": true,
  "data": [
    {
      "entityId": "entity123",
      "membershipTier": 1,
      "xpThreshold": 1000,
      "isEnabled": true,
      "createdAt": "2023-06-27T12:45:00Z",
      "description": "Membership tier description",
      "imageIPFS": "ipfs://image123"
    }
  ]
}

Add new membershipTier for entity

This endpoint allows to add a new membershipTier for an entity.

POSThttps://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers

Path parameters

entityId*string

Query parameters

Header parameters

Body

application/json

xPThreshold*number

membershipTier*number

imageIPFSstring

descriptionstring

Response

200400500

Successful response

Body

application/json

successboolean

Request

JavaScriptCurl

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "xPThreshold": 100,
      "membershipTier": 2
    }),
});
const data = await response.json();

Response

{
  "success": true
}

Get membershipTier details for entity

This endpoint retrieves the membershipTier details of an entity.

GEThttps://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers/{membershipTier}

Path parameters

entityId*string

membershipTier*string

Query parameters

Header parameters

Response

200400500

Successful response

Body

application/json

successboolean

dataMembershipTier (object)

Request

JavaScriptCurl

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers/{membershipTier}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "success": true,
  "data": {
    "entityId": "entity123",
    "membershipTier": 1,
    "xpThreshold": 1000,
    "isEnabled": true,
    "createdAt": "2023-06-27T12:45:00Z",
    "description": "Membership tier description",
    "imageIPFS": "ipfs://image123"
  }
}

Update membershipTier for entity

This endpoint allows to update a membershipTier for an entity.

POSThttps://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers/{membershipTier}/update

Path parameters

entityId*string

membershipTier*string

Query parameters

Header parameters

Body

application/json

xPThreshold*number

imageIPFSstring

descriptionstring

Response

200400500

Successful response

Body

application/json

successboolean

Request

JavaScriptCurl

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers/{membershipTier}/update', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "xPThreshold": 100
    }),
});
const data = await response.json();

Response

{
  "success": true
}

Delete membershipTier for entity

This endpoint allows to delete a membershipTier for an entity.

POSThttps://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers/{membershipTier}/delete

Path parameters

entityId*string

membershipTier*string

Query parameters

Header parameters

Body

application/json

The request body is an empty object.

object

Response

200400500

Successful response

Body

application/json

successboolean

Request

JavaScriptCurl

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers/{membershipTier}/delete', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
});
const data = await response.json();

Response

{
  "success": true
}

Claim rewards for a specific membership tier of an entity

This endpoint allows users to claim rewards for a specific membership tier of an entity.

POSThttps://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers/{membershipTier}/claim-rewards

Path parameters

entityId*string

membershipTier*string

Query parameters

Header parameters

Body

application/json

addToDynamicNFT*boolean

Response

200400401500

Successful response

Body

application/json

successboolean

Request

JavaScriptCurl

const response = await fetch('https://api.questprotocol.xyz/api/entities/{entityId}/membershipTiers/{membershipTier}/claim-rewards', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "addToDynamicNFT": false
    }),
});
const data = await response.json();

Response

{
  "success": true
}