GET /outfits/{outfit_id} — Retrieve a full outfit object

Call GET /outfits/{outfit_id} to fetch a single outfit in full detail. The response includes the complete canvas scene — every CanvasPlacement object with its coordinates, layer order, scale, and rotation — along with all metadata such as tags and seasons. You can retrieve any outfit you own, or any outfit that another user has made public.

Endpoint

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

Path parameters

string

required

The ID of the outfit to retrieve.

Response fields

Status: 200 OK

object

required

The requested outfit object.

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 is 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 layout of the outfit.

Show CanvasPlacement properties

string

required

ID of the clothing item placed on the canvas.

number

required

Horizontal position of the item on the canvas.

number

required

Vertical position of the item on the canvas.

integer

required

Layer order. Higher values appear on top.

number

required

Size multiplier relative to the item’s default size.

number

required

Rotation of the item in degrees.

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/outfits/otf_abc123 \
  --header 'Authorization: Bearer <token>'

Response

{
  "outfit": {
    "outfit_id": "otf_abc123",
    "user_id": "usr_xyz789",
    "name": "Weekend Brunch",
    "description": "Relaxed but put-together.",
    "is_public": true,
    "is_favorite": false,
    "seasons": ["Spring", "Summer"],
    "tags": ["Casual"],
    "scene": [
      {
        "clothing_id": "clth_shirt_001",
        "x": 0.5,
        "y": 0.3,
        "z": 2,
        "scale": 1.0,
        "rotation": 0.0
      },
      {
        "clothing_id": "clth_pants_002",
        "x": 0.5,
        "y": 0.7,
        "z": 1,
        "scale": 1.0,
        "rotation": 0.0
      }
    ],
    "created_at": "2024-06-20T14:00:00+00:00",
    "updated_at": "2024-06-20T14:00:00+00:00"
  }
}

Auth

Wardrobe

Outfits

Images

Sync

Account

GET /outfits/{outfit_id} — Retrieve a full outfit object

Endpoint

Path parameters

Response fields

Example

​Endpoint

​Path parameters

​Response fields

​Example

Endpoint

Path parameters

Response fields

Example