Badge

Get all badges of a user

get

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/badges

This endpoint retrives all the badges that the user is associated with.

Query parameters

userIdstringRequired

The Id of the user performing the request.

Example: dummy-userid

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

Responses

200

Successful response

application/json

401

Unauthorized error

application/json

500

Server error

application/json

get

/badges

HTTPcURLJavaScriptPython

GET /api/badges?userId=dummy-userid HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
Accept: */*

{
  "success": true,
  "data": [
    {
      "data": {
        "xp": 10,
        "visibility": "OPEN",
        "type": "NONE",
        "remainingCount": 100,
        "createdAt": "2023-05-26T14:44:19.220Z",
        "badgeId": "dummy-id",
        "entityId": "e-000001",
        "name": "dummy-badge-name",
        "imageIPFS": "QmXdzQQ238rkdiM7i9YgXXEtm5n3Fypw9r6QPVtwjNMGzW",
        "description": "dummy-description",
        "skills": [
          {
            "skillId": "123",
            "score": 123
          }
        ],
        "badgeContractTokenId": "dummy-token",
        "endsAt": 1685198841965,
        "typeData": [
          "t"
        ],
        "proofType": "Proof of Appreciation",
        "createdBy": "u-0000001"
      },
      "inDyNFT": false,
      "claimed": false,
      "claimStatus": "UNCLAIMED"
    }
  ]
}

Get all badges created by a user

get

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/users/{userId}/created-badges

This endpoint retrives all the badges a user has created.

Path parameters

userIdstringRequired

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

useridstringRequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringRequired

The token for user authentication.

Example: dummy-token

Responses

200

Successful response

application/json

401

Unauthorized error

application/json

500

Server error

application/json

get

/users/{userId}/created-badges

HTTPcURLJavaScriptPython

GET /api/users/{userId}/created-badges HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
userid: dummy-userid
token: dummy-token
Accept: */*

{
  "success": true,
  "data": [
    {
      "data": {
        "xp": 10,
        "visibility": "OPEN",
        "type": "NONE",
        "remainingCount": 100,
        "createdAt": "2023-05-26T14:44:19.220Z",
        "badgeId": "dummy-id",
        "entityId": "e-000001",
        "name": "dummy-badge-name",
        "imageIPFS": "QmXdzQQ238rkdiM7i9YgXXEtm5n3Fypw9r6QPVtwjNMGzW",
        "description": "dummy-description",
        "skills": [
          {
            "skillId": "123",
            "score": 123
          }
        ],
        "badgeContractTokenId": "dummy-token",
        "endsAt": 1685198841965,
        "typeData": [
          "t"
        ],
        "proofType": "Proof of Appreciation",
        "createdBy": "u-0000001"
      },
      "inDyNFT": false,
      "claimed": false,
      "claimStatus": "UNCLAIMED"
    }
  ]
}

Get all badges of an entity

get

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/entities/{entityId}/badges

This endpoint retrives all the badges associated with an entity.

Path parameters

entityIdstringRequired

Query parameters

userIdstringRequired

The Id of the user performing the request.

Example: dummy-userid

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

Responses

200

Successful response

application/json

500

Server error

application/json

get

/entities/{entityId}/badges

HTTPcURLJavaScriptPython

