Categories

List categories

get

Query parameters

showOnLeaderboardbooleanOptional

showInDailyServicebooleanOptional

withUserCountbooleanOptional

limitnumberOptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/categories

HTTPcURLJavaScriptPython

GET /api/v2/categories HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "categories": [
    {
      "id": 1,
      "slug": "text",
      "name": "text",
      "description": "text",
      "showOnLeaderboard": true,
      "showInDailyService": true,
      "bannerImageUrl": "https://example.com",
      "userCount": 1
    }
  ],
  "total": 1
}

Create a new category

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

slugstring · min: 1 · max: 50Optional

namestringRequired

descriptionstringOptional

showOnLeaderboardbooleanRequired

showInDailyServicebooleanRequired

bannerImageUrlstring · uriOptional

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/categories

HTTPcURLJavaScriptPython

POST /api/v2/categories HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "slug": "text",
  "name": "text",
  "description": "text",
  "showOnLeaderboard": true,
  "showInDailyService": true,
  "bannerImageUrl": "https://example.com"
}

{
  "id": 1,
  "slug": "text",
  "name": "text",
  "description": "text",
  "showOnLeaderboard": true,
  "showInDailyService": true,
  "bannerImageUrl": "https://example.com",
  "userCount": 1
}

Get a specific category by ID

get

Path parameters

idinteger · max: 2147483647Required

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/categories/{id}

HTTPcURLJavaScriptPython

GET /api/v2/categories/{id} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "id": 1,
  "slug": "text",
  "name": "text",
  "description": "text",
  "showOnLeaderboard": true,
  "showInDailyService": true,
  "bannerImageUrl": "https://example.com",
  "userCount": 1
}

Get summaries for multiple categories

get

Query parameters

showOnLeaderboardbooleanOptional

showInDailyServicebooleanOptional

topUsersLimitnumber · max: 50OptionalDefault: 10

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/categories/summaries/bulk

HTTPcURLJavaScriptPython

GET /api/v2/categories/summaries/bulk HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "id": 1,
    "slug": "text",
    "name": "text",
    "description": "text",
    "showOnLeaderboard": true,
    "showInDailyService": true,
    "bannerImageUrl": "https://example.com",
    "topUsers": [
      {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "mommyPawnshopBingo": "REQUESTED",
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          }
        }
      }
    ],
    "userStats": {
      "totalUsers": 1,
      "averageScore": 1,
      "totalXp": 1,
      "averageXpTotal": 1,
      "totalXpStreakDays": 1,
      "averageXpStreakDays": 1,
      "totalReviewReceivedPositive": 1,
      "averageReviewReceivedPositive": 1,
      "totalReviewReceivedNegative": 1,
      "averageReviewReceivedNegative": 1,
      "totalReviewReceivedNeutral": 1,
      "averageReviewReceivedNeutral": 1,
      "totalVouchReceivedCount": 1,
      "averageVouchReceivedCount": 1,
      "totalVouchGivenCount": 1,
      "averageVouchGivenCount": 1,
      "totalVouchReceivedAmountWei": 1,
      "averageVouchReceivedAmountWei": 1,
      "totalVouchGivenAmountWei": 1,
      "averageVouchGivenAmountWei": 1
    }
  }
]

Update an existing category

put

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

categoryIdinteger · max: 2147483647Required

Body

application/json

slugstring · min: 1 · max: 50Optional

namestringOptional

descriptionstringOptional

showOnLeaderboardbooleanOptional

showInDailyServicebooleanOptional

bannerImageUrlstring · uriOptional

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

put

/categories/{categoryId}

HTTPcURLJavaScriptPython

PUT /api/v2/categories/{categoryId} HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "slug": "text",
  "name": "text",
  "description": "text",
  "showOnLeaderboard": true,
  "showInDailyService": true,
  "bannerImageUrl": "https://example.com"
}

{
  "id": 1,
  "slug": "text",
  "name": "text",
  "description": "text",
  "showOnLeaderboard": true,
  "showInDailyService": true,
  "bannerImageUrl": "https://example.com",
  "userCount": 1
}

Delete a category

delete

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

categoryIdinteger · max: 2147483647Required

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

delete

/categories/{categoryId}

HTTPcURLJavaScriptPython

