Adjust feature usage

Developing

POST

https://api.storyous.com/features/merchants/{merchantId}/features/{feature}/usage/adjust

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400Invalid request or quota unavailable

🟠401Unauthorized

🔴500Internal error

🟠409Concurrent request

Request Example

Shell

JavaScript

Java

Swift

cURL

Consume one uploadRefund original attempt

curl --location 'https://api.storyous.com/features/merchants/6a000000000000000000000010/features/stockUpParsing/usage/adjust?placeId=6a000000000000000000000020' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "action": "consume",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "quantity": 1,
  "fingerprint": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
}'

Response Example

200 - New consumption

{
  "state": "consumed",
  "receipt": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "fingerprint": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
    "quantity": 1,
    "periodId": "6a000000000000000000000001:2026-11-10T09:00:00.000Z",
    "createdAt": "2026-11-10T10:00:00.000Z",
    "refunded": false
  },
  "usage": {
    "allowance": 300,
    "consumed": 81,
    "available": 219,
    "periodId": "6a000000000000000000000001:2026-11-10T09:00:00.000Z",
    "startsAt": "2026-11-10T09:00:00.000Z",
    "expiresAt": "2026-12-10T09:00:00.000Z",
    "unit": "request"
  }
}

Get feature usage

Get list of merchants/places with a feature