Optimizely Requisitions API

The Requisitions API from Optimizely — 4 operation(s) for requisitions.

Documentation GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v1/requisitions List purchase requisitions · Requisitions V1 get collection async #

Ask an LLM

“Which purchase requisitions are waiting for my approval?”

“Can I have prices recalculated when listing requisitions?”

Tell an agent

List my requisitions.

List requisitions page {page} with {pageSize} per page and recalculate prices: {recalculatePrice}.

GET /api/v1/requisitions/{requisitionId} Get one purchase requisition · Requisitions V1 get async #

Ask an LLM

“How do I open a single requisition to review it?”

“What does a requisition look like when I fetch it by ID?”

Tell an agent

Get requisition {requisitionId}.

Show me requisition {requisitionId} for review.

GET /api/v1/requisitions/{RequisitionId}/requisitionlines List the lines on a requisition · Requisition lines V1 get collection async #

Ask an LLM

“Which products and quantities are on a requisition?”

“Can I sort and page the lines of a requisition?”

Tell an agent

List the lines on requisition {RequisitionId}.

List lines of requisition {RequisitionId} sorted by {sort}.

GET /api/v1/requisitions/{requisitionId}/requisitionlines/{requisitionLineId} Get one requisition line · Requisition lines V1 get async #

Ask an LLM

“How do I see who requested a specific line item and when?”

“Can I fetch a single line from a requisition by its line ID?”

Tell an agent

Get line {requisitionLineId} of requisition {requisitionId}.

Show who ordered line {requisitionLineId} on requisition {requisitionId}.

DELETE /api/v1/requisitions/{requisitionId}/requisitionlines/{requisitionLineId} Remove a line from a requisition · Requisition lines V1 delete async #

Ask an LLM

“How do I reject or drop one line item from a requisition?”

“Can I delete a single requested item without discarding the whole requisition?”

Tell an agent destructive · confirm first

Delete line {requisitionLineId} from requisition {requisitionId}.

Drop requested item {requisitionLineId} on requisition {requisitionId}.

PATCH /api/v1/requisitions/{requisitionId}/requisitionlines/{requisitionLineId} Change quantity or cost code on a requisition line · Requisition lines V1 patch async #

Ask an LLM

“Can I change the quantity requested on a requisition line before approving it?”

“How do I assign a cost code to a requisition line?”

Tell an agent

Set quantity {qtyOrdered} on line {requisitionLineId} of requisition {requisitionId}.

Apply cost code {costCode} to line {requisitionLineId} on requisition {requisitionId}.

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/openapi/optimizely-requisitions-api-openapi.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/optimizely:optimizely-requisitions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

openapi: 3.2.0
info:
  version: storefront-v1
  title: Storefront API V1 Requisitions API
