> ## Documentation Index > Fetch the complete documentation index at: https://developer.lexful.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Assets > List assets of a specific type with advanced filtering, sorting, and reference expansion ## OpenAPI ````yaml /api/openapi.yaml get /v1/assets/{assetTypeName} openapi: 3.0.3 info: title: Documentation Service API description: API documentation for Documentation Service version: 1.0.0 servers: - url: https://api.us.lexful.app description: US pod security: - bearerAuth: [] accountId: [] paths: /v1/assets/{assetTypeName}: get: tags: - Assets summary: List Assets description: >- List assets of a specific type with advanced filtering, sorting, and reference expansion parameters: - schema: type: string format: uuid in: query name: organization_id required: false description: Filter by organization - schema: type: string in: query name: name required: false description: Filter by asset name - schema: type: string in: query name: search required: false description: Full-text search query - schema: type: boolean in: query name: include_deleted required: false description: 'Include soft-deleted assets in results (default: false)' - schema: type: string in: query name: expand required: false description: >- Comma-separated list of fields to expand (e.g., "tags", "references", "references.referenceName") - schema: type: string in: query name: tags required: false description: Comma-separated tag ids; returns assets carrying ANY of these tags. - schema: type: string in: query name: tag_parent_not required: false description: >- Parent tag id — returns only assets that carry none of the child tags under that parent - schema: type: string in: query name: fields required: false description: >- Comma-separated list of fields to return, or "*" for all fields. Default excludes richtext fields for performance. - schema: type: string in: query name: sort required: false description: Field name to sort by - schema: type: string enum: - ASC - DESC in: query name: order required: false description: Sort order - schema: type: number default: 100 minimum: 1 maximum: 1000 in: query name: limit required: false - schema: type: number default: 0 minimum: 0 in: query name: offset required: false - schema: type: string in: query name: filter required: false description: >- URL-encoded JSON AND/OR filter tree for complex queries. A node is a group `{"and":[...]}` / `{"or":[...]}` or a leaf — a bracket-notation string `"field[operator]=value"` (the same syntax as the flat params above). Composes as an additional AND alongside the bracket-notation filters. Max nesting depth 3, max 50 conditions. - schema: type: string in: path name: assetTypeName required: true description: Asset type name responses: '200': $ref: '#/components/responses/ListAssetsResponse' '400': $ref: '#/components/responses/BadRequestResponse' '403': $ref: '#/components/responses/ForbiddenResponse' '404': $ref: '#/components/responses/NotFoundResponse' '500': $ref: '#/components/responses/InternalServerErrorResponse' components: responses: ListAssetsResponse: description: Default Response content: application/json: schema: $ref: '#/components/schemas/ListAssetsResponse_application_json' BadRequestResponse: description: Bad request - validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ForbiddenResponse: description: Forbidden - insufficient permissions content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFoundResponse: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalServerErrorResponse: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' schemas: ListAssetsResponse_application_json: type: object properties: items: type: array items: $ref: >- #/components/schemas/ListAssetsResponse_application_json_items_items total: type: number description: Total number of items available limit: type: number description: Number of items returned offset: type: number description: Number of items skipped required: - items - total - limit - offset ErrorResponse: description: Bad request - validation error type: object properties: status: type: number description: HTTP status code message: type: string description: Error message error_id: type: string description: Unique error identifier error_code: type: string description: Error code developer_message: type: string description: Additional details for developers ListAssetsResponse_application_json_items_items: type: object properties: id: type: string format: uuid description: Asset unique identifier organization_id: type: string format: uuid description: Organization ID organization_name: type: string description: Organization name visibility: type: string enum: - inherit - private - restricted description: Asset visibility setting owned_by: type: string format: uuid description: User ID of asset owner tags: type: array description: Expanded tags (only present when expand=tags is used) items: $ref: >- #/components/schemas/ListAssetsResponse_application_json_items_items_tags_items references: type: object additionalProperties: true description: Asset references (IDs or expanded assets) created_at: type: string format: date-time updated_at: type: string format: date-time deleted_at: type: string nullable: true format: date-time description: Deletion timestamp created_by: type: string description: User ID who created updated_by: type: string description: User ID who last updated additionalProperties: true description: >- Asset with dynamic properties from asset type definition spread at root level example: id: 019983a9-c4c0-73af-aec9-463feeadc2e7 organization_id: 019983a9-c4bf-77da-a35b-5eb177b7b859 organization_name: Acme Corporation visibility: inherit owned_by: 019983a9-c4c0-73af-aec9-463feeadc2e7 name: John Doe first_name: John last_name: Doe title: CTO important: true contact_type: Decision Maker contact_methods: - type: Email value: john.doe@example.com - type: Mobile value: +1-555-0123 preferred_contact_method: Email references: location: 019983a9-c4c1-7abc-def0-123456789abc created_at: '2024-01-15T10:30:00.000Z' updated_at: '2024-01-20T14:45:00.000Z' created_by: 019983a9-c4c0-73af-aec9-463feeadc2e7 updated_by: 019983a9-c4c0-73af-aec9-463feeadc2e7 ListAssetsResponse_application_json_items_items_tags_items: type: object properties: id: type: string format: uuid description: Tag ID name: type: string description: Tag name securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: Bearer token accountId: type: apiKey in: header name: X-Account-ID description: Account ID ````