Ariba Guided Buying Requisitions API

openapi: 3.0.3
info:
  title: Ariba Guided Buying - Asset Management Requisitions API
  description: The Asset Management API enables developers to construct API queries that import asset records into the SAP Ariba solution and assign unique values to asset line items on requisitions. This API is applicable for SAP ERP-integrated sites that have enabled the asset management feature.
  version: 2026-02
  contact:
    name: SAP Ariba Developer Support
    url: https://developer.ariba.com
  x-generated-from: documentation
  x-last-validated: '2026-04-19'
servers:
- url: https://openapi.ariba.com/api/asset-management/v1/prod
  description: Production environment
- url: https://openapi.ariba.com/api/asset-management/v1/sandbox
  description: Sandbox environment
security:
- OAuth2: []
tags:
- name: Requisitions
  description: Asset requisition retrieval and update operations
paths:
  /requisitions:
    get:
      operationId: listAssetRequisitions
      summary: Ariba Guided Buying List Asset Requisitions
      description: Get requisitions consisting of asset line items that are in the In Progress state in the Asset Workbench in the buying solution. Requisitions move to this state after asset managers finish their approval.
      tags:
      - Requisitions
      parameters:
      - name: realm
        in: query
        required: true
        description: The SAP Ariba realm name identifying your site.
        schema:
          type: string
        example: mycompany-T
      - name: $filter
        in: query
        required: false
        description: 'Filter asset-based requisitions by attributes. Example: {TimeCreated eq 2018-09-26T09:00:00Z;TimeUpdated eq 2018-09-27T09:00:00Z}'
        schema:
          type: string
        example: '{TimeCreated eq 2026-01-01T00:00:00Z}'
      - name: $count
        in: query
        required: false
        description: Include total count in response when set to true.
        schema:
          type: boolean
        example: true
      - name: $skip
        in: query
        required: false
        description: Number of records to skip for pagination.
        schema:
          type: integer
        example: 0
      responses:
        '200':
          description: Successfully retrieved asset requisitions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequisitionsResponse'
              examples:
                listAssetRequisitions200Example:
                  summary: Default listAssetRequisitions 200 response
                  x-microcks-default: true
                  value:
                    count: 1
                    requisitions:
                    - id: REQ-500123
                      title: Office Equipment Purchase
                      status: InProgress
                      createdDate: '2026-01-15T09:00:00Z'
                      updatedDate: '2026-01-16T10:00:00Z'
                      lineItems:
                      - lineItemId: LINE-001
                        description: Laptop Computer
                        assetCategory: IT Equipment
                        quantity: 1
        '400':
          description: Bad Request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - invalid or missing credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden - insufficient permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '504':
          description: Gateway Timeout.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /requisitions/$count:
    get:
      operationId: countAssetRequisitions
      summary: Ariba Guided Buying Count Asset Requisitions
      description: Get the total count of requisitions consisting of asset line items in the buying solution.
      tags:
      - Requisitions
      parameters:
      - name: realm
        in: query
        required: true
        description: The SAP Ariba realm name identifying your site.
        schema:
          type: string
        example: mycompany-T
      responses:
        '200':
          description: Successfully retrieved count of asset requisitions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountResponse'
              examples:
                countAssetRequisitions200Example:
                  summary: Default countAssetRequisitions 200 response
                  x-microcks-default: true
                  value:
                    count: 42
        '400':
          description: Bad Request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - invalid or missing credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /requisitions/batch/assets:
    post:
      operationId: updateAssetLineItems
      summary: Ariba Guided Buying Update Asset Line Items on Requisitions
      description: Update the Asset field for asset items on requisitions with unique asset values. The requisitions in which all asset items are assigned with unique asset values move under the Completed tab in the Asset Workbench and purchase orders are created after those requisitions are fully approved. Maximum 20 records per request.
      tags:
      - Requisitions
      parameters:
      - name: realm
        in: query
        required: true
        description: The SAP Ariba realm name identifying your site.
        schema:
          type: string
        example: mycompany-T
      requestBody:
        required: true
        description: Batch of asset line item updates.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchAssetUpdateRequest'
            examples:
              updateAssetLineItemsRequestExample:
                summary: Default updateAssetLineItems request
                x-microcks-default: true
                value:
                  updates:
                  - requisitionId: REQ-500123
                    lineItemId: LINE-001
                    assetNumber: ASSET-001234
      responses:
        '200':
          description: Successfully updated asset line items.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchUpdateResponse'
              examples:
                updateAssetLineItems200Example:
                  summary: Default updateAssetLineItems 200 response
                  x-microcks-default: true
                  value:
                    processed: 1
                    succeeded: 1
                    failed: 0
        '400':
          description: Bad Request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - invalid or missing credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    RequisitionsResponse:
      title: RequisitionsResponse
      description: Response containing a list of asset requisitions.
      type: object
      properties:
        count:
          type: integer
          description: Total count of requisitions.
          example: 1
        requisitions:
          type: array
          description: List of requisitions with asset line items.
          items:
            $ref: '#/components/schemas/Requisition'
    Requisition:
      title: Requisition
      description: A purchase requisition with asset line items.
      type: object
      properties:
        id:
          type: string
          description: Requisition identifier.
          example: REQ-500123
        title:
          type: string
          description: Requisition title or description.
          example: Office Equipment Purchase
        status:
          type: string
          description: Current status of the requisition.
          example: InProgress
          enum:
          - InProgress
          - Completed
          - Approved
          - Pending
        createdDate:
          type: string
          format: date-time
          description: Date and time the requisition was created.
          example: '2026-01-15T09:00:00Z'
        updatedDate:
          type: string
          format: date-time
          description: Date and time the requisition was last updated.
          example: '2026-01-16T10:00:00Z'
        lineItems:
          type: array
          description: Line items in the requisition.
          items:
            $ref: '#/components/schemas/AssetLineItem'
    BatchAssetUpdateRequest:
      title: BatchAssetUpdateRequest
      description: Request body for batch asset line item updates.
      type: object
      required:
      - updates
      properties:
        updates:
          type: array
          description: List of asset line item updates. Maximum 20 records.
          items:
            $ref: '#/components/schemas/AssetLineItemUpdate'
    AssetLineItemUpdate:
      title: AssetLineItemUpdate
      description: An individual asset line item update.
      type: object
      required:
      - requisitionId
      - lineItemId
      - assetNumber
      properties:
        requisitionId:
          type: string
          description: Requisition identifier.
          example: REQ-500123
        lineItemId:
          type: string
          description: Line item identifier within the requisition.
          example: LINE-001
        assetNumber:
          type: string
          description: Unique asset number assigned to this line item.
          example: ASSET-001234
    ErrorResponse:
      title: ErrorResponse
      description: Error response.
      type: object
      properties:
        code:
          type: integer
          description: HTTP status code.
          example: 400
        message:
          type: string
          description: Error message.
          example: Bad Request
    BatchUpdateResponse:
      title: BatchUpdateResponse
      description: Response for batch asset line item update.
      type: object
      properties:
        processed:
          type: integer
          description: Total number of records processed.
          example: 1
        succeeded:
          type: integer
          description: Number of records successfully updated.
          example: 1
        failed:
          type: integer
          description: Number of records that failed to update.
          example: 0
    CountResponse:
      title: CountResponse
      description: Response containing count of asset requisitions.
      type: object
      properties:
        count:
          type: integer
          description: Total count of asset requisitions.
          example: 42
    AssetLineItem:
      title: AssetLineItem
      description: An asset line item on a requisition.
      type: object
      properties:
        lineItemId:
          type: string
          description: Line item identifier.
          example: LINE-001
        description:
          type: string
          description: Line item description.
          example: Laptop Computer
        assetCategory:
          type: string
          description: Asset category classification.
          example: IT Equipment
        quantity:
          type: integer
          description: Quantity ordered.
          example: 1
        assetNumber:
          type: string
          description: Assigned asset number (populated after update).
          example: ASSET-001234
  securitySchemes:
    OAuth2:
      type: oauth2
      description: OAuth 2.0 authentication. Obtain access token from https://api.ariba.com/v2/oauth/token using client credentials.
      flows:
        clientCredentials:
          tokenUrl: https://api.ariba.com/v2/oauth/token
          scopes: {}