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

# Get paginated list of styles

> Retrieves a paginated list of styles based on the provided filter and cursor parameters. The method supports both cursor-based and filter-based pagination. When a cursor is provided, it is used to fetch the next set of results starting from the specified point in the dataset. If a filter is provided, it is applied to narrow down the results based on specific criteria. The response includes a list of styles along with pagination information indicating if more results are available and the next cursor for subsequent requests.

**Query String Encoding**: Text filter parameters (search, name, number, brand.name, supplier.name, etc.) containing reserved URL characters (such as &, =, +, %, #, ?, /, :, ;, @, !, $, ', (, ), *, ,) must be URL-encoded when used in query strings. For example, a search term "Style & Design" should be encoded as "Style%20%26%20Design". Most HTTP clients and libraries handle URL encoding automatically, but when constructing URLs manually, ensure proper encoding.

**Date range filters**: `lastUpdated` and `styleInfoUpdatedOn` accept one or two `yyyy-MM-dd` dates. A single value matches that day onward; two values define an inclusive range. `lastUpdated` reflects style header changes (e.g. publishing); `styleInfoUpdatedOn` reflects any style info change (e.g. custom fields). Styles never edited (no `styleInfoUpdatedOn`) are excluded from a `styleInfoUpdatedOn` filter.



## OpenAPI

````yaml /openapi/external.enriched.json get /api/styles
openapi: 3.1.1
info:
  title: Delogue External API - (Production)
  description: Integration endpoints for Delogue API
  version: 1.0.0
servers:
  - url: >-
      http://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/
security: []
tags:
  - name: SubSuppliers
  - name: StyleSupplierFacilities
  - name: StyleSkus
  - name: Styles
  - name: SampleRequests
  - name: StyleRelations
  - name: Style Prices
  - name: StyleItems
  - name: StyleFiles
  - name: StyleCustomFields
  - name: StyleContacts
  - name: StyleCategories
  - name: StyleCareInstructions
  - name: SizeRanges
  - name: Seasons
  - name: SampleTypes
  - name: Organizations
  - name: MeasurementCharts
  - name: Items
  - name: ItemCategories
  - name: Groups
  - name: Facilities
  - name: ComplianceCustomFields
  - name: ComplianceCategories
  - name: Color Groups
  - name: Colors
  - name: CareInstructions
  - name: CareInstructionMaterials
  - name: CareInstructionLayers
  - name: CareInstructionIcons
  - name: Brands
  - name: Barcodes
paths:
  /api/styles:
    get:
      tags:
        - Styles
      summary: Get paginated list of styles
      description: >-
        Retrieves a paginated list of styles based on the provided filter and
        cursor parameters. The method supports both cursor-based and
        filter-based pagination. When a cursor is provided, it is used to fetch
        the next set of results starting from the specified point in the
        dataset. If a filter is provided, it is applied to narrow down the
        results based on specific criteria. The response includes a list of
        styles along with pagination information indicating if more results are
        available and the next cursor for subsequent requests.


        **Query String Encoding**: Text filter parameters (search, name, number,
        brand.name, supplier.name, etc.) containing reserved URL characters
        (such as &, =, +, %, #, ?, /, :, ;, @, !, $, ', (, ), *, ,) must be
        URL-encoded when used in query strings. For example, a search term
        "Style & Design" should be encoded as "Style%20%26%20Design". Most HTTP
        clients and libraries handle URL encoding automatically, but when
        constructing URLs manually, ensure proper encoding.


        **Date range filters**: `lastUpdated` and `styleInfoUpdatedOn` accept
        one or two `yyyy-MM-dd` dates. A single value matches that day onward;
        two values define an inclusive range. `lastUpdated` reflects style
        header changes (e.g. publishing); `styleInfoUpdatedOn` reflects any
        style info change (e.g. custom fields). Styles never edited (no
        `styleInfoUpdatedOn`) are excluded from a `styleInfoUpdatedOn` filter.
      parameters:
        - name: Search
          in: query
          schema:
            type: string
        - name: id
          in: query
          schema:
            type: array
            items:
              pattern: ^-?(?:0|[1-9]\d*)$
              type:
                - integer
                - string
              format: int64
        - name: Name
          in: query
          schema:
            type: string
        - name: StyleNumber
          in: query
          schema:
            type: string
        - name: description
          in: query
          schema:
            type: array
            items:
              type: string
        - name: state
          in: query
          schema:
            type: array
            items:
              type: string
        - name: customid
          in: query
          schema:
            type: array
            items:
              type: string
        - name: ReadyForExport
          in: query
          schema:
            type: boolean
        - name: brand.id
          in: query
          schema:
            type: array
            items:
              pattern: ^-?(?:0|[1-9]\d*)$
              type:
                - integer
                - string
              format: int64
        - name: brand.name
          in: query
          schema:
            type: array
            items:
              type: string
        - name: brand.contactpersonid
          in: query
          schema:
            type: array
            items:
              type: string
              format: uuid
        - name: brand.customid
          in: query
          schema:
            type: array
            items:
              type: string
        - name: brand.contactpersonname
          in: query
          schema:
            type: array
            items:
              type: string
        - name: supplier.id
          in: query
          schema:
            type: array
            items:
              pattern: ^-?(?:0|[1-9]\d*)$
              type:
                - integer
                - string
              format: int64
        - name: supplier.contactpersonid
          in: query
          schema:
            type: array
            items:
              type: string
              format: uuid
        - name: supplier.name
          in: query
          schema:
            type: array
            items:
              type: string
        - name: supplier.customid
          in: query
          schema:
            type: array
            items:
              type: string
        - name: supplier.contactperson.name
          in: query
          schema:
            type: array
            items:
              type: string
        - name: season.id
          in: query
          schema:
            type: array
            items:
              pattern: ^-?(?:0|[1-9]\d*)$
              type:
                - integer
                - string
              format: int64
        - name: season.name
          in: query
          schema:
            type: array
            items:
              type: string
        - name: season.customid
          in: query
          schema:
            type: array
            items:
              type: string
        - name: season.project
          in: query
          schema:
            type: array
            items:
              type: string
        - name: group.id
          in: query
          schema:
            type: array
            items:
              pattern: ^-?(?:0|[1-9]\d*)$
              type:
                - integer
                - string
              format: int64
        - name: group.name
          in: query
          schema:
            type: array
            items:
              type: string
        - name: group.customid
          in: query
          schema:
            type: array
            items:
              type: string
        - name: category.id
          in: query
          schema:
            type: array
            items:
              pattern: ^-?(?:0|[1-9]\d*)$
              type:
                - integer
                - string
              format: int64
        - name: category.name
          in: query
          schema:
            type: array
            items:
              type: string
        - name: category.customid
          in: query
          schema:
            type: array
            items:
              type: string
        - name: stylecolor.name
          in: query
          schema:
            type: array
            items:
              type: string
        - name: stylecolor.id
          in: query
          schema:
            type: array
            items:
              type: string
        - name: stylecolor.id2
          in: query
          schema:
            type: array
            items:
              type: string
        - name: CustomFields
          in: query
          schema:
            type: array
            items:
              $ref: '#/components/schemas/CustomFieldDto'
        - name: LastUpdated
          in: query
          schema:
            type: array
            items:
              type: string
              format: date-time
        - name: StyleInfoUpdatedOn
          in: query
          schema:
            type: array
            items:
              type: string
              format: date-time
        - name: sort
          in: query
          schema:
            type: array
            items:
              $ref: '#/components/schemas/SortDescriptorDto'
        - name: pageSize
          in: query
          schema:
            pattern: ^-?(?:0|[1-9]\d*)$
            type:
              - integer
              - string
            format: int32
        - name: pageNumber
          in: query
          schema:
            pattern: ^-?(?:0|[1-9]\d*)$
            type:
              - integer
              - string
            format: int32
        - name: cursor
          in: query
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ApiPaginatedResponseOfStyleDto'
            application/json:
              schema:
                $ref: '#/components/schemas/ApiPaginatedResponseOfStyleDto'
            text/json:
              schema:
                $ref: '#/components/schemas/ApiPaginatedResponseOfStyleDto'
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
        '401':
          description: Unauthorized
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
            text/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
      security:
        - {}
components:
  schemas:
    CustomFieldDto:
      required:
        - value
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          format: int64
        userDefinedId:
          type:
            - 'null'
            - string
        type:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/CustomFieldTypeDto'
        value:
          type: string
      additionalProperties: false
    SortDescriptorDto:
      type: object
      properties:
        propertyName:
          type: string
        order:
          $ref: '#/components/schemas/SortOrderDto'
      additionalProperties: false
    ApiPaginatedResponseOfStyleDto:
      required:
        - status
        - code
        - data
        - pagination
      type: object
      properties:
        status:
          $ref: '#/components/schemas/ApiResponseStatus'
        code:
          type: string
        data:
          type: array
          items:
            $ref: '#/components/schemas/StyleDto'
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
      additionalProperties: false
    ApiErrorResponse:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/ApiResponseStatus'
        code:
          type: string
        error:
          $ref: '#/components/schemas/ErrorWrapper'
      additionalProperties: false
    CustomFieldTypeDto: {}
    SortOrderDto: {}
    ApiResponseStatus: {}
    StyleDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        name:
          type:
            - 'null'
            - string
        customId:
          type:
            - 'null'
            - string
        state:
          $ref: '#/components/schemas/StyleStateDto'
        description:
          type:
            - 'null'
            - string
        logo:
          type:
            - 'null'
            - string
        extraText:
          type:
            - 'null'
            - string
        lastUpdated:
          type: string
          format: date-time
        styleInfoUpdatedOn:
          type:
            - 'null'
            - string
          format: date-time
        season:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/SeasonStyleDto'
        group:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/StyleGroupDto'
        brand:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/BrandStyleDto'
        supplier:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/SupplierDto'
        categories:
          type: array
          items:
            $ref: '#/components/schemas/CategoryDto'
        styleColors:
          type: array
          items:
            $ref: '#/components/schemas/StyleColorDto'
        customFields:
          type: array
          items:
            $ref: '#/components/schemas/CustomFieldResponseDto'
        properties:
          type: array
          items:
            type: string
      additionalProperties: false
    PaginationInfo:
      required:
        - hasMore
        - cursor
      type: object
      properties:
        hasMore:
          type: boolean
        cursor:
          type: string
      additionalProperties: false
    ErrorWrapper:
      type: object
      properties:
        details:
          type: array
          items:
            $ref: '#/components/schemas/ErrorDetailDto'
      additionalProperties: false
    StyleStateDto: {}
    SeasonStyleDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        customId:
          type:
            - 'null'
            - string
        name:
          type:
            - 'null'
            - string
        project:
          type:
            - 'null'
            - string
      additionalProperties: false
    StyleGroupDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        customId:
          type:
            - 'null'
            - string
        name:
          type:
            - 'null'
            - string
      additionalProperties: false
    BrandStyleDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        customId:
          type:
            - 'null'
            - string
        name:
          type:
            - 'null'
            - string
        contactPersonId:
          type:
            - 'null'
            - string
        contactPersonName:
          type:
            - 'null'
            - string
      additionalProperties: false
    SupplierDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        customId:
          type:
            - 'null'
            - string
        name:
          type:
            - 'null'
            - string
        contactPersonId:
          type:
            - 'null'
            - string
        contactPersonName:
          type:
            - 'null'
            - string
        country:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/CountryDto'
        contactPerson:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ContactPersonDto'
      additionalProperties: false
    CategoryDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        customId:
          type:
            - 'null'
            - string
        name:
          type:
            - 'null'
            - string
      additionalProperties: false
    StyleColorDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        name:
          type:
            - 'null'
            - string
        customId1:
          type:
            - 'null'
            - string
        customId2:
          type:
            - 'null'
            - string
        state:
          type:
            - 'null'
            - string
      additionalProperties: false
    CustomFieldResponseDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        customId1:
          type:
            - 'null'
            - string
        type:
          type:
            - 'null'
            - string
        name:
          type:
            - 'null'
            - string
        value:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/CustomFieldValueDto'
        values:
          type:
            - 'null'
            - array
          items:
            $ref: '#/components/schemas/CustomFieldValueDto'
        perColorValues:
          type:
            - 'null'
            - array
          items:
            $ref: '#/components/schemas/CustomFieldPerColorValueDto'
      additionalProperties: false
    ErrorDetailDto:
      required:
        - type
        - field
        - value
      type: object
      properties:
        type:
          type: string
        field:
          type:
            - 'null'
            - string
        value:
          type:
            - 'null'
            - string
      additionalProperties: false
    CountryDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int32
        name:
          type:
            - 'null'
            - string
        customId:
          type:
            - 'null'
            - string
      additionalProperties: false
    ContactPersonDto:
      type: object
      properties:
        name:
          type:
            - 'null'
            - string
        email:
          type:
            - 'null'
            - string
        status:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/ContactPersonStatusDto'
      additionalProperties: false
    CustomFieldValueDto:
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        value:
          type:
            - 'null'
            - string
        customId:
          type:
            - 'null'
            - string
      additionalProperties: false
    CustomFieldPerColorValueDto:
      type: object
      properties:
        styleColorId:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: int64
        value:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/CustomFieldValueDto'
        values:
          type:
            - 'null'
            - array
          items:
            $ref: '#/components/schemas/CustomFieldValueDto'
      additionalProperties: false
    ContactPersonStatusDto: {}

````