Stack Overflow

List Stack Overflow user badges

List the badges a Stack Overflow user has earned.

GET/v1/stack-overflow/users/{memberId}/badges
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
6
memberIdintegerrequiredpath

User id on the chosen site, e.g. `22656`. `-1` is the Community user.

≥ -1 · ≤ 2147483647

sitestringoptionalquery

Stack Exchange site, by its API name (`askubuntu`, `serverfault`, `math`, `ru.stackoverflow`). Default: `stackoverflow`. The sites endpoint lists them all.

sortstringoptionalquery

Order: `rank` (default), `name`, `type` or `awarded` (when it was earned). `type` has many ties; pages can repeat or skip a badge. Use `rank`, `name` or `awarded` for a complete walk.

one of: rank, name, type, awarded

orderstringoptionalquery

Direction of the sort: `desc` (default) or `asc`.

one of: desc, asc

limitintegeroptionalquery

Up to this many rows per page, 1 to 100. Default: 30. A page can hold fewer than `limit` rows where rows share a creation second or a block of 100 rows ends. Follow `page.nextCursor` until `hasMore` is false.

≥ 1 · ≤ 100

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters.

min 1 chars · max 1024 chars

Response fields
19

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no user has this id on the site. A user with no badges is `found` with an empty list.

one of: found, not_found

datasite
string

The Stack Exchange site the badges belong to.

datamemberId
integer

The user the badges belong to.

The badges on this page.

databadges[]id
integer

Badge id.

databadges[]name
string

Badge name.

databadges[]rank
stringnullable

`bronze`, `silver` or `gold`.

one of: bronze, silver, gold, null

databadges[]type
stringnullable

`tag_based` badges are earned in one tag.

one of: named, tag_based, null

databadges[]awardCount
integernullable

Times the user has earned the badge.

databadges[]url
stringnullable

Link to the badge page.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datalimitReached
boolean

True when the list stopped at the site's 25-page ceiling (2,500 rows, or 625 when the page carries text), or when a user's answer or comment list is too large for page-offset paging and has served its first 100 rows (25 when it carries text). Sort by `creation` to page deeper. False for every list that ends because it ran out.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/stack-overflow/users/22656/badges" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Badge listing.