# Request Item information

`GET /api/items/{id}`



- **Group:** Items
- **Since:** v0.1.0
- **Authentication:** `authtoken` header, created under Setup > API > API Management
- **HTML version:** /apiguide/items/get-item/

## Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `authtoken` | String | **required** | Authentication token, generated from admin area |

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | Number | optional | Optional Item unique ID. If not provided, returns all items |

## Example request

```bash
curl -X GET "https://yoursite.com/api/items/123" \
  -H "authtoken: YOUR_API_TOKEN"
```

## Success response

### Success-Response (Single Item):

```json
    HTTP/1.1 200 OK
    {
	      "id": "1",
       "description": "JBL Soundbar",
       "long_description": "The JBL Cinema SB110 is a hassle-free soundbar",
       "rate": "100.00",
       "tax": 1,
       "tax2": 2,
       "unit": "pcs",
       "group_id": 0
    }
```

### Success-Response (All Items with Pagination):

```json
HTTP/1.1 200 OK
{
  "data": [{...}, {...}],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 137,
    "last_page": 7
  }
}
```

## Error responses

### Error-Response:

```json
HTTP/1.1 404 Not Found
{
  "status": false,
  "message": "No data were found"
}
```

---

Perfex CRM REST API by Themesic Interactive. Full reference: /apiguide/