List available views

GET

api

objects

{objectType}

views

List available views

curl --request GET \
  --url https://app.useitem.io/api/objects/{objectType}/views \
  --header 'x-api-key: <api-key>'

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Active Customers",
      "view_type": "table",
      "columns": [
        "name",
        "email",
        "industry",
        "custom_score"
      ]
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "By Stage",
      "view_type": "kanban",
      "columns": [
        "name",
        "stage",
        "value"
      ]
    }
  ]
}

Authorizations

x-api-key

string

header

required

Your organization's API key (starts with sk_live_)

Path Parameters

objectType

string

required

The object type slug. Use contacts for People, companies for Companies, or the slug of a Custom Object (e.g., deals, tickets).

Singular forms (contact, company) are also accepted.

Response

List of shared views

data

object[]

Show child attributes

Execute a viewExecutes a shared view and returns paginated results. The view's filters, sorting, and column configuration are applied automatically. This is the recommended way to pull structured data from item — configure the view in the UI with the exact filters you need, then call this endpoint on a schedule.

List available views

curl --request GET \
  --url https://app.useitem.io/api/objects/{objectType}/views \
  --header 'x-api-key: <api-key>'

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Active Customers",
      "view_type": "table",
      "columns": [
        "name",
        "email",
        "industry",
        "custom_score"
      ]
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "By Stage",
      "view_type": "kanban",
      "columns": [
        "name",
        "stage",
        "value"
      ]
    }
  ]
}