List member statuses for member
Returns member statuses for member accessible to the API key’s account.
GET
/api/v1/members/{memberId}/statusesmemberStatuses: read1,000 requests/minute/key · all plansActive API keys: Free 1, Pro 5, Pro+ 5. The request rate is the same on every plan.
Parameters
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
memberId | string (uuid) | Required | Identifier of the member. |
Response schema
200
Successful response.
| Name | Type | Required | Description |
|---|---|---|---|
assignmentId | string | Required | Assignment Id. |
definitionId | string | Required | Definition Id. |
name | string | Required | Name of the resource. |
description | string | Optional | Description of the resource. |
icon | string | Required | Icon. |
iconType | string | Required | Icon Type. Allowed values: "custom", "emoji", "lucide". |
iconUrl | null | string | Optional | Icon Url. Pre-resolved custom icon URL, owner-scoped. Set by friend-facing resolvers (the viewer's own `customIcons.list` query is scoped to the viewer, not the profile owner, so it can never resolve another account's custom icon). |
colour | string | Optional | Colour. |
avatarRingShape | string | Optional | Avatar Ring Shape. Allowed values: "moon", "circle", "square", "hexagon", "octagon", "star", "pentagon", "heart", "shield", "sakura", "neko", "butterfly", "sparkle", "crown". |
targetKind | string | Required | Target Kind. Allowed values: "member", "active_front", "account". |
Errors
400· JSON errorMissing member id.
401· JSON errorMissing or invalid API key. Use Authorization: Bearer <token>.
403· JSON errorRequires memberStatuses: read; ownership or feature restrictions may also deny access.
429· JSON errorAPI rate limit exceeded (1000 requests per minute). Retry shortly.
Request example
Set FLORALITY_KEY in your environment. These examples use demo identifiers.
curl --request GET 'https://floralitys.com/api/v1/members/11111111-1111-4111-8111-111111111111/statuses' \
--header "Authorization: Bearer $FLORALITY_KEY"Responses
Successful response.
[
{
"assignmentId": "11111111-1111-4111-8111-111111111111",
"definitionId": "11111111-1111-4111-8111-111111111111",
"name": "River",
"description": "A note from our demo system.",
"icon": "demo",
"iconType": "custom",
"iconUrl": null,
"colour": "#70846b",
"avatarRingShape": "moon",
"targetKind": "member"
}
]Example values are illustrative demo data.