DELETE /api/v2/categories/{categoryId} HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1,
  "slug": "text",
  "name": "text",
  "description": "text",
  "showOnLeaderboard": true,
  "showInDailyService": true,
  "bannerImageUrl": "https://example.com",
  "userCount": 1
}

Get users belonging to a category

get

Path parameters

categoryIdinteger · max: 2147483647Required

Query parameters

limitnumberOptionalDefault: 50

offsetnumberOptionalDefault: 0

searchTextstringOptional

orderBystring · enumOptionalDefault: createdAtPossible values:

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/categories/{categoryId}/users

HTTPcURLJavaScriptPython

GET /api/v2/categories/{categoryId}/users HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "users": [
    {
      "id": 1,
      "profileId": 1,
      "displayName": "text",
      "username": "text",
      "avatarUrl": "https://example.com",
      "description": "text",
      "score": 1,
      "status": "ACTIVE",
      "userkeys": [
        "text"
      ],
      "xpTotal": 1,
      "xpStreakDays": 1,
      "xpRemovedDueToAbuse": true,
      "influenceFactor": 1,
      "influenceFactorPercentile": 1,
      "mommyPawnshopBingo": "REQUESTED",
      "links": {
        "profile": "https://example.com",
        "scoreBreakdown": "https://example.com"
      },
      "stats": {
        "review": {
          "received": {
            "negative": 1,
            "neutral": 1,
            "positive": 1
          }
        },
        "vouch": {
          "given": {
            "amountWeiTotal": 1,
            "count": 1
          },
          "received": {
            "amountWeiTotal": 1,
            "count": 1
          }
        }
      },
      "addedAt": "text"
    }
  ],
  "total": 1
}

Add users to a category

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

categoryIdinteger · max: 2147483647Required

Body

application/json

userIdsinteger[] · min: 1Required

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/categories/{categoryId}/users

HTTPcURLJavaScriptPython

POST /api/v2/categories/{categoryId}/users HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "userIds": [
    1
  ]
}

{
  "id": 1,
  "slug": "text",
  "name": "text",
  "description": "text",
  "showOnLeaderboard": true,
  "showInDailyService": true,
  "bannerImageUrl": "https://example.com",
  "userCount": 1
}

Remove users from a category

delete

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

categoryIdinteger · max: 2147483647Required

Query parameters

userIdsinteger[] · min: 1Required

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

delete

/categories/{categoryId}/users

HTTPcURLJavaScriptPython

DELETE /api/v2/categories/{categoryId}/users?userIds=1 HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 1,
  "slug": "text",
  "name": "text",
  "description": "text",
  "showOnLeaderboard": true,
  "showInDailyService": true,
  "bannerImageUrl": "https://example.com",
  "userCount": 1
}

Bulk import users to a category via Twitter URLs

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

categoryIdinteger · max: 2147483647Required

Body

application/json

twitterUrlsstring[] · min: 1Required

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/categories/{categoryId}/bulk-import

HTTPcURLJavaScriptPython

POST /api/v2/categories/{categoryId}/bulk-import HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "twitterUrls": [
    "text"
  ]
}

{
  "total": 1,
  "added": 1,
  "alreadyInCategory": 1,
  "notFound": 1,
  "invalid": 1,
  "duplicates": 1,
  "errors": [
    {
      "url": "text",
      "reason": "text"
    }
  ]
}

List requests to join categories

get

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

statusstring · enumOptionalPossible values:

limitnumberOptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/categories/requests

HTTPcURLJavaScriptPython

GET /api/v2/categories/requests HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "requests": [
    {
      "id": 1,
      "name": "text",
      "description": "text",
      "categoryId": 1,
      "requestedBy": {
        "id": 1,
        "displayName": "text",
        "address": "text",
        "avatarUrl": "text"
      },
      "status": "pending",
      "createdAt": "text",
      "reason": "text"
    }
  ],
  "total": 1
}

Update category request status

put

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

requestIdnumberRequired

Body

application/json

categoryIdinteger · max: 2147483647Optional

userIdinteger · max: 2147483647Optional

statusstring · enumRequiredPossible values:

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

put

/categories/requests/{requestId}/status

HTTPcURLJavaScriptPython

PUT /api/v2/categories/requests/{requestId}/status HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "categoryId": 1,
  "userId": 1,
  "status": "approved"
}

{
  "success": true
}