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

string

required

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

Query parameters

integer

default:"50"

Maximum number of outfits to return per page.

integer

default:"0"

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

Response fields

Status: 200 OK

integer

required

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

integer

required

The limit value used for this response.

integer

required

The offset value used for this response.

object[]

required

Array of outfit objects.

Show Outfit object properties

string

required

Unique identifier for the outfit.

string

required

ID of the user who owns this outfit.

string

required

Display name of the outfit.

string

Optional description of the outfit.

boolean

required

Whether the outfit is visible to other users.

boolean

required

Whether the outfit has been marked as a favorite.

string[]

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

string[]

Style tags applied to the outfit. Possible values: Casual, Formal, Sports, Vintage, Outdoor, Party, Work, Beach.

object[]

Array of CanvasPlacement objects describing the outfit layout. See Create outfit for the full field reference.

string

required

ISO 8601 timestamp of when the outfit was created.

string

required

ISO 8601 timestamp of when the outfit was last updated.

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