> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /folders

> List folders in a profile or retrieve a specific folder.

## List Folders

```
GET /v1/profiles/{profileId}/folders
```

### Request

```bash theme={null}
curl -X GET "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/folders?sort=createdAt&order=desc" \
  -H "x-api-key: your-api-key-here"
```

### Query Parameters

| Parameter | Type   | Default     | Description                                  |
| --------- | ------ | ----------- | -------------------------------------------- |
| `search`  | string |             | Search by folder name                        |
| `sort`    | string | `createdAt` | Sort field: `name`, `createdAt`, `updatedAt` |
| `order`   | string | `desc`      | Sort order: `asc`, `desc`                    |
| `cursor`  | string |             | Pagination cursor                            |
| `limit`   | number | 10          | Items per page (max 100)                     |

### Response

```json theme={null}
{
  "count": 2,
  "nextCursor": null,
  "items": [
    {
      "id": "fld_default001",
      "profileId": "pf_a1b2c3d4",
      "name": "default",
      "isDefault": true,
      "itemsCount": 2,
      "createdAt": "2026-03-15T10:00:00Z",
      "updatedAt": "2026-03-15T10:00:00Z"
    },
    {
      "id": "fld_xyz789",
      "profileId": "pf_a1b2c3d4",
      "name": "Supporting Documents",
      "isDefault": false,
      "itemsCount": 1,
      "createdAt": "2026-03-15T10:30:00Z",
      "updatedAt": "2026-03-15T10:30:00Z"
    }
  ]
}
```

***

## Get Folder by ID

```
GET /v1/folders/{folderId}
```

```bash theme={null}
curl -X GET "http://client-omni-api.argosidentity.com/v1/folders/{folderId}" \
  -H "x-api-key: your-api-key-here"
```

```json theme={null}
{
  "id": "fld_default001",
  "profileId": "pf_a1b2c3d4",
  "name": "default",
  "isDefault": true,
  "itemsCount": 2,
  "items": [
    {
      "id": "item_abc123",
      "type": "file",
      "name": "business_registration.pdf",
      "contentType": "application/pdf",
      "sizeBytes": 245678,
      "createdAt": "2026-03-15T10:10:00Z"
    }
  ],
  "createdAt": "2026-03-15T10:00:00Z",
  "updatedAt": "2026-03-15T10:10:00Z"
}
```

### Error Codes

| Status | Code               | Description      |
| ------ | ------------------ | ---------------- |
| 404    | `FOLDER_NOT_FOUND` | Folder not found |