servers:
- url: https://dogfood.commerce.insitesandbox.com
security: []
tags:
- name: Requisitions
paths:
  /api/v1/requisitions:
    get:
      tags:
      - Requisitions
      operationId: RequisitionsV1_GetCollectionAsync
      parameters:
      - name: parameter.currentPage
        in: query
        required: false
        schema:
          type: integer
          format: int32
      - name: parameter.page
        in: query
        required: false
        schema:
          type: integer
          format: int32
      - name: parameter.pageSize
        in: query
        required: false
        schema:
          type: integer
          format: int32
      - name: parameter.recalculatePrice
        in: query
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionCollectionModel'
            text/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionCollectionModel'
            application/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionCollectionModel'
            text/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionCollectionModel'
            text/html:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionCollectionModel'
      security:
      - access_token: []
      summary: Requisitions V1 get collection async
      x-summary-source: derived
  /api/v1/requisitions/{requisitionId}:
    get:
      tags:
      - Requisitions
      operationId: RequisitionsV1_GetAsync
      parameters:
      - name: requisitionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            text/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            application/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            text/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            text/html:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
      security:
      - access_token: []
      summary: Requisitions V1 get async
      x-summary-source: derived
  /api/v1/requisitions/{RequisitionId}/requisitionlines:
    get:
      tags:
      - Requisitions
      operationId: RequisitionLinesV1_GetCollectionAsync
      parameters:
      - name: RequisitionId
        in: path
        required: true
        schema:
          type: string
      - name: parameter.requisitionId
        in: query
        required: false
        schema:
          type: string
          format: uuid
      - name: parameter.page
        in: query
        required: false
        schema:
          type: integer
          format: int32
      - name: parameter.pageSize
        in: query
        required: false
        schema:
          type: integer
          format: int32
      - name: parameter.sort
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineCollectionModel'
            text/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineCollectionModel'
            application/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineCollectionModel'
            text/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineCollectionModel'
            text/html:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineCollectionModel'
      security:
      - access_token: []
      summary: Requisition lines V1 get collection async
      x-summary-source: derived
  /api/v1/requisitions/{requisitionId}/requisitionlines/{requisitionLineId}:
    get:
      tags:
      - Requisitions
      operationId: RequisitionLinesV1_GetAsync
      parameters:
      - name: requisitionId
        in: path
        required: true
        schema:
          type: string
      - name: requisitionLineId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
            text/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
            application/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
            text/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
            text/html:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
      security:
      - access_token: []
      summary: Requisition lines V1 get async
      x-summary-source: derived
    delete:
      tags:
      - Requisitions
      operationId: RequisitionLinesV1_DeleteAsync
      parameters:
      - name: requisitionId
        in: path
        required: true
        schema:
          type: string
      - name: requisitionLineId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            text/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            application/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            text/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            text/html:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
      security:
      - access_token: []
      summary: Requisition lines V1 delete async
      x-summary-source: derived
    patch:
      tags:
      - Requisitions
      operationId: RequisitionLinesV1_PatchAsync
      parameters:
      - name: requisitionId
        in: path
        required: true
        schema:
          type: string
      - name: requisitionLineId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
          text/json:
            schema:
              $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
          application/xml:
            schema:
              $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
          text/xml:
            schema:
              $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
          text/html:
            schema:
              $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            text/json:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            application/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            text/xml:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
            text/html:
              schema:
                $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
      security:
      - access_token: []
      summary: Requisition lines V1 patch async
      x-summary-source: derived
