Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Vouches

Query vouches with optional filters

post

⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Body
idsnumber[]Optional
subjectUserkeysstring[]Optional
authorProfileIdsinteger[]Optional
subjectProfileIdsinteger[]Optional
subjectAddressesstring[]Optional

Ethereum address (0x-prefixed, 20 bytes)

subjectAttestationHashesstring[]Optional

0x-prefixed 32-byte hex string (bytes32)

archivedbooleanOptional
afterDatestringOptional
durationstringOptional
limitinteger · max: 100OptionalDefault: 50
offsetinteger · max: 2147483647OptionalDefault: 0
Responses
200

Successful response

application/json
totalnumberRequired
limitnumberRequired
offsetnumberRequired
post/vouches
POST /api/v2/vouches HTTP/1.1
Host: api.ethos.network
Content-Type: application/json
Accept: */*
Content-Length: 288

{
  "ids": [
    1
  ],
  "subjectUserkeys": [
    "text"
  ],
  "authorProfileIds": [
    1
  ],
  "subjectProfileIds": [
    1
  ],
  "subjectAddresses": [
    "text"
  ],
  "subjectAttestationHashes": [
    "text"
  ],
  "archived": true,
  "afterDate": "text",
  "orderBy": {
    "balance": "asc",
    "vouchedAt": "asc",
    "updatedAt": "asc"
  },
  "duration": "text",
  "limit": 50,
  "offset": 0
}
{
  "values": [
    {
      "authorProfileId": 1,
      "subjectProfileId": 1,
      "authorUser": {
        "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
            }
          },
          "vouchTotals": [
            {
              "balance": {
                "given": 1,
                "received": 1
              },
              "count": {
                "given": 1,
                "received": 1
              },
              "token": {
                "address": "text",
                "decimals": 1,
                "id": "text"
              }
            }
          ]
        }
      },
      "subjectUser": {
        "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
            }
          },
          "vouchTotals": [
            {
              "balance": {
                "given": 1,
                "received": 1
              },
              "count": {
                "given": 1,
                "received": 1
              },
              "token": {
                "address": "text",
                "decimals": 1,
                "id": "text"
              }
            }
          ]
        }
      },
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Get every subject userkey a profile actively vouches for

get

Unpaginated, and version-erased — one set, never one per version — bounded by how many vouches one person has authored. Each subject is expanded to all of its userkeys, so a caller can test membership against a user’s full key list. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Query parameters
profileIdinteger · max: 2147483647Required
Responses
200

Successful response

application/json
get/vouches/authored-subject-userkeys
GET /api/v2/vouches/authored-subject-userkeys?profileId=1 HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "userkeys": []
}

Get the profiles holding an active vouch toward a profile

get

Unpaginated, and version-erased — one set of authors, never one per version. Authors without an Ethos profile are omitted. > ⚠️ Warning: This is a beta endpoint. It is not guaranteed to be stable and may change or break without notice.

Query parameters
profileIdinteger · max: 2147483647Required
Responses
200

Successful response

application/json
authorProfileIdsinteger[]Required
get/vouches/incoming-author-profile-ids
GET /api/v2/vouches/incoming-author-profile-ids?profileId=1 HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "authorProfileIds": [
    1
  ]
}

Get mutual vouchers for a viewer and target profile

get
Query parameters
viewerProfileIdinteger · max: 2147483647Required
targetProfileIdinteger · max: 2147483647Required
limitinteger · max: 50OptionalDefault: 50
offsetinteger · max: 2147483647OptionalDefault: 0
Responses
200

Successful response

application/json
totalnumberRequired
limitnumberRequired
offsetnumberRequired
get/vouches/mutual-vouchers
GET /api/v2/vouches/mutual-vouchers?viewerProfileId=1&targetProfileId=1 HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "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
          }
        },
        "vouchTotals": [
          {
            "balance": {
              "given": 1,
              "received": 1
            },
            "count": {
              "given": 1,
              "received": 1
            },
            "token": {
              "address": "text",
              "decimals": 1,
              "id": "text"
            }
          }
        ]
      }
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Get vouch creation fees

get
Responses
200

Successful response

application/json
entryDonationFeeBasisPointsinteger · int64Required
entryProtocolFeeBasisPointsinteger · int64Required
entryVouchersPoolFeeBasisPointsinteger · int64Required
exitFeeBasisPointsinteger · int64Required
get/vouches/fees
GET /api/v2/vouches/fees HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "entryDonationFeeBasisPoints": 1,
  "entryProtocolFeeBasisPoints": 1,
  "entryVouchersPoolFeeBasisPoints": 1,
  "exitFeeBasisPoints": 1
}
PreviousVotesNextWallets

Last updated