Beltchecker API

Please contact us on [email protected] to request access to the API


USER

/api/user.php?id=[userid]

FieldTypeDescription
idIntegerProfile ID#
firstnameStringFirst name
lastnameStringLast name
nicknameStringNick name
linkURLProfile URL
imageURLProfile image URL
academyStringAcademy
affiliationStringAffiliation
cityStringCity
countryStringCountry
begantrainingDateFirst started training
beltrankIntegerCurrent belt rank ID**
coloredbeltstripesIntegerStripes on current belt (only below black belt)
beltnameStringName of current belt rank
fullbeltnameStringName of current belt rank including stripes (only below black belt)
votesIntegerVoting points received
votesrequiredIntegerVoting points required for current belt rank
idverifiedBooleanId verified (name and picture verification)
promotionhistoryfilledoutBooleanPromotion history filled out
votesaquiredBooleanRequired voting points for current belt rank acquired
verifiedBooleanProfile fully verified
smoothcompidIntegerSmoothcomp ID
agfidIntegerAmerican Grappling Federation ID
moderatorbadgeBooleanModerators' Badge of Excellence
medalstotalIntegerMedals total
medalsgoldIntegerMedals gold
medalssilverIntegerMedals silver
medalsbronzeIntegerMedals bronze

MATCHES

/api/matches.php?id=[userid]

FieldTypeDescription
matchidIntegerMatch ID
competitionStringCompetition
opponentStringOpponent
resultIntegerResult*
methodStringMethod
dateDateDate
locationStringLocation
divisionStringDivision

MEDALS

/api/medals.php?id=[userid]

FieldTypeDescription
medalidIntegerMatch ID
competitionStringCompetition
resultIntegerMedal***
dateDateDate
locationStringLocation
divisionStringDivision

PROMOTION HISTORY

/api/promotionhistory.php?id=[userid]

FieldTypeDescription
promotionidIntegerPromotion ID
beltrankIntegerBelt rank ID**
stripesIntegerNumber of stripes (only for below black belt)
dateDateDate
promoteridIntegerUser ID of promoter (0 = no promoter profile linked)
promoterStringName of promoter
locationStringLocation
commentStringComment
autopromotionBooleanAutomatic promotion based on time
promoterapprovedBooleanPromotion verified by linked promoter
iscurrentbeltBooleanBelt rank is current (highest) rank

*) RESULT ID

0: Lost
1: Won
2: Draw
3: No contest


**) BELT RANK ID
1: white belt
2: gray belt
3: yellow belt
4: orange belt
5: green belt
6: blue belt
7: purple belt
8: brown belt
9: black belt
10: black belt 1st degree
11: black belt 2nd degree
12: black belt 3rd degree
13: black belt 4th degree
14: black belt 5th degree
15: black belt 6th degree
16: red and black belt 7th degree
17: red and white belt 8th degree
18: red belt 9th degree
19: red belt 10th degree

***) MEDAL ID

1: Gold
2: Silver
3: Bronze