> ## Documentation Index > Fetch the complete documentation index at: https://docs.claap.io/llms.txt > Use this file to discover all available pages before exploring further. # List pinned deal views > List the deal views a user has pinned to the tab bar of the deals table, in tab order. Private views the user can access are included. Views the user can no longer access are left out. Lists the deal views a user has pinned to the tab bar of the deals table, in tab order. A user who never changed their tab bar gets the built-in default views. Pinned views follow the same access rules as the Claap application: they include the private views the user can access, and leave out views the user can no longer access. See [pinned views](/api-reference/views#pinned-views). ```bash cURL theme={null} curl --request GET \ --url 'https://api.claap.io/v1/deals/views/pinned?userEmail=jane.doe%40example.com' \ --header 'X-Claap-Key: ' ``` ## OpenAPI ````yaml GET /v1/deals/views/pinned openapi: 3.1.0 info: title: Claap API description: Development documentation version: 0.0.0 servers: - url: https://api.claap.io/ security: - ApiKey: [] paths: /v1/deals/views/pinned: get: description: >- List the deal views a user has pinned to the tab bar of the deals table, in tab order. Private views the user can access are included. Views the user can no longer access are left out. operationId: getV1DealsViewsPinned parameters: - in: query name: userEmail schema: type: string format: email description: >- Email address of the user whose pinned views are listed. It must belong to an active workspace member. example: jane.doe@example.com required: true responses: '200': description: Pinned deal views were successfully retrieved content: application/json: schema: type: object properties: result: type: array items: $ref: '#/components/schemas/DealView' required: - result example: result: - viewId: Vw3Hc9Lt5Kd1Qp7Zm2Rf6 name: Enterprise pipeline visibility: Public icon: ':rocket:' isDefault: false ownerId: Xk2Rd7Mv4Bn9Ts1Lq6Wf3 columns: - type: Default columnId: Title isHidden: false - type: Default columnId: Stage isHidden: false - type: Default columnId: Amount isHidden: false width: 160 filters: statusIn: - Open typeIn: - newbusiness sort: - field: AmountValue order: Desc - viewId: Default_MyDeals name: My deals visibility: Public icon: ':bust_in_silhouette:' isDefault: true ownerId: '#global' columns: - type: Default columnId: Title isHidden: false - type: Default columnId: OwnerName isHidden: false - type: Default columnId: Stage isHidden: false filters: ownerEmailIn: - type: Me sort: - field: LastInteraction order: Desc - viewId: Qz8Td2Gm6Wp4Yc1Bn7Kx3 name: My deals at risk visibility: Private isDefault: false ownerId: Xk2Rd7Mv4Bn9Ts1Lq6Wf3 columns: - type: Default columnId: Title isHidden: false - type: Default columnId: AiStatus isHidden: false filters: aiStatusIn: - AtRisk ownerEmailIn: - type: Email email: jane.doe@example.com sort: - field: LastInteraction order: Desc '400': description: '`userEmail` is not the email address of an active workspace member.' components: schemas: DealView: type: object properties: viewId: type: string description: The view identifier. name: type: string description: The view name. visibility: type: string enum: - Public - Private description: >- The view visibility. `Private` views are only returned by the pinned views endpoints; the other endpoints only access `Public` views. icon: type: string description: The view icon. isDefault: type: boolean description: >- Whether the view is a built-in default view. Default views cannot be updated or deleted. ownerId: type: string description: >- Claap user identifier of the view owner, or `#global` for built-in default views. columns: type: array items: $ref: '#/components/schemas/DealViewColumn' description: The columns of the deals table. filters: $ref: '#/components/schemas/DealViewFilters' sort: type: array items: $ref: '#/components/schemas/DealViewSortDimension' description: The sort order of the deals table. required: - viewId - name - visibility - isDefault - ownerId - columns - filters - sort description: A saved view of the deals table. DealViewColumn: oneOf: - type: object properties: type: type: string enum: - Default description: Discriminates default columns from AI section columns. columnId: type: string description: The built-in column identifier. isHidden: type: boolean description: Whether the column is hidden in the table. default: false width: type: number description: The column width, in pixels. required: - type - columnId description: A built-in deal column. - type: object properties: type: type: string enum: - AiSection description: Discriminates AI section columns from default columns. fieldId: type: string description: >- Identifier of the AI field (aka insight) displayed in the column. title: type: string description: The column title. hasAutogen: type: boolean description: Whether the insight is automatically generated for new deals. isConfigured: type: boolean description: Whether the section configuration is complete. isHidden: type: boolean description: Whether the column is hidden in the table. default: false width: type: number description: The column width, in pixels. required: - type - fieldId - title description: A column displaying an AI insight for each deal. description: >- A column of the deals table, either a built-in column (`Default`) or an AI insight column (`AiSection`). DealViewFilters: type: object properties: aiStatusIn: type: array items: type: string enum: - Active - AtRisk - Lost - NeedsAction - OnTrack - Stalled - Won description: Only include deals with one of these AI statuses. default: [] aiStatusNotIn: type: array items: type: string enum: - Active - AtRisk - Lost - NeedsAction - OnTrack - Stalled - Won description: Exclude deals with one of these AI statuses. default: [] amountCurrencyIn: type: array items: type: string description: Only include deals whose amount uses one of these currencies. default: [] amountCurrencyNotIn: type: array items: type: string description: Exclude deals whose amount uses one of these currencies. default: [] amountValue: $ref: '#/components/schemas/ViewNumericFilter' description: Filter on the deal amount. closedAfterRelative: type: number description: >- Only include deals closed after this number of days in the past. For instance 30 keeps deals closed within the last 30 days. closedBeforeRelative: type: number description: Only include deals closed before this number of days in the past. companyIdIn: type: array items: type: string description: Only include deals linked to one of these CRM company identifiers. default: [] companyIdNotIn: type: array items: type: string description: Exclude deals linked to one of these CRM company identifiers. default: [] contactIdIn: type: array items: type: string description: Only include deals linked to one of these CRM contact identifiers. default: [] dealAgeRange: type: string enum: - ZeroDay - OneDay - LessThan7Days - LessThan15Days - LessThan30Days - LessThan90Days - LessThan180Days - MoreThan180Days description: Only include deals whose age falls in this range. hasInteraction: type: boolean description: >- Only include deals with (true) or without (false) at least one interaction. openedAfterRelative: type: number description: Only include deals opened after this number of days in the past. openedBeforeRelative: type: number description: Only include deals opened before this number of days in the past. ownerEmailIn: type: array items: $ref: '#/components/schemas/ViewEmailFilter' description: Only include deals whose owner matches one of these entries. default: [] ownerEmailNotIn: type: array items: $ref: '#/components/schemas/ViewEmailFilter' description: Exclude deals whose owner matches one of these entries. default: [] pipelineIdIn: type: array items: type: string description: Only include deals belonging to one of these pipelines. default: [] pipelineIdNotIn: type: array items: type: string description: Exclude deals belonging to one of these pipelines. default: [] stageIn: type: array items: type: string description: Only include deals in one of these stages. default: [] stageNotIn: type: array items: type: string description: Exclude deals in one of these stages. default: [] statusIn: type: array items: type: string enum: - Lost - Open - Won description: Only include deals with one of these statuses. default: [] statusNotIn: type: array items: type: string enum: - Lost - Open - Won description: Exclude deals with one of these statuses. default: [] typeIn: type: array items: type: string description: Only include deals with one of these types. default: [] typeNotIn: type: array items: type: string description: Exclude deals with one of these types. default: [] userGroupIn: type: array items: type: string description: Only include deals owned by a member of one of these user groups. default: [] userGroupNotIn: type: array items: type: string description: Exclude deals owned by a member of one of these user groups. default: [] description: >- The filters applied by the view to the deals table. All set filters must match. DealViewSortDimension: type: object properties: field: type: string enum: - AmountCurrency - AmountValue - ClosedAt - CompanyName - ContactName - DealAge - Insight - LastInteraction - OpenedAt - OwnerName - Pipeline - Stage - Status - Title - Type description: The field to sort deals by. insight: type: object properties: fieldId: type: string description: Identifier of the AI field (aka insight) to sort by. required: - fieldId description: Required when `field` is `Insight`, ignored otherwise. order: type: string enum: - Asc - Desc description: The sort direction. required: - field - order description: A sort dimension of the deals table. ViewNumericFilter: type: object properties: exists: type: boolean description: >- Set to true to only match items where the value is set, false to only match items where it is missing. gte: type: number description: Only match values greater than or equal to this number. is: type: number description: Only match values equal to this number. isNot: type: number description: Only match values different from this number. lte: type: number description: Only match values less than or equal to this number. description: >- Filter on a numeric value. Combine `gte` and `lte` for ranges, or use `is`/`isNot` for exact matches. ViewEmailFilter: oneOf: - type: object properties: type: type: string enum: - Email email: type: string description: The email address. required: - type - email description: Matches a specific email address. - type: object properties: type: type: string enum: - Me required: - type description: >- Dynamically matches the user viewing the table in the Claap application. description: >- References either a specific email address or `Me`, which resolves to whoever is viewing the table in the Claap application. securitySchemes: ApiKey: type: apiKey in: header name: X-Claap-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.