> ## 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 /items

> Liste items de una carpeta o recupere un item específico.

## Listar items de una carpeta

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

### Solicitud

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

### Query Parameters

| Parameter | Type   | Default     | Descripción                                      |
| --------- | ------ | ----------- | ------------------------------------------------ |
| `type`    | string |             | Filtrar por tipo de item: `file`, `text`, `json` |
| `search`  | string |             | Buscar por nombre de item                        |
| `sort`    | string | `createdAt` | Campo de ordenación: `name`, `type`, `createdAt` |
| `order`   | string | `desc`      | Orden: `asc`, `desc`                             |

### Respuesta

```json theme={null}
{
  "count": 2,
  "items": [
    {
      "id": "item_abc123",
      "folderId": "fld_default001",
      "type": "file",
      "name": "business_registration.pdf",
      "content": null,
      "contentType": "application/pdf",
      "sizeBytes": 245678,
      "url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
      "detected": {
        "contentType": "application/pdf",
        "extension": "pdf",
        "fileCategory": "document"
      },
      "metadata": {
        "documentType": "business_registration"
      },
      "status": "ACTIVE",
      "processedAt": "2026-03-15T10:10:05Z",
      "createdAt": "2026-03-15T10:10:00Z",
      "rag": "사업자등록증\n상호: 주식회사 아크미..."
    }
  ]
}
```

<ResponseField name="items[].contentType" type="string | null">
  Tipo MIME (solo para items de tipo file)
</ResponseField>

<ResponseField name="items[].sizeBytes" type="number | null">
  Tamaño del archivo en bytes (solo para items de tipo file)
</ResponseField>

<ResponseField name="items[].url" type="string | null">
  URL del texto extraído (para search/RAG)
</ResponseField>

<ResponseField name="items[].detected" type="object | null">
  Información del archivo detectada automáticamente: `contentType`, `extension`, `fileCategory`
</ResponseField>

<ResponseField name="items[].rag" type="string | null">
  Texto extraído y refinado por OCR (`null` durante el procesamiento)
</ResponseField>

***

## Obtener item por ID

```
GET /v1/items/{itemId}
```

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

```json theme={null}
{
  "id": "item_abc123",
  "folderId": "fld_default001",
  "type": "file",
  "name": "business_registration.pdf",
  "content": null,
  "contentType": "application/pdf",
  "sizeBytes": 245678,
  "url": "https://omni-kb-documents.s3.us-east-1.amazonaws.com/.../extracted.txt",
  "detected": {
    "contentType": "application/pdf",
    "extension": "pdf",
    "fileCategory": "document"
  },
  "metadata": {
    "documentType": "business_registration"
  },
  "status": "ACTIVE",
  "processedAt": "2026-03-15T10:10:05Z",
  "folder": {
    "id": "fld_default001",
    "name": "default"
  },
  "createdAt": "2026-03-15T10:10:00Z",
  "rag": "사업자등록증\n상호: 주식회사 아크미..."
}
```

<Note>
  El objeto `folder` solo se incluye en la respuesta de detalle del item, no en la respuesta de lista.
</Note>

### Códigos de error

| Status | Code             | Descripción        |
| ------ | ---------------- | ------------------ |
| 404    | `ITEM_NOT_FOUND` | Item no encontrado |