GET /api/entities/{entityId}/badges?userId=dummy-userid HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
Accept: */*

{
  "success": true,
  "data": [
    {
      "data": {
        "xp": 10,
        "visibility": "OPEN",
        "type": "NONE",
        "remainingCount": 100,
        "createdAt": "2023-05-26T14:44:19.220Z",
        "badgeId": "dummy-id",
        "entityId": "e-000001",
        "name": "dummy-badge-name",
        "imageIPFS": "QmXdzQQ238rkdiM7i9YgXXEtm5n3Fypw9r6QPVtwjNMGzW",
        "description": "dummy-description",
        "skills": [
          {
            "skillId": "123",
            "score": 123
          }
        ],
        "badgeContractTokenId": "dummy-token",
        "endsAt": 1685198841965,
        "typeData": [
          "t"
        ],
        "proofType": "Proof of Appreciation",
        "createdBy": "u-0000001"
      },
      "inDyNFT": false,
      "claimed": false,
      "claimStatus": "UNCLAIMED"
    }
  ]
}

Add badge for an entity

post

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/entities/{entityId}/badges

This endpoint adds a badge for an entity.

Path parameters

entityIdstringRequired

Query parameters

userIdstringRequired

The Id of the user performing the request.

Example: dummy-userid

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

tokenstringRequired

The token for user authentication.

Example: dummy-token

useridstringRequired

The Id of the user performing the request.

Example: dummy-userid

Body

application/json

namestringRequiredExample: dummy-name

imageIPFSstringRequiredExample: dummy-hash

descriptionstringRequiredExample: dummy-description

userIdsstring[]OptionalExample: u-00000001

endsAtinteger · int64OptionalExample: 1685198841965

xpnumberOptionalExample: 0

airdropEnabledbooleanOptionalExample: false

typeDataobjectOptional

typestringOptionalExample: NONE

totalCountnumberOptionalExample: 10

visibilitystringOptionalExample: LIMITED

proofTypestringOptionalExample: dummy proof

Responses

200

Successful response

application/json

400

Client error

application/json

401

Unauthorized error

application/json

500

Server error

application/json

post

/entities/{entityId}/badges

HTTPcURLJavaScriptPython

POST /api/entities/{entityId}/badges?userId=dummy-userid HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
token: dummy-token
userid: dummy-userid
Content-Type: application/json
Accept: */*
Content-Length: 297

{
  "name": "dummy-name",
  "imageIPFS": "dummy-hash",
  "description": "dummy-description",
  "skills": [
    {
      "skillId": "dummy-id",
      "score": 100
    }
  ],
  "userIds": [
    "u-00000001"
  ],
  "endsAt": 1685198841965,
  "xp": 0,
  "airdropEnabled": false,
  "typeData": {},
  "type": "NONE",
  "totalCount": 10,
  "visibility": "LIMITED",
  "proofType": "dummy proof"
}

{
  "success": true,
  "badgeId": "badge-1212122"
}

Get badge details of an entity

get

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/entities/{entityId}/badges/{badgeId}

This endpoint retrives the badge details associated with an entity.

Path parameters

entityIdstringRequired

badgeIdstringRequired

Query parameters

userIdstringRequired

The Id of the user performing the request.

Example: dummy-userid

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

useridstringRequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringRequired

The token for user authentication.

Example: dummy-token

Responses

200

Successful response

application/json

400

Client error

application/json

401

Unauthorized error

application/json

500

Server error

application/json

get

/entities/{entityId}/badges/{badgeId}

HTTPcURLJavaScriptPython

