Revoke Issuance Job

curl https://api.thanxsandbox.com/partner/issuance_jobs/job_xyz789/revoke \
  -X POST \
  -H 'X-ClientId: {client_id}' \
  -H 'Accept-Version: v4.0' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access_token}' \
  -d '{
    "merchant_id": "k2lye10h32l5wzo"
  }'

{
  "issuance_job": {
    "id": "job_xyz789",
    "campaign_id": "camp_abc123",
    "variant_id": "var_treat1",
    "state": "revoking",
    "total_count": 2,
    "processed_count": 2,
    "success_count": 1,
    "failure_count": 1,
    "progress_percent": 100,
    "created_at": "2025-06-15T10:30:00Z",
    "started_at": "2025-06-15T10:30:05Z",
    "completed_at": "2025-06-15T10:30:15Z"
  }
}

POST

partner

issuance_jobs

:id

revoke

curl https://api.thanxsandbox.com/partner/issuance_jobs/job_xyz789/revoke \
  -X POST \
  -H 'X-ClientId: {client_id}' \
  -H 'Accept-Version: v4.0' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access_token}' \
  -d '{
    "merchant_id": "k2lye10h32l5wzo"
  }'

{
  "issuance_job": {
    "id": "job_xyz789",
    "campaign_id": "camp_abc123",
    "variant_id": "var_treat1",
    "state": "revoking",
    "total_count": 2,
    "processed_count": 2,
    "success_count": 1,
    "failure_count": 1,
    "progress_percent": 100,
    "created_at": "2025-06-15T10:30:00Z",
    "started_at": "2025-06-15T10:30:05Z",
    "completed_at": "2025-06-15T10:30:15Z"
  }
}

Scope required: rewards.issue

This endpoint revokes all rewards that were issued by a given issuance job. Revocation is processed asynchronously. The endpoint returns 202 Accepted and the job transitions to a revoking state while rewards are being revoked in the background. Only issuance jobs in a completed or failed state can be revoked. Jobs that are pending or processing will return a 422 error. Jobs that are already revoking or revoked will also return a 422 error.

Parameters

string

required

Issuance job ID

merchant_id

string

required

Merchant ID

Response

Returns 202 Accepted with the issuance job object.

string

Issuance job ID

campaign_id

string

Campaign ID

variant_id

string

Variant ID

state

string

Job state: revoking after a successful revocation request

total_count

integer

Total number of identifiers submitted

processed_count

integer

Number of identifiers processed

success_count

integer

Number of rewards successfully issued

failure_count

integer

Number of failed issuances

progress_percent

integer

Completion percentage (0-100)

created_at

datetime

Job creation timestamp (ISO8601)

started_at

datetime

Processing start timestamp (ISO8601)

completed_at

datetime

Processing completion timestamp (ISO8601)

curl https://api.thanxsandbox.com/partner/issuance_jobs/job_xyz789/revoke \
  -X POST \
  -H 'X-ClientId: {client_id}' \
  -H 'Accept-Version: v4.0' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access_token}' \
  -d '{
    "merchant_id": "k2lye10h32l5wzo"
  }'

{
  "issuance_job": {
    "id": "job_xyz789",
    "campaign_id": "camp_abc123",
    "variant_id": "var_treat1",
    "state": "revoking",
    "total_count": 2,
    "processed_count": 2,
    "success_count": 1,
    "failure_count": 1,
    "progress_percent": 100,
    "created_at": "2025-06-15T10:30:00Z",
    "started_at": "2025-06-15T10:30:05Z",
    "completed_at": "2025-06-15T10:30:15Z"
  }
}

Get Issuance Job

⌘I

Merchant & Partner API

Reference

Revoke Issuance Job

Parameters

Response

​Parameters

​Response

Parameters

Response