Stack Overflow hub

Stack Overflow User Badges API

Every badge one user has earned, with its rank, type, award count and link.

GET /v1/stack-overflow/users/{memberId}/badges

1 credit Failed requests are free

About this endpoint

GET /v1/stack-overflow/users/{memberId}/badges returns the badges a user has earned. Each row has id, name, rank (bronze, silver or gold), type (named or tag_based), awardCount and url.

Sort by rank (the default), name, type or awarded. Page with page.nextCursor while page.hasMore is true, and check limitReached when a sort other than awarded stops at the ceiling. A user with no badges is found with an empty list; a user id that does not exist is not_found.

Stack Overflow User Badges API FAQ

What does awardCount mean?

awardCount is how many times the user has earned that badge. A tag-based badge can be earned more than once, once per tag.

How many credits does a page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

What is a tag_based badge?

A tag_based badge is earned in one tag, for example a bronze badge for a tag you answer often. Named badges are not tied to a tag.

Can I sort by when a badge was earned?

Use sort=awarded. The default rank sort groups the badges by rank instead.