Incentivio

Incentivio Segment Controller API

The segment-controller API from Incentivio — 5 operation(s) for segment-controller.

GitHub OpenAPI
Business capability
Customer Segmentation Management BC-420.20

Operations 8

GET /incentivio-auto-tagger-service/segments/{segmentId} Find segment #
PUT /incentivio-auto-tagger-service/segments/{segmentId} Update segment #
DELETE /incentivio-auto-tagger-service/segments/{segmentId} Delete segment #
PUT /incentivio-auto-tagger-service/segments/{segmentId}/deactivate Deactivate segment #
GET /incentivio-auto-tagger-service/segments Find all segments #
POST /incentivio-auto-tagger-service/segments Create segment #
GET /incentivio-auto-tagger-service/segments/{segmentid}/reactivate Reactivate segment #
GET /segments/segments-by-customer Find segments by customer #

Documentation

📖
Authentication
https://artifacts.apis.io/incentivio/authentication/incentivio-authentication.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/incentivio/openapi/incentivio-segment-controller-api-openapi.yml

Other Resources

🔗
Conventions
https://artifacts.apis.io/incentivio/conventions/incentivio-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/incentivio/errors/incentivio-error-codes.yml
🔗
DataModel
https://artifacts.apis.io/incentivio/data-model/incentivio-data-model.yml
🔗
WellKnown
https://artifacts.apis.io/incentivio/well-known/incentivio-well-known.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/incentivio:incentivio-segment-controller-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

incentivio-segment-controller-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Incentivio Segment Controller API
  version: v0
  description: 'Operations tagged segment-controller across 2 of this provider''s published API definitions: incentivio-admin-api-openapi.json, incentivio-mobile-api-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://adminapi.incentivio.com/incentivio-admin-api
  description: Generated server url
- url: https://mobile.incentivio.com/incentivio-mobile-api
  description: Generated server url
tags:
- name: segment-controller
paths:
  /incentivio-auto-tagger-service/segments/{segmentId}:
    get:
      tags:
      - segment-controller
      operationId: findSegment
      parameters:
      - name: segmentId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/SegmentResponseDTO'
      summary: Find segment
      x-summary-source: derived
    put:
      tags:
      - segment-controller
      operationId: updateSegment
      parameters:
      - name: segmentId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SegmentRequestDTO'
        required: true
      responses:
        '200':
          description: OK
      summary: Update segment
      x-summary-source: derived
    delete:
      tags:
      - segment-controller
      operationId: deleteSegment
      parameters:
      - name: segmentId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      summary: Delete segment
      x-summary-source: derived
    servers:
    - url: https://adminapi.incentivio.com/incentivio-admin-api
      description: Generated server url
  /incentivio-auto-tagger-service/segments/{segmentId}/deactivate:
    put:
      tags:
      - segment-controller
      operationId: deactivateSegment
      parameters:
      - name: segmentId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      summary: Deactivate segment
      x-summary-source: derived
    servers:
    - url: https://adminapi.incentivio.com/incentivio-admin-api
      description: Generated server url
  /incentivio-auto-tagger-service/segments:
    get:
      tags:
      - segment-controller
      operationId: findAllSegments
      parameters:
      - name: page
        in: query
        required: true
        schema:
          type: integer
          format: int32
      - name: count
        in: query
        required: true
        schema:
          type: integer
          format: int32
      - name: sortBy
        in: query
        required: false
        schema:
          type: string
          default: segmentName
      - name: sortDirection
        in: query
        required: false
        schema:
          type: string
          default: ASC
      - name: title
        in: query
        required: false
        schema:
          type: string
      - name: expired
        in: query
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/FindSegmentsResponseDTO'
      summary: Find all segments
      x-summary-source: derived
    post:
      tags:
      - segment-controller
      operationId: createSegment
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SegmentRequestDTO'
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/CreateSegmentResponseDTO'
      summary: Create segment
      x-summary-source: derived
    servers:
    - url: https://adminapi.incentivio.com/incentivio-admin-api
      description: Generated server url
  /incentivio-auto-tagger-service/segments/{segmentid}/reactivate:
    get:
      tags:
      - segment-controller
      operationId: reactivateSegment
      parameters:
      - name: segmentid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
      summary: Reactivate segment
      x-summary-source: derived
    servers:
    - url: https://adminapi.incentivio.com/incentivio-admin-api
      description: Generated server url
  /segments/segments-by-customer:
    get:
      tags:
      - segment-controller
      operationId: findSegmentsByCustomer
      parameters:
      - name: page
        in: query
        required: true
        schema:
          type: integer
          format: int32
      - name: count
        in: query
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/FindCustomerSegmentsResponseDTO'
      summary: Find segments by customer
      x-summary-source: derived
    servers:
    - url: https://mobile.incentivio.com/incentivio-mobile-api
      description: Generated server url
