ITitem
Objects

List objects or fetch by ID

List mode (no id or email param): Returns a paginated list of objects with optional search, filtering, and sorting.

Single-object mode (with id or email): Returns a single object by ID or email lookup.

get/api/objects/{objectType}

Request

  • Base URL
    https://app.useitem.io
  • Auth
    API key in header x-api-key

Query parameters

idinteger

Fetch a single object by ID. When provided, returns one object instead of a list.

emailstring

Fetch a contact by email (contacts only). When provided, returns one object.

limitinteger

Maximum records to return (list mode only). Default: 50, max: 200.

offsetinteger

Number of records to skip for pagination (list mode only).

searchstring

Text search on name (and email for contacts).

sort_bystring

Field to sort by. Default: created_at.

sort_order'asc' | 'desc'

Sort direction. Default: desc.

filter[{field_name}]string

Filter by field value (case-insensitive partial match). Works with both system fields and custom fields.

Example: filter[industry]=Technology

include_all_fieldsboolean

Include all system fields in the response (single-object mode only).

include_summaryboolean

Include the AI-generated summary (contacts and companies only, single-object mode).

Response

Success

OR

Example response

{
  "data": [
    {
      "id": 123,
      "name": "Alex Johnson",
      "email": "alex@acme.com"
    }
  ],
  "pagination": {
    "total": 150,
    "limit": 50,
    "has_more": true
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.