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

string

required

Merchant ID

Response

Returns 202 Accepted with the issuance job object.

string

Issuance job ID

string

Campaign ID

string

Variant ID

string

Job state: revoking after a successful revocation request

integer

Total number of identifiers submitted

integer

Number of identifiers processed

integer

Number of rewards successfully issued

integer

Number of failed issuances

integer

Completion percentage (0-100)

datetime

Job creation timestamp (ISO8601)

datetime

Processing start timestamp (ISO8601)

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"
  }
}

⌘I

Merchant & Partner API

Reference

Revoke Issuance Job

Parameters

Response

​Parameters

​Response

Parameters

Response