---
title: "Mark a purchase as consumed by the current user."
method: POST
path: "/accounts/purchases/{pid}/consume"
tags: ["Account"]
---

# Mark a purchase as consumed by the current user.

`POST /accounts/purchases/{pid}/consume`

## Request

- Base URL: `https://api.onshape.com/api/v17`
- URL: `https://api.onshape.com/api/v17/accounts/purchases/{pid}/consume`
- Auth: OAuth 2 and HTTP basic
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token` scopes: `OAuth2Purchase`

## Path parameters

- `pid` string, required

## Request body

- BTPurchaseIdentityParams
  - `consumedQuantity` integer
  - `identityId` string
  - `identityType` integer
  - `purchaseId` string

## Response `default`

default response

## Changes

- **2026-10-10** `fe3f0949b493`: 2 info
  - added the optional property `plan/discountInfo/createdBy/allOf[subschema #2]/globalPermissions/allowAccessToPublicLibraries` to the response with the `default` status
  - added the optional property `plan/discountInfo/createdBy/allOf[subschema #2]/globalPermissions/allowManagingPublicLibraries` to the response with the `default` status
- **2026-09-19** `c16acb88e3ea`: 2 info
  - added the optional property `plan/discountInfo/createdBy/allOf[subschema #2]/canMakePersonalCopies` to the response with the `default` status
  - added the optional property `plan/discountInfo/createdBy/allOf[subschema #2]/globalPermissions/makePersonalCopies` to the response with the `default` status

[Operation history](https://skmtc.dev/onshape/apis/onshape-rest-api/changes/accounts/purchases/:pid/consume/post.md)

---

[API](https://skmtc.dev/onshape/apis/onshape-rest-api.md) - [All operations](https://skmtc.dev/onshape/apis/onshape-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onshape/apis/onshape-rest-api/revisions/c5c4c780f831?raw)