> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/development/api-reference-app/procurement-or-requests.md).

# Procurement | Requests

## GET /v1/procurement/requests

> Retrieve a list of procurement requests.

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Requests"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.","name":"X-API-KEY","in":"header"}},"schemas":{"RequestList":{"required":["items","self","total"],"type":"object","properties":{"previous":{"$ref":"#/components/schemas/ResourceLink"},"next":{"$ref":"#/components/schemas/ResourceLink"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Request"},"description":"The list of result items."},"total":{"type":"integer","description":"The total number of items.","format":"int32"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"ResourceLink":{"required":["href"],"type":"object","properties":{"href":{"minLength":1,"type":"string","description":"The target resource URI."},"method":{"type":"string","description":"The HTTP method to use for the request.","nullable":true}},"additionalProperties":false},"Request":{"required":["created","id","self"],"type":"object","properties":{"created":{"type":"string","description":"UTC date of request creation.","format":"date-time"},"requestedBy":{"$ref":"#/components/schemas/EmployeeReference"},"assignedLocation":{"$ref":"#/components/schemas/LocationReference"},"assignedGroup":{"$ref":"#/components/schemas/GroupReference"},"assignedEmployee":{"$ref":"#/components/schemas/EmployeeReference"},"totalOneTimeCosts":{"type":"number","description":"Total one-time costs of all items in the request.","format":"double"},"totalRecurringCosts":{"type":"number","description":"Total recurring costs of all items in the request.","format":"double"},"subscriptionPeriod":{"type":"integer","description":"The minimum subscription period (in months) for the requested instance.","format":"int32","nullable":true},"subscriptionPeriodRenewal":{"type":"integer","description":"Number of months a subscription is renewed after its expiration time if it has not been terminated.","format":"int32","nullable":true},"items":{"type":"array","items":{"$ref":"#/components/schemas/RequestItem"},"description":"The requested items. See RequestItem model for details what kind of items can be requested.","nullable":true},"approved":{"type":"boolean","description":"Indicates if the request is approved or rejected"},"justification":{"type":"string","description":"Reason given by the user who created the procurement request","nullable":true},"deliveryAddress":{"type":"string","description":"The current delivery address for the requested items as an address string","nullable":true},"costCenterCode":{"type":"string","description":"Cost Center assigned to the procurement request","nullable":true},"costCenterId":{"type":"integer","description":"The identifier of the associated cost center.","format":"int32","nullable":true},"id":{"type":"integer","description":"The identifier of the request.","format":"int32"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"EmployeeReference":{"required":["id","self","username"],"type":"object","properties":{"id":{"type":"integer","description":"The identifier of the employee.","format":"int32"},"firstName":{"maxLength":100,"minLength":0,"type":"string","description":"The first/given name of the employee.","nullable":true},"lastName":{"maxLength":100,"minLength":0,"type":"string","description":"The last/family name of the employee.","nullable":true},"fullName":{"maxLength":150,"minLength":0,"type":"string","description":"Combination of last and firstname","nullable":true,"readOnly":true},"email":{"maxLength":100,"minLength":0,"type":"string","description":"The contact and login mail address.","nullable":true},"username":{"maxLength":100,"minLength":0,"pattern":"^[a-zA-Z0-9.!#$%&’*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*\\.[a-zA-Z]{2,}$","type":"string","description":"The username to log in to the app. The value has to be an e-mail address."},"costCenter":{"maxLength":100,"minLength":0,"type":"string","description":"The cost center of the employee.","nullable":true},"costCenterId":{"type":"integer","description":"The identifier of the cost center.","format":"int32","nullable":true},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"LocationReference":{"required":["id","name","self","type"],"type":"object","properties":{"id":{"type":"integer","description":"The identifier of the company location.","format":"int32"},"name":{"maxLength":100,"minLength":0,"type":"string","description":"The name of the company location."},"type":{"$ref":"#/components/schemas/LocationType"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false,"description":"A location can either be a company location or a work from home location."},"LocationType":{"enum":["location","warehouse","remoteWork"],"type":"string","description":"The type of location."},"GroupReference":{"required":["id","name","self"],"type":"object","properties":{"id":{"type":"integer","description":"The id to identify the group in the system.","format":"int32"},"name":{"maxLength":50,"minLength":0,"type":"string","description":"The name of the group."},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"RequestItem":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/RequestItemType"},"action":{"$ref":"#/components/schemas/RequestItemAction"},"service":{"$ref":"#/components/schemas/ServiceProductReference"},"options":{"type":"array","items":{"$ref":"#/components/schemas/ServiceProductOptionReference"},"description":"Reference to the service-options","nullable":true},"offer":{"$ref":"#/components/schemas/SalesOfferReference"},"targetInstance":{"$ref":"#/components/schemas/ServiceInstanceReference"},"note":{"type":"string","description":"A note on the request. Supports html formatted text including inline css styles.","nullable":true},"preferredProvisionDate":{"type":"string","description":"The preferred provision date (UTC).","format":"date-time","nullable":true}},"additionalProperties":false},"RequestItemType":{"enum":["service","option","software","addon"],"type":"string","description":"Type of a procurement request item"},"RequestItemAction":{"enum":["delivery","order","change","cancellation","other"],"type":"string"},"ServiceProductReference":{"required":["id","name","self"],"type":"object","properties":{"id":{"type":"integer","description":"The identifier of the service.","format":"int32"},"name":{"minLength":1,"type":"string","description":"The name of the service."},"category":{"type":"string","description":"The category of the service. Comes from the marketplace ProductDisplayGroup","nullable":true},"ean":{"type":"string","description":"Value to identify the service in other systems. E.g. when an other system is the source of this service. (Max. 50 characters)","nullable":true},"externalId":{"type":"string","description":"Value to identify the service in other systems. E.g. when an other system is the source of this service.","nullable":true},"supplierName":{"type":"string","description":"The supplier for this service product","nullable":true},"previewImageLink":{"type":"string","description":"Link to a small preview image for the product","nullable":true},"type":{"$ref":"#/components/schemas/ServiceProductType"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"ServiceProductType":{"enum":["service","addon","foundation_service"],"type":"string","description":"Services can take on different types that define their meaning and process flows within the system."},"ServiceProductOptionReference":{"required":["self"],"type":"object","properties":{"id":{"type":"integer","description":"The record id of the product option","format":"int32"},"name":{"type":"string","description":"The name of the product option","nullable":true},"versionId":{"type":"integer","description":"The record id of the production option version","format":"int32"},"versionName":{"type":"string","description":"The name of the version associated with the service product option.","nullable":true},"action":{"$ref":"#/components/schemas/RequestItemAction"},"offer":{"$ref":"#/components/schemas/SalesOfferReference"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/ServiceProductOptionVersionReference"},"description":"All available (non-removed) versions for this option, including their pricing.\nOnly populated when includeAllOptionVersions=true is passed to the endpoint.","nullable":true},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"SalesOfferReference":{"required":["id","purchasePrice","recurringPrice","self","subscriptionPeriod","type"],"type":"object","properties":{"id":{"type":"integer","description":"The id to identify the offer in the system.","format":"int64"},"type":{"$ref":"#/components/schemas/OfferType"},"purchasePrice":{"maximum":1.7976931348623157e+308,"minimum":0,"type":"number","description":"The price charged only once after providing the item.","format":"double"},"recurringPrice":{"maximum":1.7976931348623157e+308,"minimum":0,"type":"number","description":"The price charged monthly after providing the item for the subscription period","format":"double"},"subscriptionPeriod":{"maximum":2147483647,"minimum":0,"type":"integer","description":"The minimum subscription period (in month) for rental offers.","format":"int32"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"OfferType":{"enum":["rental","lease","purchase","subscription","leasing"],"type":"string"},"ServiceProductOptionVersionReference":{"type":"object","properties":{"id":{"type":"integer","description":"The record id of the product option version.","format":"int32"},"versionName":{"type":"string","description":"The name of the version.","nullable":true},"purchasePrice":{"type":"number","description":"One-time purchase price for this version.","format":"double"},"recurringPrice":{"type":"number","description":"Recurring price for this version.","format":"double"}},"additionalProperties":false},"ServiceInstanceReference":{"required":["id","self"],"type":"object","properties":{"id":{"type":"integer","description":"The id to identify the service instance in the system.","format":"int32"},"inventoryNumber":{"maxLength":50,"minLength":0,"type":"string","description":"The inventory number of the service instance.","nullable":true},"costCenter":{"type":"string","description":"The name of the cost center to which the service instance belongs.","nullable":true},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"errorCode":{"type":"string","nullable":true},"errorDescription":{"type":"string","nullable":true},"data":{"nullable":true}},"additionalProperties":false}}},"paths":{"/v1/procurement/requests":{"get":{"tags":["Procurement | Requests"],"summary":"Retrieve a list of procurement requests.","parameters":[{"name":"createdAfter","in":"query","description":"Filter the requests created after the specified date.","schema":{"type":"string","format":"date-time"}},{"name":"offset","in":"query","description":"Specifies the index of the first item to return","schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","description":"Specifies the maximum number of items to return (min: 1; max: 1000)","schema":{"type":"integer","format":"int32","default":100}}],"responses":{"200":{"description":"OK: Returns a list of procurement requests.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestList"}}}},"400":{"description":"Bad request: See response message for details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized: Invalid api key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden: Resource access denied or resource does not exist anymore.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## POST /v1/procurement/requests

> Adds items (procurement requests) to the cart (approvals) for a given tenant.

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Requests"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.","name":"X-API-KEY","in":"header"}},"schemas":{"CreateRequestRequest":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/CreateRequestItem"},"nullable":true}},"additionalProperties":false},"CreateRequestItem":{"type":"object","properties":{"requestAction":{"$ref":"#/components/schemas/RequestItemAction"},"requestedBy":{"type":"integer","description":"The user which created the request (Can be the same user, which is assigned, or another user which assigns orders for other employees.","format":"int32"},"locationAssignment":{"type":"integer","description":"The location assigned.","format":"int32","nullable":true},"employeeAssignment":{"type":"integer","description":"The employee for which the order is placed.","format":"int32","nullable":true},"organizationalUnitAssignment":{"type":"integer","description":"Represents the unique identifier of the organizational unit associated with the cart item.\nThis property links the cart item to a specific organizational unit for tracking and management purposes.","format":"int32","nullable":true},"productOfferId":{"type":"integer","description":"The offer which should be ordered","format":"int32"},"requestedDeliveryDate":{"type":"string","description":"Desired delivery date","format":"date-time","nullable":true},"deviatingDeliveryAddress":{"$ref":"#/components/schemas/AddressCreateModel"},"note":{"type":"string","description":"Additional request notes","nullable":true}},"additionalProperties":false},"RequestItemAction":{"enum":["delivery","order","change","cancellation","other"],"type":"string"},"AddressCreateModel":{"required":["city","countryCode"],"type":"object","properties":{"line1":{"maxLength":100,"minLength":0,"type":"string","description":"First line of the address. e.g. company name or P.O. box.","nullable":true},"street":{"maxLength":100,"minLength":0,"type":"string","description":"The street name of the address.","nullable":true},"number":{"maxLength":30,"minLength":0,"type":"string","description":"The alphanumeric house number in the street.","nullable":true},"addition":{"maxLength":1500,"minLength":0,"type":"string","description":"Addition to the address (line 3) to provide further information for delivery.","nullable":true},"city":{"maxLength":100,"minLength":0,"type":"string","description":"The city name of the address."},"postalCode":{"maxLength":30,"minLength":0,"type":"string","description":"The alphanumeric postal code or zip of the address.","nullable":true},"countryCode":{"maxLength":2,"minLength":0,"type":"string","description":"ISO-3166-1 code of the country."},"regionCode":{"maxLength":10,"minLength":0,"type":"string","description":"ISO-3166-2 code of the region / administrative area. Required e.g. in USA, Canada, Australia or Italy.","nullable":true},"regionName":{"maxLength":100,"minLength":0,"type":"string","description":"Name of the region / administrative area (if no ISO code is given/existing).","nullable":true},"dependentLocality":{"maxLength":200,"minLength":0,"type":"string","description":"A dependent locality is an address element that distinguishes a premise when an address thoroughfare appears more than once in the same post town. PAF holds details of approximately 30,000 localities within the UK.","nullable":true},"phoneNumber":{"maxLength":50,"minLength":0,"type":"string","description":"Phone number of the address. Used primarily for delivery purposes.","nullable":true}},"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"errorCode":{"type":"string","nullable":true},"errorDescription":{"type":"string","nullable":true},"data":{"nullable":true}},"additionalProperties":false}}},"paths":{"/v1/procurement/requests":{"post":{"tags":["Procurement | Requests"],"summary":"Adds items (procurement requests) to the cart (approvals) for a given tenant.","requestBody":{"description":"The request object containing the items to be added to the cart.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequestRequest"}}}},"responses":{"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## GET /v1/procurement/requests/{requestId}

>

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Requests"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.","name":"X-API-KEY","in":"header"}},"schemas":{"RequestList":{"required":["items","self","total"],"type":"object","properties":{"previous":{"$ref":"#/components/schemas/ResourceLink"},"next":{"$ref":"#/components/schemas/ResourceLink"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Request"},"description":"The list of result items."},"total":{"type":"integer","description":"The total number of items.","format":"int32"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"ResourceLink":{"required":["href"],"type":"object","properties":{"href":{"minLength":1,"type":"string","description":"The target resource URI."},"method":{"type":"string","description":"The HTTP method to use for the request.","nullable":true}},"additionalProperties":false},"Request":{"required":["created","id","self"],"type":"object","properties":{"created":{"type":"string","description":"UTC date of request creation.","format":"date-time"},"requestedBy":{"$ref":"#/components/schemas/EmployeeReference"},"assignedLocation":{"$ref":"#/components/schemas/LocationReference"},"assignedGroup":{"$ref":"#/components/schemas/GroupReference"},"assignedEmployee":{"$ref":"#/components/schemas/EmployeeReference"},"totalOneTimeCosts":{"type":"number","description":"Total one-time costs of all items in the request.","format":"double"},"totalRecurringCosts":{"type":"number","description":"Total recurring costs of all items in the request.","format":"double"},"subscriptionPeriod":{"type":"integer","description":"The minimum subscription period (in months) for the requested instance.","format":"int32","nullable":true},"subscriptionPeriodRenewal":{"type":"integer","description":"Number of months a subscription is renewed after its expiration time if it has not been terminated.","format":"int32","nullable":true},"items":{"type":"array","items":{"$ref":"#/components/schemas/RequestItem"},"description":"The requested items. See RequestItem model for details what kind of items can be requested.","nullable":true},"approved":{"type":"boolean","description":"Indicates if the request is approved or rejected"},"justification":{"type":"string","description":"Reason given by the user who created the procurement request","nullable":true},"deliveryAddress":{"type":"string","description":"The current delivery address for the requested items as an address string","nullable":true},"costCenterCode":{"type":"string","description":"Cost Center assigned to the procurement request","nullable":true},"costCenterId":{"type":"integer","description":"The identifier of the associated cost center.","format":"int32","nullable":true},"id":{"type":"integer","description":"The identifier of the request.","format":"int32"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"EmployeeReference":{"required":["id","self","username"],"type":"object","properties":{"id":{"type":"integer","description":"The identifier of the employee.","format":"int32"},"firstName":{"maxLength":100,"minLength":0,"type":"string","description":"The first/given name of the employee.","nullable":true},"lastName":{"maxLength":100,"minLength":0,"type":"string","description":"The last/family name of the employee.","nullable":true},"fullName":{"maxLength":150,"minLength":0,"type":"string","description":"Combination of last and firstname","nullable":true,"readOnly":true},"email":{"maxLength":100,"minLength":0,"type":"string","description":"The contact and login mail address.","nullable":true},"username":{"maxLength":100,"minLength":0,"pattern":"^[a-zA-Z0-9.!#$%&’*+/=?^_`{|}~-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*\\.[a-zA-Z]{2,}$","type":"string","description":"The username to log in to the app. The value has to be an e-mail address."},"costCenter":{"maxLength":100,"minLength":0,"type":"string","description":"The cost center of the employee.","nullable":true},"costCenterId":{"type":"integer","description":"The identifier of the cost center.","format":"int32","nullable":true},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"LocationReference":{"required":["id","name","self","type"],"type":"object","properties":{"id":{"type":"integer","description":"The identifier of the company location.","format":"int32"},"name":{"maxLength":100,"minLength":0,"type":"string","description":"The name of the company location."},"type":{"$ref":"#/components/schemas/LocationType"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false,"description":"A location can either be a company location or a work from home location."},"LocationType":{"enum":["location","warehouse","remoteWork"],"type":"string","description":"The type of location."},"GroupReference":{"required":["id","name","self"],"type":"object","properties":{"id":{"type":"integer","description":"The id to identify the group in the system.","format":"int32"},"name":{"maxLength":50,"minLength":0,"type":"string","description":"The name of the group."},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"RequestItem":{"type":"object","properties":{"type":{"$ref":"#/components/schemas/RequestItemType"},"action":{"$ref":"#/components/schemas/RequestItemAction"},"service":{"$ref":"#/components/schemas/ServiceProductReference"},"options":{"type":"array","items":{"$ref":"#/components/schemas/ServiceProductOptionReference"},"description":"Reference to the service-options","nullable":true},"offer":{"$ref":"#/components/schemas/SalesOfferReference"},"targetInstance":{"$ref":"#/components/schemas/ServiceInstanceReference"},"note":{"type":"string","description":"A note on the request. Supports html formatted text including inline css styles.","nullable":true},"preferredProvisionDate":{"type":"string","description":"The preferred provision date (UTC).","format":"date-time","nullable":true}},"additionalProperties":false},"RequestItemType":{"enum":["service","option","software","addon"],"type":"string","description":"Type of a procurement request item"},"RequestItemAction":{"enum":["delivery","order","change","cancellation","other"],"type":"string"},"ServiceProductReference":{"required":["id","name","self"],"type":"object","properties":{"id":{"type":"integer","description":"The identifier of the service.","format":"int32"},"name":{"minLength":1,"type":"string","description":"The name of the service."},"category":{"type":"string","description":"The category of the service. Comes from the marketplace ProductDisplayGroup","nullable":true},"ean":{"type":"string","description":"Value to identify the service in other systems. E.g. when an other system is the source of this service. (Max. 50 characters)","nullable":true},"externalId":{"type":"string","description":"Value to identify the service in other systems. E.g. when an other system is the source of this service.","nullable":true},"supplierName":{"type":"string","description":"The supplier for this service product","nullable":true},"previewImageLink":{"type":"string","description":"Link to a small preview image for the product","nullable":true},"type":{"$ref":"#/components/schemas/ServiceProductType"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"ServiceProductType":{"enum":["service","addon","foundation_service"],"type":"string","description":"Services can take on different types that define their meaning and process flows within the system."},"ServiceProductOptionReference":{"required":["self"],"type":"object","properties":{"id":{"type":"integer","description":"The record id of the product option","format":"int32"},"name":{"type":"string","description":"The name of the product option","nullable":true},"versionId":{"type":"integer","description":"The record id of the production option version","format":"int32"},"versionName":{"type":"string","description":"The name of the version associated with the service product option.","nullable":true},"action":{"$ref":"#/components/schemas/RequestItemAction"},"offer":{"$ref":"#/components/schemas/SalesOfferReference"},"versions":{"type":"array","items":{"$ref":"#/components/schemas/ServiceProductOptionVersionReference"},"description":"All available (non-removed) versions for this option, including their pricing.\nOnly populated when includeAllOptionVersions=true is passed to the endpoint.","nullable":true},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"SalesOfferReference":{"required":["id","purchasePrice","recurringPrice","self","subscriptionPeriod","type"],"type":"object","properties":{"id":{"type":"integer","description":"The id to identify the offer in the system.","format":"int64"},"type":{"$ref":"#/components/schemas/OfferType"},"purchasePrice":{"maximum":1.7976931348623157e+308,"minimum":0,"type":"number","description":"The price charged only once after providing the item.","format":"double"},"recurringPrice":{"maximum":1.7976931348623157e+308,"minimum":0,"type":"number","description":"The price charged monthly after providing the item for the subscription period","format":"double"},"subscriptionPeriod":{"maximum":2147483647,"minimum":0,"type":"integer","description":"The minimum subscription period (in month) for rental offers.","format":"int32"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"OfferType":{"enum":["rental","lease","purchase","subscription","leasing"],"type":"string"},"ServiceProductOptionVersionReference":{"type":"object","properties":{"id":{"type":"integer","description":"The record id of the product option version.","format":"int32"},"versionName":{"type":"string","description":"The name of the version.","nullable":true},"purchasePrice":{"type":"number","description":"One-time purchase price for this version.","format":"double"},"recurringPrice":{"type":"number","description":"Recurring price for this version.","format":"double"}},"additionalProperties":false},"ServiceInstanceReference":{"required":["id","self"],"type":"object","properties":{"id":{"type":"integer","description":"The id to identify the service instance in the system.","format":"int32"},"inventoryNumber":{"maxLength":50,"minLength":0,"type":"string","description":"The inventory number of the service instance.","nullable":true},"costCenter":{"type":"string","description":"The name of the cost center to which the service instance belongs.","nullable":true},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"errorCode":{"type":"string","nullable":true},"errorDescription":{"type":"string","nullable":true},"data":{"nullable":true}},"additionalProperties":false}}},"paths":{"/v1/procurement/requests/{requestId}":{"get":{"tags":["Procurement | Requests"],"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"includeAllOptionVersions","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestList"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## DELETE /v1/procurement/requests/{requestId}

> Deletes a cart item with the specified identifier.

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Requests"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.","name":"X-API-KEY","in":"header"}},"schemas":{"NoContentResult":{"type":"object","properties":{"statusCode":{"type":"integer","format":"int32"}},"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"errorCode":{"type":"string","nullable":true},"errorDescription":{"type":"string","nullable":true},"data":{"nullable":true}},"additionalProperties":false}}},"paths":{"/v1/procurement/requests/{requestId}":{"delete":{"tags":["Procurement | Requests"],"summary":"Deletes a cart item with the specified identifier.","parameters":[{"name":"requestId","in":"path","description":"","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoContentResult"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## PATCH /v1/procurement/requests/{requestId}

> Updates the details of a specific item in the user's cart.

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Requests"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.","name":"X-API-KEY","in":"header"}},"schemas":{"UpdateRequestRequest":{"type":"object","properties":{"patchDocument":{"$ref":"#/components/schemas/JsonPatchDocument_ProcurementRequestPatch"}},"additionalProperties":false},"JsonPatchDocument_ProcurementRequestPatch":{"type":"object","properties":{"operations":{"type":"array","items":{"$ref":"#/components/schemas/Operation_ProcurementRequestPatch"},"nullable":true}},"additionalProperties":false},"Operation_ProcurementRequestPatch":{"type":"object","properties":{"value":{"nullable":true},"path":{"type":"string","nullable":true},"op":{"type":"string","nullable":true},"from":{"type":"string","nullable":true}},"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"errorCode":{"type":"string","nullable":true},"errorDescription":{"type":"string","nullable":true},"data":{"nullable":true}},"additionalProperties":false}}},"paths":{"/v1/procurement/requests/{requestId}":{"patch":{"tags":["Procurement | Requests"],"summary":"Updates the details of a specific item in the user's cart.","parameters":[{"name":"requestId","in":"path","description":"","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"description":"The request object containing the updated properties for the cart item.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequestRequest"}}}},"responses":{"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hub.equipme.io/development/api-reference-app/procurement-or-requests.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.