Allo

Lister les vues

Renvoie les vues que vous pouvez voir : vos vues privées et les vues partagées de votre équipe.

GET/v2/api/crm/views

Renvoie les vues que vous pouvez voir : vos vues privées et les vues partagées de votre équipe.

Paramètres de requête

ParamètreTypeDéfautDescription
pageinteger1Numéro de page, à partir de 1
sizeinteger20Éléments par page, de 1 à 100

Voir Pagination.

{
  "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"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "total_count": 1,
    "total_pages": 1,
    "has_more": false
  }
}

Erreurs

StatutCodeQuand
400INVALID_PAGE_SIZEpage est inférieur à 1 ou size n'est pas compris entre 1 et 100. param vaut size
403API_KEY_INSUFFICIENT_SCOPELa clé n'a pas le scope CRM_READ

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Paramètres de requête

pageinteger

Page number (1-indexed)

sizeinteger

Results per page

Réponses

200List of views
dataobject[]
9 champs
idstring

Public ID of the view

namestring
filtersobject[]
3 champs
fieldstringrequis

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>requis

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

valuestringrequis

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 champs
fieldstringrequis

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>requis

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
paginationobject
5 champs
pageinteger
sizeinteger
total_countinteger
total_pagesinteger
has_moreboolean
400
401
403
429