Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.drssed.app/llms.txt

Use this file to discover all available pages before exploring further.

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

GET /users/me/outfits

Returns all outfits belonging to the authenticated user, including private ones.
FieldValue
MethodGET
Path/users/me/outfits
Auth requiredYes (Bearer token)
Rate limit5 per minute

GET /users//outfits

Returns only the public outfits for a given user.
FieldValue
MethodGET
Path/users/{user_id}/outfits
Auth requiredYes (Bearer token)
Rate limit5 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.

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"
    }
  ]
}