> ## Documentation Index
> Fetch the complete documentation index at: https://docs.erp.arukz.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List attributes

> Retrieve a paginated list of attributes with filtering and sorting



## OpenAPI

````yaml /api-reference/openapi.json get /admin/api/v1/products/attributes
openapi: 3.0.3
info:
  title: ARUKZ ERP API
  version: v1
  description: >-
    The REST API of ARUKZ ERP: sales, purchases, inventory, products, partners,
    accounts, projects and reference data. Every call acts as the user whose
    token it carries and sees only that user's company.
servers:
  - url: https://erp.arukz.com
    description: ARUKZ ERP (hosted)
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Sign in for a token and sign out.
  - name: Sales
    description: Quotations, sales orders and their lines, deliveries and invoices.
  - name: Purchases
    description: Purchase orders, receipts, bills, agreements and vendor price lists.
  - name: Inventory
    description: >-
      Warehouses, locations, lots, stock quantities, receipts, deliveries,
      transfers and scrap.
  - name: Products
    description: 'The product catalogue: categories, attributes, variants and packaging.'
  - name: Partners
    description: Customers, vendors, contacts, addresses and bank accounts.
  - name: Accounts
    description: >-
      Invoices, bills, credit notes, refunds, taxes, journals and the chart of
      accounts.
  - name: Projects
    description: Projects, tasks, stages and milestones.
  - name: Reference data
    description: Currencies and rates, banks, countries, states and units of measure.
paths:
  /admin/api/v1/products/attributes:
    get:
      tags:
        - Products
      summary: List attributes
      description: Retrieve a paginated list of attributes with filtering and sorting
      operationId: products-attributes-list-attributes
      parameters:
        - name: include
          in: query
          required: false
          schema:
            type: string
            description: |-
              Comma-separated list of relationships to include.

              **Available options:** options, creator
            example: options
          description: |-
            Comma-separated list of relationships to include.

            **Available options:** options, creator
        - name: filter[id]
          in: query
          required: false
          schema:
            type: string
            description: Comma-separated list of IDs to filter by
          description: Comma-separated list of IDs to filter by
        - name: filter[name]
          in: query
          required: false
          schema:
            type: string
            description: Filter by attribute name (partial match)
          description: Filter by attribute name (partial match)
        - name: filter[type]
          in: query
          required: false
          schema:
            type: string
            description: Filter by attribute type
            enum:
              - radio
              - select
              - color
          description: Filter by attribute type
        - name: filter[trashed]
          in: query
          required: false
          schema:
            type: string
            description: >-
              Filter by trashed status: "with" (include trashed), "only" (only
              trashed), or any other value for non-trashed only
            example: with
          description: >-
            Filter by trashed status: "with" (include trashed), "only" (only
            trashed), or any other value for non-trashed only
        - name: sort
          in: query
          required: true
          schema:
            type: string
            description: Sort field
            example: sort
          description: Sort field
        - name: page
          in: query
          required: true
          schema:
            type: integer
            description: Page number
            example: 1
          description: Page number
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                data:
                  - id: 1
                    name: Size
                    type: select
                    sort: null
                    creator_id: 1
                    created_at: '2025-04-08T03:29:17.000000Z'
                    updated_at: '2025-04-08T03:29:17.000000Z'
                    deleted_at: null
                    options:
                      - id: 1
                        name: Small
                        color: null
                        extra_price: '10.0000'
                        sort: null
                        attribute_id: 1
                        created_at: '2025-04-08T03:29:17.000000Z'
                        updated_at: '2025-04-08T03:29:17.000000Z'
                      - id: 2
                        name: Medium
                        color: null
                        extra_price: '20.0000'
                        sort: null
                        attribute_id: 1
                        created_at: '2025-04-08T03:29:17.000000Z'
                        updated_at: '2025-04-08T03:29:17.000000Z'
                      - id: 3
                        name: Large
                        color: null
                        extra_price: '30.0000'
                        sort: null
                        attribute_id: 1
                        created_at: '2025-04-08T03:29:17.000000Z'
                        updated_at: '2025-04-08T03:29:17.000000Z'
                      - id: 4
                        name: Extra Large
                        color: null
                        extra_price: '40.0000'
                        sort: null
                        attribute_id: 1
                        created_at: '2025-04-08T03:29:17.000000Z'
                        updated_at: '2025-04-08T03:29:17.000000Z'
                  - id: 1
                    name: Size
                    type: select
                    sort: null
                    creator_id: 1
                    created_at: '2025-04-08T03:29:17.000000Z'
                    updated_at: '2025-04-08T03:29:17.000000Z'
                    deleted_at: null
                    options:
                      - id: 1
                        name: Small
                        color: null
                        extra_price: '10.0000'
                        sort: null
                        attribute_id: 1
                        created_at: '2025-04-08T03:29:17.000000Z'
                        updated_at: '2025-04-08T03:29:17.000000Z'
                      - id: 2
                        name: Medium
                        color: null
                        extra_price: '20.0000'
                        sort: null
                        attribute_id: 1
                        created_at: '2025-04-08T03:29:17.000000Z'
                        updated_at: '2025-04-08T03:29:17.000000Z'
                      - id: 3
                        name: Large
                        color: null
                        extra_price: '30.0000'
                        sort: null
                        attribute_id: 1
                        created_at: '2025-04-08T03:29:17.000000Z'
                        updated_at: '2025-04-08T03:29:17.000000Z'
                      - id: 4
                        name: Extra Large
                        color: null
                        extra_price: '40.0000'
                        sort: null
                        attribute_id: 1
                        created_at: '2025-04-08T03:29:17.000000Z'
                        updated_at: '2025-04-08T03:29:17.000000Z'
                links:
                  first: /?page=1
                  last: /?page=1
                  prev: null
                  next: null
                meta:
                  current_page: 1
                  from: 1
                  last_page: 1
                  links:
                    - url: null
                      label: '&laquo; Previous'
                      active: false
                    - url: /?page=1
                      label: '1'
                      active: true
                    - url: null
                      label: Next &raquo;
                      active: false
                  path: /
                  per_page: 10
                  to: 2
                  total: 2
        '401':
          description: Unauthenticated
          content:
            application/json:
              example:
                message: Unauthenticated.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An API token from [Sign in](/api-reference/authentication), sent as
        `Authorization: Bearer <token>`. Tokens last 30 days.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.