Contributions

Get user contribution history

get

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

durationstringOptionalDefault: 1y

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

/contributions/history

HTTPcURLJavaScriptPython

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

{
  "history": [
    {
      "date": "text",
      "tasks": 1,
      "pending": 1,
      "forgiven": true
    }
  ]
}

Forgive the most recent missed contribution day for a user (admin only)

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

userkeystringRequired

Responses

200

Successful response

application/json

okbooleanRequired

messagestringRequired

forgivenDatestringOptional

updatednumberOptional

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/contributions/{userkey}/forgive

HTTPcURLJavaScriptPython

POST /api/v2/contributions/{userkey}/forgive HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "message": "text",
  "forgivenDate": "text",
  "updated": 1
}

Get the latest missed contribution day for the current user

get

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

datestring · nullableRequired

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

get

/contributions/latest-missed-day

HTTPcURLJavaScriptPython

GET /api/v2/contributions/latest-missed-day HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "date": "text"
}

Forgive the most recent missed contribution day for yourself (costs XP)

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

okbooleanRequired

messagestringRequired

forgivenDatestringOptional

updatednumberOptional

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/contributions/forgive-self

HTTPcURLJavaScriptPython

POST /api/v2/contributions/forgive-self HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "ok": true,
  "message": "text",
  "forgivenDate": "text",
  "updated": 1
}

Get the current dailies for the authenticated user

get

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

get

/contributions/dailies

HTTPcURLJavaScriptPython

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

{
  "bundles": [],
  "listings": {
    "ANY_ADDITIONAL_PROPERTY": {
      "id": 1,
      "userkey": "text",
      "status": "ACTIVE",
      "bannerImageUrl": "https://example.com",
      "isPromoted": true,
      "showArchived": true,
      "description": "text",
      "createdAt": "text",
      "updatedAt": "text",
      "user": {
        "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,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 1,
        "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
            }
          }
        }
      },
      "votes": {
        "bullish": {
          "topVoters": [
            {
              "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,
              "humanVerificationStatus": "REQUESTED",
              "validatorNftCount": 1,
              "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
                  }
                }
              }
            }
          ],
          "total": 1,
          "uniqueVoters": 1
        },
        "bearish": {
          "topVoters": [
            {
              "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,
              "humanVerificationStatus": "REQUESTED",
              "validatorNftCount": 1,
              "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
                  }
                }
              }
            }
          ],
          "total": 1,
          "uniqueVoters": 1
        },
        "all": {
          "total": 1,
          "uniqueVoters": 1
        }
      },
      "categories": [
        {
          "id": 1,
          "name": "text",
          "slug": "text",
          "description": "text"
        }
      ],
      "chains": [
        {
          "id": 1,
          "name": "text",
          "url": "https://example.com",
          "iconUrl": "https://example.com"
        }
      ],
      "commentCount": 1,
      "links": [
        {
          "type": "WEBSITE",
          "url": "https://example.com"
        }
      ]
    }
  },
  "reviews": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "users": {
    "ANY_ADDITIONAL_PROPERTY": {
      "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,
      "humanVerificationStatus": "REQUESTED",
      "validatorNftCount": 1,
      "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
          }
        }
      }
    }
  }
}