Skip to main content
POST
/
groups
/
{id}
/
expire
Expire a group
curl --request POST \
  --url https://api.kohortpay.com/groups/{id}/expire \
  --header 'Authorization: Bearer <token>'
{
  "id": "ord_1234567890",
  "shareId": "KHT-XXXXXXXX",
  "livemode": true,
  "organizationId": "org_1234567890",
  "customerId": "cus_1234567890",
  "creatorEmail": "[email protected]",
  "status": "COMPLETED",
  "metadata": {
    "basket_id": "1JYLo8KerLxWZaQtys6ZQ1xS"
  },
  "expiresAt": "2021-07-22T00:00:00.000Z",
  "midExpireAt": "2021-07-22T00:00:00.000Z",
  "jMinus2ExpireAt": "2021-07-22T00:00:00.000Z",
  "jPlus3StartAt": "2021-07-22T00:00:00.000Z",
  "reminderEmailSent": "NOT_SENT",
  "createdAt": "2021-07-22T00:00:00.000Z",
  "createdBy": "usr_1234567890",
  "updatedAt": "2021-07-22T00:00:00.000Z",
  "updatedBy": "usr_1234567890",
  "canceledAt": "2021-07-22T00:00:00.000Z",
  "completedAt": "2021-07-22T00:00:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Unique group ID

Response

200 - application/json

Group successfully canceled.

​
id
string
required

The id of the group.

Example:

"ord_1234567890"

​
shareId
string<string> | null
required

The shared identifier of the group. If null, it will create a group. If not null, it will join the group.

Example:

"KHT-XXXXXXXX"

​
livemode
boolean
required

Wether the order is in live mode or test mode.

Example:

true

​
organizationId
string
required

The id of the organization.

Example:

"org_1234567890"

​
customerId
string
required

The id of the customer.

Example:

"cus_1234567890"

​
creatorEmail
string<email>
required

The email of the creator of the group.

Example:

"[email protected]"

​
status
enum<string>
required

The status of the group.

Available options:
OPEN,
COMPLETED,
CANCELED,
EXPIRED
Example:

"COMPLETED"

​
metadata
object
required

Additional metadata for the order.

Example:
{ "basket_id": "1JYLo8KerLxWZaQtys6ZQ1xS" }
​
expiresAt
string<date-time>
required
Example:

"2021-07-22T00:00:00.000Z"

​
midExpireAt
string<date-time>
required
Example:

"2021-07-22T00:00:00.000Z"

​
jMinus2ExpireAt
string<date-time>
required
Example:

"2021-07-22T00:00:00.000Z"

​
jPlus3StartAt
string<date-time>
required
Example:

"2021-07-22T00:00:00.000Z"

​
reminderEmailSent
enum<string>
required

The reminder email sent status of the group.

Available options:
NOT_SENT,
MIDWAY_SENT,
DAY3_SENT,
DAY2_BEFORE_END_SENT
Example:

"NOT_SENT"

​
createdAt
string<date-time>
required
Example:

"2021-07-22T00:00:00.000Z"

​
createdBy
string | null
required

The id of the user who created the customer.

Example:

"usr_1234567890"

​
updatedAt
string<date-time>
required
Example:

"2021-07-22T00:00:00.000Z"

​
updatedBy
string | null
required

The id of the user who last updated the customer.

Example:

"usr_1234567890"

​
canceledAt
string<date-time>
required
Example:

"2021-07-22T00:00:00.000Z"

​
completedAt
string<date-time>
required
Example:

"2021-07-22T00:00:00.000Z"

⌘I