components:
  schemas:
    Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineCollectionModel:
      type: object
      properties:
        uri:
          type: string
        requisitionLines:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel'
        pagination:
          $ref: '#/components/schemas/Insite.Core.WebApi.PaginationModel'
        properties:
          type: object
          additionalProperties:
            type: string
    Insite.Catalog.Services.Dtos.BrandDto:
      type: object
      properties:
        id:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        name:
          type: string
        urlSegment:
          type: string
        logoSmallImagePath:
          type: string
        logoLargeImagePath:
          type: string
        logoImageAltText:
          type: string
        detailPagePath:
          type: string
    Insite.Core.WebApi.SortOptionModel:
      type: object
      properties:
        displayName:
          type: string
        sortType:
          type: string
    Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineModel:
      type: object
      properties:
        uri:
          type: string
        id:
          type: string
        costCode:
          type: string
        firstName:
          type: string
        lastName:
          type: string
        userName:
          type: string
        orderDate:
          format: date-time
          type: string
        qtyOrdered:
          format: decimal
          type: number
        brand:
          $ref: '#/components/schemas/Insite.Catalog.Services.Dtos.BrandDto'
        properties:
          type: object
          additionalProperties:
            type: string
    Insite.Core.Plugins.Pricing.ProductPriceDto:
      type: object
      properties:
        productId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        isOnSale:
          type: boolean
        requiresRealTimePrice:
          type: boolean
        additionalResults:
          type: object
          additionalProperties:
            type: string
        unitCost:
          format: decimal
          type: number
        unitCostDisplay:
          type: string
        unitListPrice:
          format: decimal
          type: number
        unitListPriceDisplay:
          type: string
        extendedUnitListPrice:
          format: decimal
          type: number
        extendedUnitListPriceDisplay:
          type: string
        unitRegularPrice:
          format: decimal
          type: number
        unitRegularPriceDisplay:
          type: string
        extendedUnitRegularPrice:
          format: decimal
          type: number
        extendedUnitRegularPriceDisplay:
          type: string
        unitNetPrice:
          format: decimal
          type: number
        unitNetPriceDisplay:
          type: string
        extendedUnitNetPrice:
          format: decimal
          type: number
        extendedUnitNetPriceDisplay:
          type: string
        unitOfMeasure:
          type: string
        vatRate:
          format: decimal
          type: number
        vatAmount:
          format: decimal
          type: number
        vatAmountDisplay:
          type: string
        unitListBreakPrices:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Core.Plugins.Pricing.BreakPriceDto'
        unitRegularBreakPrices:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Core.Plugins.Pricing.BreakPriceDto'
        regularPrice:
          format: decimal
          type: number
          readOnly: true
        regularPriceDisplay:
          type: string
          readOnly: true
        extendedRegularPrice:
          format: decimal
          type: number
          readOnly: true
        extendedRegularPriceDisplay:
          type: string
          readOnly: true
        actualPrice:
          format: decimal
          type: number
          readOnly: true
        actualPriceDisplay:
          type: string
          readOnly: true
        extendedActualPrice:
          format: decimal
          type: number
          readOnly: true
        extendedActualPriceDisplay:
          type: string
          readOnly: true
        regularBreakPrices:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Core.Plugins.Pricing.BreakPriceDto'
          readOnly: true
        actualBreakPrices:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Core.Plugins.Pricing.BreakPriceDto'
          readOnly: true
        unitListPriceWithVat:
          format: decimal
          type: number
        unitListPriceWithVatDisplay:
          type: string
        extendedUnitListPriceWithVat:
          format: decimal
          type: number
        extendedUnitListPriceWithVatDisplay:
          type: string
        unitRegularPriceWithVat:
          format: decimal
          type: number
        unitRegularPriceWithVatDisplay:
          type: string
        extendedUnitRegularPriceWithVat:
          format: decimal
          type: number
        extendedUnitRegularPriceWithVatDisplay:
          type: string
        vatMinusExtendedUnitRegularPrice:
          format: decimal
          type: number
    Insite.Core.Plugins.Pricing.BreakPriceDto:
      type: object
      properties:
        breakQty:
          format: decimal
          type: number
        breakPrice:
          format: decimal
          type: number
        breakPriceDisplay:
          type: string
        savingsMessage:
          type: string
        breakPriceWithVat:
          format: decimal
          type: number
        breakPriceWithVatDisplay:
          type: string
    Insite.Requisition.WebApi.V1.ApiModels.RequisitionCollectionModel:
      type: object
      properties:
        uri:
          type: string
        requisitions:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel'
        pagination:
          $ref: '#/components/schemas/Insite.Core.WebApi.PaginationModel'
        properties:
          type: object
          additionalProperties:
            type: string
    Insite.Core.WebApi.PaginationModel:
      type: object
      properties:
        currentPage:
          format: int32
          type: integer
        page:
          format: int32
          type: integer
        pageSize:
          format: int32
          type: integer
        defaultPageSize:
          format: int32
          type: integer
        totalItemCount:
          format: int32
          type: integer
        numberOfPages:
          format: int32
          type: integer
        pageSizeOptions:
          type: array
          items:
            format: int32
            type: integer
        sortOptions:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Core.WebApi.SortOptionModel'
        sortType:
          type: string
        nextPageUri:
          type: string
        prevPageUri:
          type: string
        nextPageToken:
          type: string
    Insite.Cart.Services.Dtos.SectionOptionDto:
      type: object
      properties:
        sectionOptionId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        sectionName:
          type: string
        optionName:
          type: string
        productId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        cantBuy:
          type: boolean
        quantity:
          format: decimal
          type: number
    Insite.Requisition.WebApi.V1.ApiModels.RequisitionModel:
      required:
      - productId
      - qtyOrdered
      type: object
      properties:
        uri:
          type: string
        requisitionLinesUri:
          type: string
        isApproved:
          type: boolean
        requisitionLineCollection:
          $ref: '#/components/schemas/Insite.Requisition.WebApi.V1.ApiModels.RequisitionLineCollectionModel'
        productUri:
          type: string
        id:
          type: string
        line:
          format: int32
          type: integer
        productId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        requisitionId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        smallImagePath:
          type: string
        altText:
          type: string
        productName:
          type: string
        manufacturerItem:
          type: string
        customerName:
          type: string
        shortDescription:
          type: string
        erpNumber:
          type: string
        unitOfMeasure:
          type: string
        unitOfMeasureDisplay:
          type: string
        unitOfMeasureDescription:
          type: string
        baseUnitOfMeasure:
          type: string
        baseUnitOfMeasureDisplay:
          type: string
        qtyPerBaseUnitOfMeasure:
          format: decimal
          type: number
        costCode:
          type: string
        notes:
          type: string
        qtyOrdered:
          format: double
          type: number
        qtyLeft:
          format: decimal
          type: number
        pricing:
          $ref: '#/components/schemas/Insite.Core.Plugins.Pricing.ProductPriceDto'
        isPromotionItem:
          type: boolean
        isDiscounted:
          type: boolean
        isConfigured:
          type: boolean
        isFixedConfiguration:
          type: boolean
        quoteRequired:
          type: boolean
        breakPrices:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Core.Plugins.Pricing.BreakPriceDto'
        sectionOptions:
          type: array
          items:
            $ref: '#/components/schemas/Insite.Cart.Services.Dtos.SectionOptionDto'
        availability:
          $ref: '#/components/schemas/Insite.Catalog.Services.Dtos.AvailabilityDto'
        qtyOnHand:
          format: decimal
          type: number
        canAddToCart:
          type: boolean
        isQtyAdjusted:
          type: boolean
        hasInsufficientInventory:
          type: boolean
        canBackOrder:
          type: boolean
        trackInventory:
          type: boolean
        salePriceLabel:
          type: string
        cantBuy:
          type: boolean
        isSubscription:
          type: boolean
        productSubscription:
          $ref: '#/components/schemas/Insite.Catalog.Services.Dtos.ProductSubscriptionDto'
        isRestricted:
          type: boolean
        canAddToWishlist:
          type: boolean
        isActive:
          type: boolean
        brand:
          $ref: '#/components/schemas/Insite.Catalog.Services.Dtos.BrandDto'
        vmiBinId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        isDiscontinued:
          type: boolean
        allowZeroPricing:
          type: boolean
        parentProductErpNumber:
          type: string
        properties:
          type: object
          additionalProperties:
            type: string
    Insite.Catalog.Services.Dtos.AvailabilityDto:
      type: object
      properties:
        messageType:
          format: int32
          enum:
          - 0
          - 1
          - 2
          - 3
          type: integer
        message:
          type: string
        requiresRealTimeInventory:
          type: boolean
    Insite.Catalog.Services.Dtos.ProductSubscriptionDto:
      type: object
      properties:
        subscriptionAddToInitialOrder:
          type: boolean
        subscriptionAllMonths:
          type: boolean
        subscriptionApril:
          type: boolean
        subscriptionAugust:
          type: boolean
        subscriptionCyclePeriod:
          type: string
        subscriptionDecember:
          type: boolean
        subscriptionFebruary:
          type: boolean
        subscriptionFixedPrice:
          type: boolean
        subscriptionJanuary:
          type: boolean
        subscriptionJuly:
          type: boolean
        subscriptionJune:
          type: boolean
        subscriptionMarch:
          type: boolean
        subscriptionMay:
          type: boolean
        subscriptionNovember:
          type: boolean
        subscriptionOctober:
          type: boolean
        subscriptionPeriodsPerCycle:
          format: int32
          type: integer
        subscriptionSeptember:
          type: boolean
        subscriptionShipViaId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        subscriptionTotalCycles:
          format: int32
          type: integer
  securitySchemes:
    access_token:
      type: apiKey
      description: Token used to access storefront API.
      name: access_token
      in: query