Cisco Identity Services Engine Acibindings API

openapi: 3.2.0
info:
  title: Cisco Ise Acibindings API
  version: '1.0'
  description: 'Operations tagged acibindings across 2 of this provider''s published API definitions: cisco-ise-ers-open-api-ers-apis.yaml,
    cisco-ise-legacy-ers-aci-bindings.yaml. Each path carries the servers of the definition it was published in.'
  x-provenance:
    method: harvested
    authored_by: Cisco
    harvested_by: API Evangelist
    harvested_on: '2026-08-19'
    first_party: true
    provider_published: true
    source_host: pubhub.devnetcloud.com
    note: 103 ISE API descriptions (1,490 operations; 32 OpenAPI 3.0.x + 71 Swagger 2.0) enumerated from Cisco's own DevNet
      project manifest and fetched anonymously. Byte-identity reconfirmed 2026-08-19 by SHA-256 against the live source.
    derived_view: Per-tag view of cisco-ise-legacy-ers-aci-bindings.yaml, the provider's source document. Operations and schemas
      are the provider's, unmodified; only the partition is ours.
    derived_from: cisco-ise-legacy-ers-aci-bindings.yaml
    operation_coverage: 2/3
  x-evidence:
  - type: source
    url: https://pubhub.devnetcloud.com/media/identity-services-engine-api-v1/docs/
  - type: source
    url: https://developer.cisco.com/docs/identity-services-engine/
servers:
- url: https://{server}:{port}/ers/config
  description: Append /ctsapi/v2 or /ctsapi/v3 to above URL while accessing CTS APIs
  variables:
    server:
      description: The host where the API is rooted
      default: localhost
    port:
      description: The port no for CTS APIs is 9063 and for other APIs it is 443
      default: '443'
tags:
- name: acibindings
paths:
  /acibindings/getall:
    get:
      tags:
      - acibindings
      summary: getAllBindingsInfo
      parameters:
      - name: filter
        in: query
        description: Filter Supported Fields:[sgt, ip, vn, psn, learnedBy, learnedFrom]
        required: false
        allowReserved: true
        schema:
          type: string
          example: toDate.CONTAINS.SEP
      - $ref: '#/components/parameters/ppage'
      - $ref: '#/components/parameters/psize'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/acibindingsArrayListResponseEntity'
            application/xml:
              schema:
                $ref: '#/components/schemas/acibindingsArrayListResponseEntity'
            text/html:
              schema:
                type: string
                example: null
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
        '406':
          description: Not Acceptable
        '415':
          description: UnSupported Media Type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/ERSResponse'
            text/html:
              schema:
                type: string
                example: null
      security:
      - HTTPBasicAuthentication: []
    servers:
    - url: https://{server}:{port}/ers/config
      description: Append /ctsapi/v2 or /ctsapi/v3 to above URL while accessing CTS APIs
      variables:
        server:
          description: The host where the API is rooted
          default: localhost
        port:
          description: The port no for CTS APIs is 9063 and for other APIs it is 443
          default: '443'
  /ers/config/acibindings/getall:
    get:
      tags:
      - acibindings
      summary: Get all binding information
      description: <p>This API allows clients to retrieve all the bindings that were sent to Cisco ISE by ACI or received
        on ACI from Cisco ISE.The binding information will be identical to the information on ACI bindings page in the Cisco
        ISE UI. Filtering will be based on one attribute only, such as ip/sgt/vn/psn/learnedFrom/learnedBy with CONTAINS mode
        of search.</p>
      parameters:
      - in: header
        name: HTTP ERS-Media-Type Header
        description: Example:- trustsec.acibindings.1.0
        required: false
        schema:
          type: string
      - in: header
        name: HTTP X-CSRF-TOKEN Header
        description: 'Required Only if Enabled from GUI

          Example:- fetch'
        schema:
          type: string
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/bindings'
            application/xml:
              schema:
                $ref: '#/components/schemas/bindings'
  /ers/config/acibindings/versioninfo:
    get:
      tags:
      - acibindings
      summary: Get ACI bindings version information
      description: <p>This API helps to retrieve the version information related to the Cisco ACI bindings.</p>
      responses:
        200:
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VersionInfo'
components:
  schemas:
    Link:
      type: object
      properties:
        rel:
          type: string
          example: self
          enum:
          - next
          - previous
          - self
          - status
        href:
          type: string
          example: https://{server}:{port}/ers/config
        type:
          type: string
          example: application/json
      example: null
    ERSResponse:
      type: object
      properties:
        operation:
          type: string
          example: Operation
        messages:
          type: array
          example: null
          items:
            properties:
              title:
                type: string
                example: title
              type:
                type: string
                example: type
              code:
                type: string
                example: code
            example: null
      example: null
    acibindingsResponseEntity:
      properties:
        ip:
          title: ip
          type: string
          description: Binding IP address. Each binding will be exclusively identified by his IP address and virtual network
          example: null
        sgt:
          title: sgt
          type: string
          description: Security group tag value.
          example: null
        vn:
          title: vn
          type: string
          description: Virtual network. Each binding will be exclusively identified by his IP address and virtual network.
          example: null
        psn:
          title: psn
          type: string
          description: Last ISE node name.
          example: null
        learnedFrom:
          title: learnedFrom
          type: string
          description: Binding source.
          example: null
        learnedBy:
          title: learnedBy
          type: string
          description: Binding type.
          example: null
        name:
          title: name
          type: string
          description: name
          example: null
        id:
          title: id
          type: string
          description: Id
          example: null
        description:
          title: description
          type: string
          description: Description
          example: null
        link:
          $ref: '#/components/schemas/Link'
      example: null
    acibindingsArrayListResponseEntity:
      properties:
        ArrayList:
          type: array
          example: null
          items:
            $ref: '#/components/schemas/acibindingsResponseEntity'
      example: null
    acibindings:
      type: object
      properties:
        ip:
          type: string
          example: 10.0.0.1
        sgtvalue:
          type: string
          example: '1234'
        vn:
          type: string
          example: vn1234
        psn:
          type: string
          example: 10.86.189.217
        learnedFrom:
          type: string
          example: ACI by ISE
        learnedBy:
          type: string
          example: STATIC
    VersionInfo:
      type: object
      properties:
        VersionInfo:
          $ref: '#/components/schemas/version'
    bindings:
      type: object
      properties:
        ACIBindings:
          $ref: '#/components/schemas/acibindings'
    version:
      type: object
      properties:
        currentServerVersion:
          type: string
          example: '1.0'
        supportedVersions:
          type: string
          example: '1.0'
        link:
          $ref: '#/components/schemas/link1'
    link1:
      type: object
      properties:
        rel:
          type: string
          example: self
        href:
          type: string
          example: https://<ise-ip>:9060/ers/config/acibindings/versioninfo
        type:
          type: string
          example: application/xml
  parameters:
    ppage:
      name: page
      in: query
      description: Page Number (0...N)
      allowReserved: true
      schema:
        type: integer
        example: null
      example: '1'
    psize:
      name: size
      in: query
      description: Items by Page
      allowReserved: true
      schema:
        type: integer
        example: null
      example: '20'
  securitySchemes:
    HTTPBasicAuthentication:
      type: http
      scheme: basic
x-refined-from:
- cisco-ise-ers-open-api-ers-apis.yaml
- cisco-ise-legacy-ers-aci-bindings.yaml