Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Procurement | Approval Requests

Get a list of approval requests with different filters

get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Query parameters
assignedTointeger · int32Optional

Return all approval requests that are assigned to a specific person

assignedToGroupinteger · int32Optional

Return all approval requests that are assigned to a specific group

requestedByinteger · int32Optional

Return all approval requests that were requested by a specific employee (employee id)

procurementRequestinteger · int32Optional

Return all approval requests that contain a specific procurement request (procurement request id)

statusstring[]Optional

Filter by one or more statuses: opened, pending, approved, rejected, cancelled, closed

searchstringOptional

Search term, matched against the title and the description

pageinteger · int32Optional

Page number, starting at 1

Default: 1
pageSizeinteger · int32Optional

Number of approval requests per page (default 500)

Default: 500
Responses
200

OK

application/json
totalinteger · int32Required
get/v1/procurement/approval-requests
GET /v1/procurement/approval-requests HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "created": "2026-01-01T00:00:00.000Z",
      "requestedBy": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedLocation": {
        "id": 1,
        "name": "HQ New York",
        "type": "location",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedGroup": {
        "id": 42,
        "name": "Project 1337",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedEmployee": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "totalOneTimeCosts": 12.98,
      "totalRecurringCosts": 1109.9,
      "subscriptionPeriod": 12,
      "subscriptionPeriodRenewal": 1,
      "items": [
        {
          "type": "service",
          "action": "delivery",
          "service": {
            "id": 4,
            "name": "Basic Plan",
            "category": "text",
            "ean": "0194253408253",
            "externalId": "E54363",
            "supplierName": "text",
            "previewImageLink": "text",
            "type": "service",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "options": [
            {
              "id": 1,
              "name": "text",
              "versionId": 1,
              "versionName": "text",
              "action": "delivery",
              "offer": {
                "id": 99,
                "type": "rental",
                "purchasePrice": 99.99,
                "recurringPrice": 19.99,
                "subscriptionPeriod": 12,
                "self": {
                  "href": "text",
                  "method": "text"
                }
              },
              "versions": [
                {
                  "id": 1,
                  "versionName": "text",
                  "purchasePrice": 1,
                  "recurringPrice": 1
                }
              ],
              "self": {
                "href": "text",
                "method": "text"
              }
            }
          ],
          "offer": {
            "id": 99,
            "type": "rental",
            "purchasePrice": 99.99,
            "recurringPrice": 19.99,
            "subscriptionPeriod": 12,
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "targetInstance": {
            "id": 42,
            "inventoryNumber": "EQ642",
            "costCenter": "4645-2343",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "cartTargetInstanceId": 1,
          "note": "This is just a <b>custom note</b>.",
          "preferredProvisionDate": "2026-01-01T00:00:00.000Z"
        }
      ],
      "approved": true,
      "justification": "text",
      "deliveryAddress": "text",
      "costCenterCode": "text",
      "costCenterId": 1,
      "id": 451,
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}
post
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Body

Create a new approval request task. This task can be assigned to a specific employee or a group of employees. An approval task can be linked to a cart item (procurement request).

Responses
200

OK

application/json
totalinteger · int32Required
post/v1/procurement/approval-requests
POST /v1/procurement/approval-requests HTTP/1.1
X-API-KEY: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 415

{
  "approvalRequest": {
    "procurementRequestReference": [
      1
    ],
    "predecessorRequest": 1,
    "openingNotes": "text",
    "justification": "text",
    "requestedBy": 1,
    "requestedFor": 1,
    "assignedTo": 1,
    "approver": [
      1
    ],
    "observer": [
      1
    ],
    "assignedToGroup": 1,
    "title": "text",
    "description": "text",
    "priority": "text",
    "dueDate": "2026-01-01T00:00:00.000Z",
    "workflowName": "text",
    "workflowUrl": "text",
    "requestCorrelation": "123e4567-e89b-12d3-a456-426614174000"
  }
}
{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "created": "2026-01-01T00:00:00.000Z",
      "requestedBy": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedLocation": {
        "id": 1,
        "name": "HQ New York",
        "type": "location",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedGroup": {
        "id": 42,
        "name": "Project 1337",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedEmployee": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "totalOneTimeCosts": 12.98,
      "totalRecurringCosts": 1109.9,
      "subscriptionPeriod": 12,
      "subscriptionPeriodRenewal": 1,
      "items": [
        {
          "type": "service",
          "action": "delivery",
          "service": {
            "id": 4,
            "name": "Basic Plan",
            "category": "text",
            "ean": "0194253408253",
            "externalId": "E54363",
            "supplierName": "text",
            "previewImageLink": "text",
            "type": "service",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "options": [
            {
              "id": 1,
              "name": "text",
              "versionId": 1,
              "versionName": "text",
              "action": "delivery",
              "offer": {
                "id": 99,
                "type": "rental",
                "purchasePrice": 99.99,
                "recurringPrice": 19.99,
                "subscriptionPeriod": 12,
                "self": {
                  "href": "text",
                  "method": "text"
                }
              },
              "versions": [
                {
                  "id": 1,
                  "versionName": "text",
                  "purchasePrice": 1,
                  "recurringPrice": 1
                }
              ],
              "self": {
                "href": "text",
                "method": "text"
              }
            }
          ],
          "offer": {
            "id": 99,
            "type": "rental",
            "purchasePrice": 99.99,
            "recurringPrice": 19.99,
            "subscriptionPeriod": 12,
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "targetInstance": {
            "id": 42,
            "inventoryNumber": "EQ642",
            "costCenter": "4645-2343",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "cartTargetInstanceId": 1,
          "note": "This is just a <b>custom note</b>.",
          "preferredProvisionDate": "2026-01-01T00:00:00.000Z"
        }
      ],
      "approved": true,
      "justification": "text",
      "deliveryAddress": "text",
      "costCenterCode": "text",
      "costCenterId": 1,
      "id": 451,
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}
get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
idinteger · int32Required
Query parameters
languagestringOptional
Responses
200

OK

application/json
totalinteger · int32Required
get/v1/procurement/approval-requests/{id}
GET /v1/procurement/approval-requests/{id} HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "created": "2026-01-01T00:00:00.000Z",
      "requestedBy": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedLocation": {
        "id": 1,
        "name": "HQ New York",
        "type": "location",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedGroup": {
        "id": 42,
        "name": "Project 1337",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedEmployee": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "totalOneTimeCosts": 12.98,
      "totalRecurringCosts": 1109.9,
      "subscriptionPeriod": 12,
      "subscriptionPeriodRenewal": 1,
      "items": [
        {
          "type": "service",
          "action": "delivery",
          "service": {
            "id": 4,
            "name": "Basic Plan",
            "category": "text",
            "ean": "0194253408253",
            "externalId": "E54363",
            "supplierName": "text",
            "previewImageLink": "text",
            "type": "service",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "options": [
            {
              "id": 1,
              "name": "text",
              "versionId": 1,
              "versionName": "text",
              "action": "delivery",
              "offer": {
                "id": 99,
                "type": "rental",
                "purchasePrice": 99.99,
                "recurringPrice": 19.99,
                "subscriptionPeriod": 12,
                "self": {
                  "href": "text",
                  "method": "text"
                }
              },
              "versions": [
                {
                  "id": 1,
                  "versionName": "text",
                  "purchasePrice": 1,
                  "recurringPrice": 1
                }
              ],
              "self": {
                "href": "text",
                "method": "text"
              }
            }
          ],
          "offer": {
            "id": 99,
            "type": "rental",
            "purchasePrice": 99.99,
            "recurringPrice": 19.99,
            "subscriptionPeriod": 12,
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "targetInstance": {
            "id": 42,
            "inventoryNumber": "EQ642",
            "costCenter": "4645-2343",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "cartTargetInstanceId": 1,
          "note": "This is just a <b>custom note</b>.",
          "preferredProvisionDate": "2026-01-01T00:00:00.000Z"
        }
      ],
      "approved": true,
      "justification": "text",
      "deliveryAddress": "text",
      "costCenterCode": "text",
      "costCenterId": 1,
      "id": 451,
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}
patch
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
idinteger · int32Required
Body
Responses
200

OK

application/json
totalinteger · int32Required
patch/v1/procurement/approval-requests/{id}
PATCH /v1/procurement/approval-requests/{id} HTTP/1.1
X-API-KEY: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 89

{
  "patchDocument": {
    "operations": [
      {
        "value": null,
        "path": "text",
        "op": "text",
        "from": "text"
      }
    ]
  }
}
{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "created": "2026-01-01T00:00:00.000Z",
      "requestedBy": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedLocation": {
        "id": 1,
        "name": "HQ New York",
        "type": "location",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedGroup": {
        "id": 42,
        "name": "Project 1337",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedEmployee": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "totalOneTimeCosts": 12.98,
      "totalRecurringCosts": 1109.9,
      "subscriptionPeriod": 12,
      "subscriptionPeriodRenewal": 1,
      "items": [
        {
          "type": "service",
          "action": "delivery",
          "service": {
            "id": 4,
            "name": "Basic Plan",
            "category": "text",
            "ean": "0194253408253",
            "externalId": "E54363",
            "supplierName": "text",
            "previewImageLink": "text",
            "type": "service",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "options": [
            {
              "id": 1,
              "name": "text",
              "versionId": 1,
              "versionName": "text",
              "action": "delivery",
              "offer": {
                "id": 99,
                "type": "rental",
                "purchasePrice": 99.99,
                "recurringPrice": 19.99,
                "subscriptionPeriod": 12,
                "self": {
                  "href": "text",
                  "method": "text"
                }
              },
              "versions": [
                {
                  "id": 1,
                  "versionName": "text",
                  "purchasePrice": 1,
                  "recurringPrice": 1
                }
              ],
              "self": {
                "href": "text",
                "method": "text"
              }
            }
          ],
          "offer": {
            "id": 99,
            "type": "rental",
            "purchasePrice": 99.99,
            "recurringPrice": 19.99,
            "subscriptionPeriod": 12,
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "targetInstance": {
            "id": 42,
            "inventoryNumber": "EQ642",
            "costCenter": "4645-2343",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "cartTargetInstanceId": 1,
          "note": "This is just a <b>custom note</b>.",
          "preferredProvisionDate": "2026-01-01T00:00:00.000Z"
        }
      ],
      "approved": true,
      "justification": "text",
      "deliveryAddress": "text",
      "costCenterCode": "text",
      "costCenterId": 1,
      "id": 451,
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}
get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
idinteger · int32Required
Responses
200

OK

application/json
totalinteger · int32Required
get/v1/procurement/approval-requests/{id}/history
GET /v1/procurement/approval-requests/{id}/history HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "created": "2026-01-01T00:00:00.000Z",
      "requestedBy": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedLocation": {
        "id": 1,
        "name": "HQ New York",
        "type": "location",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedGroup": {
        "id": 42,
        "name": "Project 1337",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedEmployee": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "totalOneTimeCosts": 12.98,
      "totalRecurringCosts": 1109.9,
      "subscriptionPeriod": 12,
      "subscriptionPeriodRenewal": 1,
      "items": [
        {
          "type": "service",
          "action": "delivery",
          "service": {
            "id": 4,
            "name": "Basic Plan",
            "category": "text",
            "ean": "0194253408253",
            "externalId": "E54363",
            "supplierName": "text",
            "previewImageLink": "text",
            "type": "service",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "options": [
            {
              "id": 1,
              "name": "text",
              "versionId": 1,
              "versionName": "text",
              "action": "delivery",
              "offer": {
                "id": 99,
                "type": "rental",
                "purchasePrice": 99.99,
                "recurringPrice": 19.99,
                "subscriptionPeriod": 12,
                "self": {
                  "href": "text",
                  "method": "text"
                }
              },
              "versions": [
                {
                  "id": 1,
                  "versionName": "text",
                  "purchasePrice": 1,
                  "recurringPrice": 1
                }
              ],
              "self": {
                "href": "text",
                "method": "text"
              }
            }
          ],
          "offer": {
            "id": 99,
            "type": "rental",
            "purchasePrice": 99.99,
            "recurringPrice": 19.99,
            "subscriptionPeriod": 12,
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "targetInstance": {
            "id": 42,
            "inventoryNumber": "EQ642",
            "costCenter": "4645-2343",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "cartTargetInstanceId": 1,
          "note": "This is just a <b>custom note</b>.",
          "preferredProvisionDate": "2026-01-01T00:00:00.000Z"
        }
      ],
      "approved": true,
      "justification": "text",
      "deliveryAddress": "text",
      "costCenterCode": "text",
      "costCenterId": 1,
      "id": 451,
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}

Get the participants (authorizing employees) assigned to an approval request.

get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
idinteger · int32Required
Responses
200

OK

application/json

HATEOAS representation of the participant collection of an approval request. The Self link points to the participants collection sub-resource.

totalinteger · int32Required
get/v1/procurement/approval-requests/{id}/participants
GET /v1/procurement/approval-requests/{id}/participants HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "items": [
    {
      "id": 1,
      "firstName": "Pierce",
      "lastName": "Bell",
      "email": "p.bell@foo.io",
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}

Add one or more participants (authorizing employees) to an existing approval request.

post
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
idinteger · int32Required
Body

Request payload for adding one or more participants (authorizing employees) to an existing approval request.

participantsinteger · int32[] · nullableOptional

The employee IDs that should be added as participants to the approval request.

typestring · enumOptional

Scope of an ApprovalRequest <> Employee assignment. Approvers are the visible, counted participants; observers are scoped in (they can see and act on the request) but are never returned or counted as participants.

Possible values:
reasonstring · nullableOptional

Optional: why these participants are being added. Recorded on the request history as the justification of the assignment.

Example: Cost center owner as of 08/2026, deputising for M. Weber
Responses
200

OK

application/json

HATEOAS representation of the participant collection of an approval request. The Self link points to the participants collection sub-resource.

totalinteger · int32Required
post/v1/procurement/approval-requests/{id}/participants
POST /v1/procurement/approval-requests/{id}/participants HTTP/1.1
X-API-KEY: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 106

{
  "participants": [
    1
  ],
  "type": "Approver",
  "reason": "Cost center owner as of 08/2026, deputising for M. Weber"
}
{
  "items": [
    {
      "id": 1,
      "firstName": "Pierce",
      "lastName": "Bell",
      "email": "p.bell@foo.io",
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}

Remove a single participant (authorizing employee) from an existing approval request.

delete
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters
idinteger · int32Required
employeeIdinteger · int32Required
Query parameters
reasonstringOptional
Responses
204

No Content

No content

delete/v1/procurement/approval-requests/{id}/participants/{employeeId}
DELETE /v1/procurement/approval-requests/{id}/participants/{employeeId} HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*

No content

Get a list of approval requests with different filters

get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Query parameters
assignedToGroupinteger · int32Optional

Return all approval requests that are assigned to a specific person

requestedByMebooleanOptional

Return only the approval requests requested by the calling user

Default: false
statusstringOptional

Filter by a single status: opened, pending, approved, rejected, cancelled, closed. Unknown values are ignored

languagestringOptional

User's selected Language

Responses
200

OK

application/json
totalinteger · int32Required
get/v1/procurement/my-approval-requests
GET /v1/procurement/my-approval-requests HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "created": "2026-01-01T00:00:00.000Z",
      "requestedBy": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedLocation": {
        "id": 1,
        "name": "HQ New York",
        "type": "location",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedGroup": {
        "id": 42,
        "name": "Project 1337",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedEmployee": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "totalOneTimeCosts": 12.98,
      "totalRecurringCosts": 1109.9,
      "subscriptionPeriod": 12,
      "subscriptionPeriodRenewal": 1,
      "items": [
        {
          "type": "service",
          "action": "delivery",
          "service": {
            "id": 4,
            "name": "Basic Plan",
            "category": "text",
            "ean": "0194253408253",
            "externalId": "E54363",
            "supplierName": "text",
            "previewImageLink": "text",
            "type": "service",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "options": [
            {
              "id": 1,
              "name": "text",
              "versionId": 1,
              "versionName": "text",
              "action": "delivery",
              "offer": {
                "id": 99,
                "type": "rental",
                "purchasePrice": 99.99,
                "recurringPrice": 19.99,
                "subscriptionPeriod": 12,
                "self": {
                  "href": "text",
                  "method": "text"
                }
              },
              "versions": [
                {
                  "id": 1,
                  "versionName": "text",
                  "purchasePrice": 1,
                  "recurringPrice": 1
                }
              ],
              "self": {
                "href": "text",
                "method": "text"
              }
            }
          ],
          "offer": {
            "id": 99,
            "type": "rental",
            "purchasePrice": 99.99,
            "recurringPrice": 19.99,
            "subscriptionPeriod": 12,
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "targetInstance": {
            "id": 42,
            "inventoryNumber": "EQ642",
            "costCenter": "4645-2343",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "cartTargetInstanceId": 1,
          "note": "This is just a <b>custom note</b>.",
          "preferredProvisionDate": "2026-01-01T00:00:00.000Z"
        }
      ],
      "approved": true,
      "justification": "text",
      "deliveryAddress": "text",
      "costCenterCode": "text",
      "costCenterId": 1,
      "id": 451,
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}
get
Authorizations
X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Responses
200

OK

application/json
totalinteger · int32Required
get/v1/procurement/pending-approval-requests
GET /v1/procurement/pending-approval-requests HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "created": "2026-01-01T00:00:00.000Z",
      "requestedBy": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedLocation": {
        "id": 1,
        "name": "HQ New York",
        "type": "location",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedGroup": {
        "id": 42,
        "name": "Project 1337",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "assignedEmployee": {
        "id": 1,
        "firstName": "Pierce",
        "lastName": "Bell",
        "fullName": "text",
        "email": "p.bell@foo.io",
        "username": "j.doe@foo.inc",
        "costCenter": "4645-2343",
        "costCenterId": 1,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "totalOneTimeCosts": 12.98,
      "totalRecurringCosts": 1109.9,
      "subscriptionPeriod": 12,
      "subscriptionPeriodRenewal": 1,
      "items": [
        {
          "type": "service",
          "action": "delivery",
          "service": {
            "id": 4,
            "name": "Basic Plan",
            "category": "text",
            "ean": "0194253408253",
            "externalId": "E54363",
            "supplierName": "text",
            "previewImageLink": "text",
            "type": "service",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "options": [
            {
              "id": 1,
              "name": "text",
              "versionId": 1,
              "versionName": "text",
              "action": "delivery",
              "offer": {
                "id": 99,
                "type": "rental",
                "purchasePrice": 99.99,
                "recurringPrice": 19.99,
                "subscriptionPeriod": 12,
                "self": {
                  "href": "text",
                  "method": "text"
                }
              },
              "versions": [
                {
                  "id": 1,
                  "versionName": "text",
                  "purchasePrice": 1,
                  "recurringPrice": 1
                }
              ],
              "self": {
                "href": "text",
                "method": "text"
              }
            }
          ],
          "offer": {
            "id": 99,
            "type": "rental",
            "purchasePrice": 99.99,
            "recurringPrice": 19.99,
            "subscriptionPeriod": 12,
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "targetInstance": {
            "id": 42,
            "inventoryNumber": "EQ642",
            "costCenter": "4645-2343",
            "self": {
              "href": "text",
              "method": "text"
            }
          },
          "cartTargetInstanceId": 1,
          "note": "This is just a <b>custom note</b>.",
          "preferredProvisionDate": "2026-01-01T00:00:00.000Z"
        }
      ],
      "approved": true,
      "justification": "text",
      "deliveryAddress": "text",
      "costCenterCode": "text",
      "costCenterId": 1,
      "id": 451,
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}

Last updated

Was this helpful?