Cancel an existing Subscription

Request

Cancels an existing Subscription.

Security

basic_auth

Path

idstringrequired

ID of the Subscription.

curl -i -X DELETE \
  -u '<username>:<password>' \
  'https://docs.checkr.com/_mock/apis/openapi/subscriptions/{id}'

Responses

Subscription was successfully canceled

Bodyapplication/json

idstring(ResourceId)read-only

ID of the resource.

Example:"e44aa283528e6fde7d542194"

objectstringread-only

Value:"subscription"

uristring(ResourceURI)read-only

URI of the Subscription.

Example:"/v1/subscriptions/4722c07dd9a10c3985ae432a"

statusstring

Status of the Subscription.

Enum:"active""inactive"

Example:"active"

created_atstring, (date-time)

Time at which the Subscription was created.

Example:"2014-01-18T12:34:00Z"

canceled_atstring or null, (date-time)

Time at which the Subscription was canceled.

Example:"2014-01-30T12:34:00Z"

packagestring

Package to run for the Subscription.

Example:"driver_pro"

interval_countinteger

The number of intervals between each recurrent background check.

Example:1

interval_unitstring

Interval at which the Subscription will repeat.

Enum:"day""week""month""year"

Example:"month"

start_datestring, (date)

Start date for the Subscription. This is the date on which the Subscription will begin, and the first time the report will be run.

Example:"2014-06-10"

candidate_idstring

ID of the candidate screened.

Example:"e44aa283528e6fde7d542194"

Response

{
  "id": "e44aa283528e6fde7d542194",
  "object": "subscription",
  "uri": "/v1/subscriptions/4722c07dd9a10c3985ae432a",
  "status": "active",
  "created_at": "2014-01-18T12:34:00Z",
  "canceled_at": "2014-01-30T12:34:00Z",
  "package": "driver_pro",
  "interval_count": 1,
  "interval_unit": "month",
  "start_date": "2014-06-10",
  "candidate_id": "e44aa283528e6fde7d542194"
}