FOfolk
Views

Get a view

Changed on

Retrieve a view of a group the user can access, or one of their personal views.

get/v1/views/{viewId}

Request

  • Base URL
    https://api.folk.app
  • URL
    https://api.folk.app/v1/views/{viewId}
  • Auth
    HTTP bearer

Path parameters

viewIdstring required

The ID of the view to retrieve.

Response

The retrieved view, with its settings.

deprecationsstring[]

Example response

{
  "data": {
    "id": "viw_3f1c9a2e-0386-434d-82d7-a91eb6badd71",
    "groupId": "grp_92ab3f1c-0386-434d-82d7-a91eb6badd71",
    "name": "Hot leads",
    "entityType": "person",
    "filter": {
      "combinator": "and",
      "conditions": [
        {
          "field": "interactionMetadata.workspace.lastInteractedAt",
          "operator": "gt",
          "value": "30-days-ago"
        }
      ]
    },
    "visibleFields": [
      "jobTitle",
      "companies",
      "emails"
    ],
    "position": {
      "after": "viw_1b2c3d4e-0386-434d-82d7-a91eb6badd71"
    },
    "createdAt": "2025-07-17T09:00:00.000Z",
    "createdBy": {
      "id": "usr_bc984b3f-0386-434d-82d7-a91eb6badd71",
      "fullName": "John Doe",
      "email": "john.doe@example.com"
    },
    "type": "table",
    "sort": {
      "field": "interactionMetadata.user.lastInteractedAt",
      "direction": "desc"
    }
  },
  "deprecations": [
    "This field is deprecated"
  ]
}

Changes