Finance > Rewards

Mark as paid/pending

PATCH update state

Endpoint

PATCH /api/v1/finance/rewards/bulk_update

Parameters

Name Description In
reward[reward_ids] required Array of reward ids
reward[state] required State to update ["paid", "pending"]

Request

Route

PATCH /api/v1/finance/rewards/bulk_update

Headers

Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI0OTYiLCJzY3AiOiJ1c2VyIiwiYXVkIjpudWxsLCJpYXQiOjE3NTMyNjYxODAsImV4cCI6MTc1NTg1ODE4MCwianRpIjoiNzcxZmQ1YWEtMjUzNy00Yzk1LWE0YjctODA1ODZmN2ViYzRmIn0.1trzPC0KiH_VxPgQBdpEOvhXtWFarCvjiTDeXDI56wE
Host: example.org
Cookie: 

Body

{
  "reward": {
    "reward_ids": [
      487,
      492,
      497,
      502,
      507
    ],
    "state": "paid",
    "passcode": 1234
  }
}

Response

Simulated Response

Status

200

Headers

x-frame-options: SAMEORIGIN
x-xss-protection: 0
x-content-type-options: nosniff
x-permitted-cross-domain-policies: none
referrer-policy: strict-origin-when-cross-origin
per-page: 20
total: 5
content-type: application/json; charset=utf-8
vary: Accept, Origin
etag: W/"59ec858f2a1ec8f5b908f226b42bd3e6"
cache-control: max-age=0, private, must-revalidate
x-request-id: 2d9edce6-613f-4dc0-a182-85ea35cb91d6
x-runtime: 0.035959
content-length: 1500

Body

{
  "rewards": [
    {
      "id": 487,
      "bonus": "10.0",
      "completed_at": "2025-07-14T00:00:00.000Z",
      "referee": {
        "id": 487,
        "first_name": "Letisha",
        "last_name": "Wolff",
        "profile_id": 177,
        "referral_code": "595675"
      },
      "referrer": {
        "id": 486,
        "first_name": "Ike",
        "last_name": "Hermiston",
        "profile_id": 176,
        "referral_code": "374589"
      },
      "state": "paid"
    },
    {
      "id": 492,
      "bonus": "10.0",
      "completed_at": "2025-07-14T00:00:00.000Z",
      "referee": {
        "id": 489,
        "first_name": "Harland",
        "last_name": "Hills",
        "profile_id": 179,
        "referral_code": "308173"
      },
      "referrer": {
        "id": 488,
        "first_name": "Daphne",
        "last_name": "Bogan",
        "profile_id": 178,
        "referral_code": "029680"
      },
      "state": "paid"
    },
    {
      "id": 497,
      "bonus": "10.0",
      "completed_at": "2025-07-14T00:00:00.000Z",
      "referee": {
        "id": 491,
        "first_name": "Mickie",
        "last_name": "Jacobs",
        "profile_id": 181,
        "referral_code": "749354"
      },
      "referrer": {
        "id": 490,
        "first_name": "Thuy",
        "last_name": "Corkery",
        "profile_id": 180,
        "referral_code": "705061"
      },
      "state": "paid"
    },
    {
      "id": 502,
      "bonus": "10.0",
      "completed_at": "2025-07-14T00:00:00.000Z",
      "referee": {
        "id": 493,
        "first_name": "Gabrielle",
        "last_name": "Bergstrom",
        "profile_id": 183,
        "referral_code": "273547"
      },
      "referrer": {
        "id": 492,
        "first_name": "Shantae",
        "last_name": "Rosenbaum",
        "profile_id": 182,
        "referral_code": "579086"
      },
      "state": "paid"
    },
    {
      "id": 507,
      "bonus": "10.0",
      "completed_at": "2025-07-14T00:00:00.000Z",
      "referee": {
        "id": 495,
        "first_name": "Clementina",
        "last_name": "Kub",
        "profile_id": 185,
        "referral_code": "643368"
      },
      "referrer": {
        "id": 494,
        "first_name": "Erin",
        "last_name": "Herzog",
        "profile_id": 184,
        "referral_code": "469670"
      },
      "state": "paid"
    }
  ]
}