GET /users/me/outfits

The Drssed API exposes two endpoints for listing outfits. Use GET /users/me/outfits to retrieve all of your own outfits — both public and private. Use GET /users/{user_id}/outfits to browse another user’s outfits, which only returns outfits they have marked as public. Both endpoints return paginated results.

Endpoints

Returns all outfits belonging to the authenticated user, including private ones.

Field	Value
Method	`GET`
Path	`/users/me/outfits`
Auth required	Yes (Bearer token)
Rate limit	5 per minute

GET /users//outfits

Returns only the public outfits for a given user.

Field	Value
Method	`GET`
Path	`/users/{user_id}/outfits`
Auth required	Yes (Bearer token)
Rate limit	5 per minute

Path parameters

user_id

string

required

The ID of the user whose public outfits you want to retrieve. Only applies to GET /users/{user_id}/outfits.

Query parameters

limit

integer

default:"50"

Maximum number of outfits to return per page.

offset

integer

default:"0"

Number of outfits to skip before returning results. Use together with limit to paginate through results.

Response fields

Status: 200 OK

total

integer

required

Total number of outfits matching the query, regardless of pagination.

limit

integer

required

The limit value used for this response.

offset

integer

required

The offset value used for this response.

outfits

object[]

required

Array of outfit objects.

Show Outfit object properties

outfit_id

string

required

Unique identifier for the outfit.

user_id

string

required

ID of the user who owns this outfit.

name

string

required

Display name of the outfit.

description

string

Optional description of the outfit.

is_public

boolean

required

Whether the outfit is visible to other users.

is_favorite

boolean

required

Whether the outfit has been marked as a favorite.

seasons

string[]

Seasons the outfit is suitable for. Possible values: Spring, Summer, Autumn, Winter.

Example

cURL

curl --request GET \
  --url https://api.drssed.com/users/me/outfits?limit=2&offset=0 \
  --header 'Authorization: Bearer <token>'

Response

{
  "total": 42,
  "limit": 2,
  "offset": 0,
  "outfits": [
    {
      "outfit_id": "otf_abc123",
      "user_id": "usr_xyz789",
      "name": "Summer Casual",
      "description": "Light and breezy for warm days.",
      "is_public": true,
      "is_favorite": false,
      "seasons": ["Summer"],
      "tags": ["Casual", "Beach"],
      "scene": [
        {
          "clothing_id": "clth_001",
          "x": 0.5,
          "y": 0.2,
          "z": 1,
          "scale": 1.0,
          "rotation": 0.0
        }
      ],
      "created_at": "2024-06-01T10:00:00+00:00",
      "updated_at": "2024-06-15T08:30:00+00:00"
    },
    {
      "outfit_id": "otf_def456",
      "user_id": "usr_xyz789",
      "name": "Office Monday",
      "description": null,
      "is_public": false,
      "is_favorite": true,
      "seasons": ["Autumn", "Winter"],
      "tags": ["Work", "Formal"],
      "scene": [],
      "created_at": "2024-09-10T09:15:00+00:00",
      "updated_at": "2024-09-10T09:15:00+00:00"
    }
  ]
}

Auth

Wardrobe

Outfits

Images

Sync

Account

GET /users/me/outfits — List outfits in your wardrobe

Endpoints