GET /api/entities/{entityId}/badges/{badgeId}?userId=dummy-userid HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
userid: dummy-userid
token: dummy-token
Accept: */*

{
  "success": true,
  "data": {
    "badge_data": {
      "badgeId": "badge123",
      "entityId": "entity123",
      "badgeContractTokenId": "token123",
      "name": "My Badge",
      "imageIPFS": "https://example.com/badge-image.jpg",
      "description": "This is my badge description.",
      "xp": 100,
      "skills": [
        {
          "skillId": "skill1",
          "score": 80
        },
        {
          "skillId": "skill2",
          "score": 60
        }
      ],
      "isEnabled": true,
      "visibility": "LIMITED",
      "type": "DISCORD",
      "typeData": {
        "key1": "value1",
        "key2": "value2"
      },
      "proofType": "Type A",
      "endsAt": 1678900000,
      "remainingCount": 5,
      "createdBy": "user123",
      "createdAt": "2023-06-27T12:45:00Z"
    },
    "skills_data": [
      {
        "skillId": "skil-12",
        "score": 20,
        "name": "Java",
        "description": "sun-microsystem's java",
        "isEnabled": true
      }
    ],
    "entity_data": {
      "id": "entity123",
      "entityURLAlias": "my-entity",
      "entityRecordIds": [
        "record1",
        "record2"
      ],
      "contracts": [
        "contract1",
        "contract2"
      ],
      "badgeContractAddress": "0x123abc",
      "dyNFTContractAddress": "0x456def",
      "themeContractAddress": "0x789ghi",
      "name": "My Entity",
      "openseaSlug": "my-entity-slug",
      "description": "This is my entity description.",
      "twitter": "myentity",
      "discord": "myentity#1234",
      "telegram": "myentity",
      "instagram": "myentity",
      "website": "https://myentity.com",
      "medium": "myentity",
      "imageUrl": "https://example.com/myentity.jpg",
      "bannerUrl": "https://example.com/myentity-banner.jpg",
      "isEnabled": false,
      "isPrivate": false,
      "chainSource": "OFF_CHAIN",
      "defaultDyNftThemeId": "0",
      "discordQuestWebhookURL": "https://example.com/discord-webhook",
      "modifiedAt": "2023-06-27T12:45:00Z",
      "createdAt": "2023-06-25T09:00:00Z",
      "plan": "FREE",
      "theme": {},
      "parentEntityId": "e-0000001"
    },
    "claimedUsers": [
      {
        "userId": "user-123"
      }
    ],
    "unclaimedUsers": [
      {
        "userId": "user-123"
      }
    ],
    "isOwner": true,
    "stats": {
      "claimedCount": 10,
      "unclaimedCount": 5
    },
    "claimStatus": "NOT_WHITELISTED"
  }
}

Update badge

post

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/entities/{entityId}/badges/{badgeId}/update

This endpoint updates a badge of an entity.

Path parameters

entityIdstringRequired

badgeIdstringRequired

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

useridstringRequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringRequired

The token for user authentication.

Example: dummy-token

Body

application/json

namestringOptionalExample: dummy badge

imageIPFSstringOptionalExample: ipfa-hash

descriptionstringOptionalExample: updated the description

typestringOptionalExample: DISCORD

endsAtnumberOptionalExample: 720000

xpnumberOptionalExample: 20

typeDataobjectOptional

Responses

200

Successful response

application/json

400

Client error

application/json

401

Unauthorized error

application/json

500

Server error

application/json

post

/entities/{entityId}/badges/{badgeId}/update

HTTPcURLJavaScriptPython

POST /api/entities/{entityId}/badges/{badgeId}/update HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
userid: dummy-userid
token: dummy-token
Content-Type: application/json
Accept: */*
Content-Length: 183

{
  "name": "dummy badge",
  "imageIPFS": "ipfa-hash",
  "description": "updated the description",
  "type": "DISCORD",
  "skills": [
    {
      "skillId": "java",
      "score": 100
    }
  ],
  "endsAt": 720000,
  "xp": 20,
  "typeData": {}
}

{
  "success": true
}

Claim badge for an entity

post

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/entities/{entityId}/badges/{badgeId}/claim

This endpoint allows users to claim a badge for an entity

Path parameters

entityIdstringRequired

badgeIdstringRequired

Query parameters

userIdstringRequired

The Id of the user performing the request.

Example: dummy-userid

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

useridstringRequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringRequired

The token for user authentication.

Example: dummy-token

Body

application/json

addToDynamicNFTbooleanOptionalExample: true

Responses

200

Successful response

application/json

400

Client error

application/json

401

Unauthorized error

application/json

500

Server error

application/json

post

/entities/{entityId}/badges/{badgeId}/claim

HTTPcURLJavaScriptPython

POST /api/entities/{entityId}/badges/{badgeId}/claim?userId=dummy-userid HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
userid: dummy-userid
token: dummy-token
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "addToDynamicNFT": true
}

