Skip to main content
GET
/
v1
/
public
/
items
/
{item_id}
Get item by ID
curl --request GET \
  --url https://api.poelis.com/v1/public/items/{item_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "readable_id": "<string>",
  "product_id": "<string>",
  "name": "<string>",
  "deleted": true,
  "parent_item_id": "<string>",
  "draft_item_id": "<string>",
  "createdBy": {
    "id": "auth0|550e8400-e29b-41d4-a716-446655440000",
    "imageUrl": "https://example.com/avatar.png",
    "userName": "Jane Doe"
  },
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "updatedBy": {
    "id": "auth0|550e8400-e29b-41d4-a716-446655440000",
    "imageUrl": "https://example.com/avatar.png",
    "userName": "Jane Doe"
  }
}

Authorizations

​
Authorization
string
header
required

Enter your API key. Example: Bearer poelis_api_...

Path Parameters

​
item_id
string
required

Query Parameters

​
version
string | null

Product version number (integer) or 'baseline'. Omit or null for draft item.

Example:

null

Response

Complete item details including metadata, relationships, createdBy, updatedBy (id, userName, imageUrl), createdAt, and updatedAt (ISO 8601) when available.

Public representation of an item.

​
id
string
required
​
readable_id
string
required

Human-readable item ID

​
product_id
string
required

Product this item belongs to

​
name
string
required

Item name

​
deleted
boolean
required

Whether the item is deleted

​
parent_item_id
string | null

Parent item ID for hierarchical structure

​
draft_item_id
string | null

Draft item ID if this is a versioned item

​
createdBy
PublicUser · object

User who created the item

Example:
{
  "id": "auth0|550e8400-e29b-41d4-a716-446655440000",
  "imageUrl": "https://example.com/avatar.png",
  "userName": "Jane Doe"
}
​
createdAt
string | null

ISO 8601 creation timestamp

​
updatedAt
string | null

ISO 8601 last-update timestamp

​
updatedBy
PublicUser · object

User who last updated the item

Example:
{
  "id": "auth0|550e8400-e29b-41d4-a716-446655440000",
  "imageUrl": "https://example.com/avatar.png",
  "userName": "Jane Doe"
}