components:
  schemas:
    FindSegmentsResponseDTO:
      type: object
      properties:
        paging:
          $ref: '#/components/schemas/ResultsPagingDTO'
        segments:
          type: array
          items:
            $ref: '#/components/schemas/SegmentResponseDTO'
    CreateSegmentResponseDTO:
      type: object
      properties:
        segmentId:
          type: string
        segmentName:
          type: string
    RuleDescriptor:
      type: object
      properties:
        ruleType:
          $ref: '#/components/schemas/RuleTypeEnum'
        operator:
          $ref: '#/components/schemas/OperatorEnum'
        expressionValue:
          type: string
        expressionValueNew:
          $ref: '#/components/schemas/ExpressionValueNew'
        expressionName:
          type: string
        expressoinFormat:
          type: string
        extendedAttributes:
          type: object
          additionalProperties:
            type: string
        logicType:
          $ref: '#/components/schemas/LogicTypeEnum'
        childNodes:
          type: array
          items:
            $ref: '#/components/schemas/RuleDescriptor'
    DaysOfWeekEnum:
      type: string
      enum:
      - MONDAY
      - TUESDAY
      - WEDNESDAY
      - THURSDAY
      - FRIDAY
      - SATURDAY
      - SUNDAY
    SubCategoryEnum:
      type: string
      enum:
      - LIFETIME
      - LAST_NO_OF_DAYS
      - NO_OF_ORDERS
    LogicTypeEnum:
      type: string
      enum:
      - AND
      - OR
      - NOT
    ResultsPagingDTO:
      type: object
      properties:
        total:
          type: integer
          format: int64
        count:
          type: integer
          format: int32
        totalPages:
          type: integer
          format: int64
        currentPage:
          type: integer
          format: int32
    OperatorEnum:
      type: string
      enum:
      - EQ
      - LT
      - GT
      - LT_EQ
      - GT_EQ
      - NOT
      - WITHIN
      - NOTEXISTS
    RuleTypeEnum:
      type: string
      enum:
      - EXPRESSION
      - LOGIC
    ExpressionValueNew:
      type: object
      properties:
        attributeName:
          type: string
        attributeTitle:
          type: string
        attributeValues: {}
        dataType:
          type: string
        productList:
          type: array
          items:
            $ref: '#/components/schemas/ProductDTO'
          uniqueItems: true
        subCategory:
          $ref: '#/components/schemas/SubCategoryEnum'
        relationalOperator:
          $ref: '#/components/schemas/RelationalOperatorEnum'
        quantity:
          type: string
        noOfDays:
          type: integer
          format: int32
        noOfOrders:
          type: integer
          format: int32
        startTime:
          type: string
        endTime:
          type: string
        daysOfWeek:
          type: array
          items:
            $ref: '#/components/schemas/DaysOfWeekEnum'
    SegmentResponseDTO:
      type: object
      properties:
        segmentId:
          type: string
        clientId:
          type: string
        merchantId:
          type: string
        merchantName:
          type: string
        segmentName:
          type: string
        segmentDescription:
          type: string
        segmentTag:
          type: string
        segmentType:
          $ref: '#/components/schemas/SegmentTypeEnum'
        segmentIcon:
          type: string
        visibleToCustomer:
          type: boolean
        segmentRules:
          $ref: '#/components/schemas/RuleDescriptor'
        adminId:
          type: string
        adminEmail:
          type: string
        startDate:
          type: string
          format: date-time
        createdDate:
          type: string
          format: date-time
        updateDate:
          type: string
          format: date-time
        lastProcessedDate:
          type: string
          format: date-time
        expiredStatus:
          type: boolean
        displaySegmentStatus:
          type: string
        deletedStatus:
          type: boolean
        segmentDistribution:
          type: string
        customerCount:
          type: integer
          format: int32
        calculationInProgressStatus:
          type: boolean
    ProductDTO:
      type: object
      properties:
        type:
          type: string
        id:
          type: string
        externalId:
          type: string
        displayInfoTitlesList:
          type: array
          items:
            type: string
    SegmentRequestDTO:
      type: object
      properties:
        segmentName:
          type: string
        segmentDescription:
          type: string
        segmentType:
          $ref: '#/components/schemas/SegmentTypeEnum'
        segmentTag:
          type: string
        segmentIcon:
          type: string
        visibleToCustomer:
          type: boolean
        languageCode:
          type: string
        segmentRules:
          $ref: '#/components/schemas/RuleDescriptor'
        adminId:
          type: string
        adminEmail:
          type: string
        startDate:
          type: string
          format: date-time
        createdDate:
          type: string
          format: date-time
        updateDate:
          type: string
          format: date-time
        lastProcessedDate:
          type: string
          format: date-time
        timeZone:
          type: string
        expiredStatus:
          type: boolean
        deletedStatus:
          type: boolean
        segmentDistribution:
          type: string
        advancedSettings:
          type: object
          additionalProperties: {}
      required:
      - adminEmail
      - adminId
      - segmentName
      - segmentRules
      - segmentType
      - startDate
      - timeZone
    SegmentTypeEnum:
      type: string
      enum:
      - LOYALTY
      - NORMAL
    RelationalOperatorEnum:
      type: string
      enum:
      - EQ
      - LT
      - GT
      - LT_EQ
      - GT_EQ
      - NOT
      - WITHIN
      - NOTEXISTS
    FindCustomerSegmentsResponseDTO:
      type: object
      properties:
        clientId:
          type: string
        customerId:
          type: string
        paging:
          $ref: '#/components/schemas/ResultsPagingDTO'
        segments:
          type: array
          items:
            $ref: '#/components/schemas/SegmentLightResponseDTO'
    RuleDescriptor_2:
      type: object
      properties:
        ruleType:
          type: string
          enum:
          - EXPRESSION
          - LOGIC
        operator:
          type: string
          enum:
          - EQ
          - LT
          - GT
          - LT_EQ
          - GT_EQ
          - NOT
          - WITHIN
          - NOTEXISTS
        expressionValue:
          type: string
        expressionValueNew:
          $ref: '#/components/schemas/ExpressionValueNew_2'
        expressionName:
          type: string
        expressoinFormat:
          type: string
        extendedAttributes:
          type: object
          additionalProperties:
            type: string
        logicType:
          type: string
          enum:
          - AND
          - OR
          - NOT
        childNodes:
          type: array
          items:
            $ref: '#/components/schemas/RuleDescriptor_2'
    SegmentLightResponseDTO:
      type: object
      properties:
        segmentId:
          type: string
        segmentName:
          type: string
        segmentDescription:
          type: string
        segmentIcon:
          type: string
        segmentRules:
          $ref: '#/components/schemas/RuleDescriptor_2'
        deletedStatus:
          type: boolean
    ExpressionValueNew_2:
      type: object
      properties:
        attributeName:
          type: string
        attributeTitle:
          type: string
        attributeValues:
          type: object
        dataType:
          type: string
        productList:
          uniqueItems: true
          type: array
          items:
            $ref: '#/components/schemas/ProductDTO'
        subCategory:
          type: string
          enum:
          - LIFETIME
          - LAST_NO_OF_DAYS
          - NO_OF_ORDERS
        relationalOperator:
          type: string
          enum:
          - EQ
          - LT
          - GT
          - LT_EQ
          - GT_EQ
          - NOT
          - WITHIN
          - NOTEXISTS
        quantity:
          type: string
        noOfDays:
          type: integer
          format: int32
        noOfOrders:
          type: integer
          format: int32
        startTime:
          $ref: '#/components/schemas/LocalTime'
        endTime:
          $ref: '#/components/schemas/LocalTime'
        daysOfWeek:
          type: array
          items:
            type: string
            enum:
            - MONDAY
            - TUESDAY
            - WEDNESDAY
            - THURSDAY
            - FRIDAY
            - SATURDAY
            - SUNDAY
    LocalTime:
      type: object
      properties:
        hour:
          type: integer
          format: int32
        minute:
          type: integer
          format: int32
        second:
          type: integer
          format: int32
        nano:
          type: integer
          format: int32
x-refined-from:
- incentivio-admin-api-openapi.json
- incentivio-mobile-api-openapi.json