> 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-approval-requests.md).

# Procurement | Approval Requests

## GET /v1/procurement/approval-requests

> Get a list of approval requests with different filters

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Approval-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/approval-requests":{"get":{"tags":["Procurement | Approval-Requests"],"summary":"Get a list of approval requests with different filters","parameters":[{"name":"assignedTo","in":"query","description":"Return all approval requests that are assigned to a specific person","schema":{"type":"integer","format":"int32"}},{"name":"assignedToGroup","in":"query","description":"Return all approval requests that are assigned to a specific person","schema":{"type":"integer","format":"int32"}},{"name":"requestedBy","in":"query","description":"Not implemented!","schema":{"type":"integer","format":"int32"}},{"name":"procurementRequest","in":"query","description":"","schema":{"type":"integer","format":"int32"}},{"name":"status","in":"query","description":"Not implemented!","schema":{"type":"array","items":{"type":"string"}}},{"name":"search","in":"query","description":"","schema":{"type":"string"}},{"name":"page","in":"query","description":"Not implemented!","schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","description":"Not implemented!","schema":{"type":"integer","format":"int32","default":500}}],"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"}}}}}}}}}
```

## POST /v1/procurement/approval-requests

>

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Approval-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":{"ApprovalRequestCreateRequest":{"type":"object","properties":{"approvalRequest":{"$ref":"#/components/schemas/ApprovalRequestCreate"}},"additionalProperties":false,"description":"Create a new approval request task. This task can be assigned to a specific employee or a group of\nemployees. An approval task can be linked to a cart item (procurement request)."},"ApprovalRequestCreate":{"type":"object","properties":{"procurementRequestReference":{"type":"array","items":{"type":"integer","format":"int32"},"description":"The procurement requests (SALES.CartItems) for which the approval should be processed","nullable":true},"predecessorRequest":{"type":"integer","description":"The ID of the predecessor approval request if there is one. Create a link between two requests for\ninformational purpose and history.","format":"int32","nullable":true},"requestedBy":{"type":"integer","description":"The user requesting the procurement order","format":"int32"},"requestedFor":{"type":"integer","description":"The user for whom the approval request is created","format":"int32"},"assignedTo":{"type":"integer","description":"The user who should authorize the request","format":"int32","nullable":true},"assignedToGroup":{"type":"integer","description":"The group of users which should authorize the request","format":"int32","nullable":true},"title":{"type":"string","description":"A short title which describes the approval source","nullable":true},"description":{"type":"string","description":"More details on the request","nullable":true},"priority":{"type":"string","description":"A priority which indicates the urgency of the request","nullable":true},"dueDate":{"type":"string","description":"Deadline for the approval","format":"date-time","nullable":true},"workflowName":{"type":"string","description":"Optional: The name of the workflow which triggered the approval","nullable":true},"workflowUrl":{"type":"string","description":"Webhook URL to the source workflow","nullable":true},"requestCorrelation":{"type":"string","description":"This correlation can be used to group requests of one approval step together.\nFor example, if multiple approval requests for multiple department mangers are created for one procurement request, the correlation ID can be used to link those together.","format":"uuid"}},"additionalProperties":false,"description":"Data transfer object for creating a new approval request"},"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/approval-requests":{"post":{"tags":["Procurement | Approval-Requests"],"requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestCreateRequest"}},"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestCreateRequest"}},"text/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestCreateRequest"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestCreateRequest"}}}},"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"}}}}}}}}}
```

## GET /v1/procurement/approval-requests/{id}

>

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Approval-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/approval-requests/{id}":{"get":{"tags":["Procurement | Approval-Requests"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"language","in":"query","schema":{"type":"string"}}],"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"}}}}}}}}}
```

## PATCH /v1/procurement/approval-requests/{id}

>

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Approval-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":{"ApprovalRequestPatchRequest":{"type":"object","properties":{"patchDocument":{"$ref":"#/components/schemas/JsonPatchDocument_ApprovalRequestPatch"}},"additionalProperties":false},"JsonPatchDocument_ApprovalRequestPatch":{"type":"object","properties":{"operations":{"type":"array","items":{"$ref":"#/components/schemas/Operation_ApprovalRequestPatch"},"nullable":true}},"additionalProperties":false},"Operation_ApprovalRequestPatch":{"type":"object","properties":{"value":{"nullable":true},"path":{"type":"string","nullable":true},"op":{"type":"string","nullable":true},"from":{"type":"string","nullable":true}},"additionalProperties":false},"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/approval-requests/{id}":{"patch":{"tags":["Procurement | Approval-Requests"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"content":{"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestPatchRequest"}},"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestPatchRequest"}},"text/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestPatchRequest"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/ApprovalRequestPatchRequest"}}}},"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"}}}}}}}}}
```

## GET /v1/procurement/approval-requests/{id}/history

>

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Approval-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/approval-requests/{id}/history":{"get":{"tags":["Procurement | Approval-Requests"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int32"}}],"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"}}}}}}}}}
```

## GET /v1/procurement/my-approval-requests

> Get a list of approval requests with different filters

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Approval-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/my-approval-requests":{"get":{"tags":["Procurement | Approval-Requests"],"summary":"Get a list of approval requests with different filters","parameters":[{"name":"assignedToGroup","in":"query","description":"Return all approval requests that are assigned to a specific person","schema":{"type":"integer","format":"int32"}},{"name":"requestedByMe","in":"query","description":"","schema":{"type":"boolean","default":false}},{"name":"status","in":"query","description":"Not implemented!","schema":{"type":"string"}},{"name":"language","in":"query","description":"User's selected Language","schema":{"type":"string"}}],"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"}}}}}}}}}
```

## GET /v1/procurement/pending-approval-requests

>

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Procurement | Approval-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/pending-approval-requests":{"get":{"tags":["Procurement | Approval-Requests"],"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"}}}}}}}}}
```


---

# 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-approval-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.