{
  "success": true,
  "nftMinted": true,
  "calculatedDynamicNFT": true
}

Add users to badge

post

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/entities/{entityId}/badges/{badgeId}/users

This endpoint allows an admin to add users to a Badge.

Path parameters

entityIdstringRequired

badgeIdstringRequired

Query parameters

userIdstringRequired

The Id of the user performing the request.

Example: dummy-userid

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

tokenstringRequired

The token for user authentication.

Example: dummy-token

Body

application/json

userIdsstring[]RequiredExample: ["user-1","user-2"]

Responses

200

Successful response

application/json

400

Client error

application/json

500

Server error

application/json

post

/entities/{entityId}/badges/{badgeId}/users

HTTPcURLJavaScriptPython

POST /api/entities/{entityId}/badges/{badgeId}/users?userId=dummy-userid HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
token: dummy-token
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "userIds": [
    "user-1",
    "user-2"
  ]
}

{
  "success": true
}

Get Badges Count for User

get

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/entities/{entityId}/users/{userId}/badges-count

Retrieve the number of badges earned by a specific user within a particular entity.

Path parameters

entityIdstringRequired

The unique identifier of the entity.

userIdstringRequired

The unique identifier of the user within the entity.

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

useridstringRequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringRequired

The token for user authentication.

Example: dummy-token

Responses

200

Successful response

application/json

401

Unauthorized error

application/json

500

Server error

application/json

get

/entities/{entityId}/users/{userId}/badges-count

HTTPcURLJavaScriptPython

GET /api/entities/{entityId}/users/{userId}/badges-count HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
userid: dummy-userid
token: dummy-token
Accept: */*

{
  "success": true,
  "data": 5
}

Get User Earned Badges for Entity

get

https://api.questprotocol.xyz/apihttps://staging.questprotocol.xyz/api

/entities/{entityId}/users/{userId}/badges

Retrieve the badges earned by a specific user within a particular entity.

Path parameters

entityIdstringRequired

The unique identifier of the entity.

userIdstringRequired

The unique identifier of the user within the entity.

Query parameters

prefixBadgeIpfsstringOptional

Specify 'true' to prefix Badge IPFS URLs with the base URL.

pageintegerOptional

The page number for paginated results (default: 1).

limitintegerOptional

The number of items per page (default: 20).

Header parameters

apikeystringRequired

The API key for authentication

Example: test

apisecretstringOptional

The secret key for authentication

Example: test-secret

useridstringRequired

The Id of the user performing the request.

Example: dummy-userid

tokenstringRequired

The token for user authentication.

Example: dummy-token

Responses

200

Successful response

application/json

401

Unauthorized error

application/json

500

Server error

application/json

get

/entities/{entityId}/users/{userId}/badges

HTTPcURLJavaScriptPython

GET /api/entities/{entityId}/users/{userId}/badges HTTP/1.1
Host: https:/.questprotocol.xyz
apikey: test
userid: dummy-userid
token: dummy-token
Accept: */*

{
  "success": true,
  "data": [
    {
      "badgeId": "badge123",
      "entityId": "entity123",
      "badgeContractTokenId": "token123",
      "name": "My Badge",
      "imageIPFS": "https://example.com/badge-image.jpg",
      "description": "This is my badge description.",
      "xp": 100,
      "skills": [
        {
          "skillId": "skill1",
          "score": 80
        },
        {
          "skillId": "skill2",
          "score": 60
        }
      ],
      "isEnabled": true,
      "visibility": "LIMITED",
      "type": "DISCORD",
      "typeData": {
        "key1": "value1",
        "key2": "value2"
      },
      "proofType": "Type A",
      "endsAt": 1678900000,
      "remainingCount": 5,
      "createdBy": "user123",
      "createdAt": "2023-06-27T12:45:00Z"
    }
  ],
  "page": 1,
  "totalCount": 10,
  "totalPages": 1
}