> ## 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.

# GET /users/me/clothing — List clothing in your wardrobe

> Retrieve a paginated list of clothing items in your wardrobe. Supports filtering by category and pagination with limit and offset parameters.

Use these endpoints to retrieve clothing items from a wardrobe. `GET /users/me/clothing` returns all of your items, including private ones. `GET /users/{user_id}/clothing` returns only publicly visible items from another user's wardrobe.

## Endpoints

| Field         | Private list                  | Public list                           |
| ------------- | ----------------------------- | ------------------------------------- |
| Method        | `GET`                         | `GET`                                 |
| Path          | `/users/me/clothing`          | `/users/{user_id}/clothing`           |
| Auth required | Yes — Bearer token            | Yes — Bearer token                    |
| Rate limit    | 5 per minute                  | 5 per minute                          |
| Visibility    | All items (including private) | Public items only (`is_public: true`) |

## Query parameters

<ParamField query="limit" type="integer" default="50">
  Maximum number of clothing items to return per page.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of items to skip before returning results. Use with `limit` for pagination.
</ParamField>

<ParamField query="category" type="string">
  Filter results to a specific category. Accepted values: `JACKET`, `TOP`, `BOTTOM`, `FOOTWEAR`.
</ParamField>

## Response fields

**Status: 200 OK**

<ResponseField name="limit" type="integer" required>
  The `limit` value used for this page of results.
</ResponseField>

<ResponseField name="offset" type="integer" required>
  The `offset` value used for this page of results.
</ResponseField>

<ResponseField name="clothing" type="array" required>
  Array of clothing objects.

  <Expandable title="Clothing object properties">
    <ResponseField name="clothing_id" type="string" required>
      Unique identifier for the clothing item.
    </ResponseField>

    <ResponseField name="name" type="string" required>
      Display name of the item.
    </ResponseField>

    <ResponseField name="category" type="string" required>
      Category of the item. One of: `JACKET`, `TOP`, `BOTTOM`, `FOOTWEAR`.
    </ResponseField>

    <ResponseField name="color" type="string" required>
      Color of the item.
    </ResponseField>

    <ResponseField name="is_public" type="boolean" required>
      Whether the item is visible to other users.
    </ResponseField>

    <ResponseField name="user_id" type="string" required>
      ID of the user who owns the item.
    </ResponseField>

    <ResponseField name="image_id" type="string" required>
      ID of the associated image.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      ISO 8601 timestamp of when the item was created.
    </ResponseField>

    <ResponseField name="seasons" type="array">
      Seasons the item is suited for. Possible values: `Spring`, `Summer`, `Autumn`, `Winter`.
    </ResponseField>

    <ResponseField name="tags" type="array">
      Style tags applied to the item. Possible values: `Casual`, `Formal`, `Sports`, `Vintage`.
    </ResponseField>

    <ResponseField name="description" type="string">
      Optional free-text description of the item.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash cURL theme={null}
curl --request GET \
  --url "https://api.drssed.com/users/me/clothing?limit=10&offset=0" \
  --header "Authorization: Bearer <token>"
```

```json Response theme={null}
{
  "limit": 10,
  "offset": 0,
  "clothing": [
    {
      "clothing_id": "clth_a1b2c3d4e5f6",
      "name": "White Oxford Shirt",
      "category": "TOP",
      "color": "White",
      "is_public": true,
      "user_id": "usr_9z8y7x6w",
      "image_id": "img_f1e2d3c4",
      "created_at": "2025-03-14T10:22:00+00:00",
      "seasons": ["Spring", "Summer"],
      "tags": ["Formal", "Casual"],
      "description": "Classic slim-fit Oxford button-down."
    }
  ]
}
```