Providers

Provider management endpoints

List all providers

get

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Responses

200

List of providers

application/json

get

/providers

HTTPcURLJavaScriptPython

GET /api/v2/providers HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of providers

{
  "providers": [
    {
      "id": 1,
      "name": "text",
      "user_id": 1,
      "service_id": 1,
      "is_active": true,
      "key_valid_minutes": 1,
      "user_select_mode": true,
      "user_select_required": 1,
      "user_select_allow_duplicates": true,
      "user_time_selection_enabled": true,
      "user_time_selection_options": [
        {
          "id": "text",
          "label": "text",
          "hours": 1,
          "required_checkpoints": 1
        }
      ],
      "one_time_use": true,
      "expiry_on_first_use": true,
      "hwid_limit": 1,
      "streak_enabled": true,
      "streak_bonus_minutes_per_day": 1,
      "streak_max_bonus_hours": 1,
      "streak_sync_provider_id": 1,
      "integration_sequence": [
        1
      ],
      "created_at": "2026-01-11T07:19:42.382Z"
    }
  ]
}

Create a new provider

post

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Body

application/json

namestring · min: 2 · max: 100Required

service_idinteger | nullableOptional

key_valid_minutesinteger · min: 5 · max: 525960Required

Required field, minimum 5 minutes

user_select_modebooleanOptionalDefault: false

user_select_requiredinteger · min: 1 · max: 50OptionalDefault: 1

user_select_allow_duplicatesbooleanOptionalDefault: false

user_time_selection_enabledbooleanOptionalDefault: false

one_time_usebooleanOptional

Cannot be combined with expiry_on_first_use

Default: false

expiry_on_first_usebooleanOptional

Cannot be combined with one_time_use

Default: false

hwid_limitinteger · min: 1 · max: 100OptionalDefault: 1

streak_enabledbooleanOptionalDefault: false

streak_bonus_minutes_per_dayinteger · min: 1 · max: 1440OptionalDefault: 5

streak_max_bonus_hoursinteger · min: 1 · max: 168OptionalDefault: 24

Responses

201

Provider created

application/json

400

Validation error or invalid combination (one_time_use + expiry_on_first_use)

401

Unauthorized

post

/providers

HTTPcURLJavaScriptPython

POST /api/v2/providers HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 419

{
  "name": "text",
  "service_id": 1,
  "key_valid_minutes": 1,
  "user_select_mode": false,
  "user_select_required": 1,
  "user_select_allow_duplicates": false,
  "user_time_selection_enabled": false,
  "user_time_selection_options": [
    {
      "id": "text",
      "label": "text",
      "hours": 1,
      "required_checkpoints": 1
    }
  ],
  "one_time_use": false,
  "expiry_on_first_use": false,
  "hwid_limit": 1,
  "streak_enabled": false,
  "streak_bonus_minutes_per_day": 5,
  "streak_max_bonus_hours": 24
}

{
  "provider": {
    "id": 1,
    "name": "text",
    "user_id": 1,
    "service_id": 1,
    "is_active": true,
    "key_valid_minutes": 1,
    "user_select_mode": true,
    "user_select_required": 1,
    "user_select_allow_duplicates": true,
    "user_time_selection_enabled": true,
    "user_time_selection_options": [
      {
        "id": "text",
        "label": "text",
        "hours": 1,
        "required_checkpoints": 1
      }
    ],
    "one_time_use": true,
    "expiry_on_first_use": true,
    "hwid_limit": 1,
    "streak_enabled": true,
    "streak_bonus_minutes_per_day": 1,
    "streak_max_bonus_hours": 1,
    "streak_sync_provider_id": 1,
    "integration_sequence": [
      1
    ],
    "created_at": "2026-01-11T07:19:42.382Z"
  }
}

Get provider details

get

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

providerIdintegerRequired

Responses

200

Provider details

No content

get

/providers/{providerId}

HTTPcURLJavaScriptPython

GET /api/v2/providers/{providerId} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Provider details

No content

Update provider

put

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

providerIdintegerRequired

Body

application/json

namestring · min: 2 · max: 100Optional

service_idinteger | nullableOptional

key_valid_minutesinteger · min: 5 · max: 525960Optional

user_select_modebooleanOptional

user_select_requiredinteger · min: 1 · max: 50Optional

user_select_allow_duplicatesbooleanOptional

user_time_selection_enabledbooleanOptional

user_time_selection_optionsobject[] | nullableOptional

one_time_usebooleanOptional

expiry_on_first_usebooleanOptional

is_activebooleanOptional

hwid_limitinteger · min: 1 · max: 100Optional

streak_enabledbooleanOptional

streak_bonus_minutes_per_dayinteger · min: 1 · max: 1440Optional

streak_max_bonus_hoursinteger · min: 1 · max: 168Optional

Responses

200

Provider updated

No content

put

/providers/{providerId}

HTTPcURLJavaScriptPython

PUT /api/v2/providers/{providerId} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 368

{
  "name": "text",
  "service_id": 1,
  "key_valid_minutes": 1,
  "user_select_mode": true,
  "user_select_required": 1,
  "user_select_allow_duplicates": true,
  "user_time_selection_enabled": true,
  "user_time_selection_options": [
    {}
  ],
  "one_time_use": true,
  "expiry_on_first_use": true,
  "is_active": true,
  "hwid_limit": 1,
  "streak_enabled": true,
  "streak_bonus_minutes_per_day": 1,
  "streak_max_bonus_hours": 1
}

200

Provider updated

No content

Delete provider

delete

Authorizations

bearerAuth

AuthorizationstringRequired

API Key with rest-api:* scope

Path parameters

providerIdintegerRequired

Responses

200

Provider deleted

No content

delete

/providers/{providerId}

HTTPcURLJavaScriptPython

DELETE /api/v2/providers/{providerId} HTTP/1.1
Host: api.jnkie.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Provider deleted

No content