Allo

Get view

Returns one saved view by ID. Returns 404 VIEW NOT FOUND for another user's private view.

GET/v2/api/crm/views/{id}

Returns the view with this ID. See the view object.

{
  "data": {
    "id": "cvw_2abc",
    "name": "Hot leads",
    "filters": [
      {
        "field": "company",
        "operator": "CONTAINS",
        "value": "Acme"
      }
    ],
    "sort": [
      {
        "field": "created_at",
        "order": "desc"
      }
    ],
    "owner_type": "USER",
    "user_id": "usr_2abc",
    "team_id": null,
    "created_at": "2026-10-23T10:00:00",
    "updated_at": "2026-10-23T10:00:00"
  }
}

Errors

StatusCodeWhen
403API_KEY_INSUFFICIENT_SCOPEThe key does not hold CRM_READ
404VIEW_NOT_FOUNDNo view with this ID, or you cannot see it

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

idstringrequired

Public ID of the view, as returned by the list endpoint

Responses

200The view
dataobject

A saved view: a named filter and sort over people. Views created in the Allo app and with the API are the same objects.

9 fields
idstring

Public ID of the view

namestring
filtersobject[]
3 fields
fieldstringrequired

A built-in person field (name, company, job_title, emails, phone_numbers, website, addresses, created_at, updated_at, last_activity, activity_history, sms_content (only when the team has SMS)) or the key of a custom field from GET /v2/api/crm/attributes. An unknown field returns 400 INVALID_FILTER_FIELD

operatorenum<string>required

Comparison operator. It must match the type of the field, otherwise the request returns 400 INVALID_FILTER_OPERATOR

ISIS_NOTCONTAINSNOT_CONTAINSEMPTYNOT_EMPTYSTARTS_WITHENDS_WITHBEFOREAFTERDATE_EQUALSGREATER_THANGREATER_THAN_OR_EQUALLESS_THANLESS_THAN_OR_EQUALHAS

valuestringrequired

Value to compare to. It must be readable for the type of the field, otherwise the request returns 400 INVALID_FILTER_VALUE: numeric for a number field, an ISO 8601 date such as 2026-01-31 or date-time such as 2026-01-31T00:00:00Z for a date field. Ignored for EMPTY and NOT_EMPTY

sortobject[]
2 fields
fieldstringrequired

A sortable built-in person field (name, company, job_title, website, created_at, updated_at, last_activity) or the key of a sortable custom field from GET /v2/api/crm/attributes

orderenum<string>required

ascdesc

owner_typeenum<string>

USER is private to the API key's user. TEAM is shared with the user's team.

USERTEAM

user_idstring | null

ID of the user who owns a USER view

team_idstring | null

ID of the team a TEAM view belongs to

created_atstring
updated_atstring
401
403
404
429