Skip to main content
POST
/
punch-cards
/
{punchCardId}
/
issued
Issue new Punch Card
curl --request POST \
  --url https://api.mijnklantportaal.nl/v1/punch-cards/{punchCardId}/issued \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerId": "cst_abc12345def678"
}
'
{
  "id": "pcb_abc12345def678",
  "punchCardId": "pcd_abc12345def678",
  "customerId": "cst_abc12345def678",
  "punchesLeft": 17,
  "status": "active",
  "expiresAt": "2028-11-19T21:00:00+02:00",
  "issuedAt": "2025-11-19T21:00:00+02:00"
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
punchCardId
string
required

ID of the Punch Card to issue a new card for

Body

application/json
​
customerId
string
required

ID of the customer to issue the Punch Card to

Example:

"cst_abc12345def678"

Response

The issued Bought Punch Card

A bought punch card

​
id
string

ID of the bought punch card, always starting with pcb_.

Example:

"pcb_abc12345def678"

​
punchCardId
string

ID of the punch card which is bought

Example:

"pcd_abc12345def678"

​
customerId
string

ID of the customer who owns this bought punch card

Example:

"cst_abc12345def678"

​
punchesLeft
integer

Indicates how many punches are left before the card is fully used

Example:

17

​
status
string

Actual status of the bought card. Can be active, expired or fully_used.

Example:

"active"

​
expiresAt
string

Date and time when the bought card will expire, written in ATOM format. Remains null when the card will not expire at all.

Example:

"2028-11-19T21:00:00+02:00"

​
issuedAt
string

Date and time when the card was issued to or bought by the customer. Written in ATOM format.

Example:

"2025-11-19T21:00:00+02:00"