API ReferenceView as MarkdownOpenAPI

Discountvouchers

View as Markdown

Endpoints that need a token: the site owner creates it in their admin (Developers > API reference). AI assistants: how to ask the user for one.

5 endpoints.

List all discountvouchers

Returns the site's discountvouchers, newest first unless a sort is given.

User token

Needs the token of a signed-in user.

Query parameters
dependability_filterstring

Only discountvouchers with this dependability filter.

no_populatestring

Only discountvouchers with this no populate.

Status codes

200 401 500

GET/discountvouchers
curl -X GET 'http://debate.bg/discountvouchers?ionic=true&dependability_filter=...&no_populate=...' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "name": "Example",
  "make": "6543210fedcba98765432100",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

Create a discountvoucher

Creates a discountvoucher from the fields sent.

User token

Needs the token of a signed-in user.

Status codes

201 400 401 500

POST/discountvouchers
curl -X POST 'http://debate.bg/discountvouchers?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "name": "Example",
  "make": "6543210fedcba98765432100",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

Retrieve a discountvoucher

Returns one discountvoucher, found by its ID.

User token

Needs the token of a signed-in user.

Path parameters
idstringRequired

The ID of the discountvoucher.

Query parameters
no_populatestring

Only discountvouchers with this no populate.

Status codes

200 401 404 500

GET/discountvouchers/:id
curl -X GET 'http://debate.bg/discountvouchers/{id}?ionic=true&no_populate=...' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "name": "Example",
  "make": "6543210fedcba98765432100",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

Update a discountvoucher

Changes the fields sent; the others stay as they are.

User token

Needs the token of a signed-in user.

Path parameters
idstringRequired

The ID of the discountvoucher.

Status codes

200 400 401 404 500

PATCH/discountvouchers/:id
curl -X PATCH 'http://debate.bg/discountvouchers/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
Response
{
  "name": "Example",
  "make": "6543210fedcba98765432100",
  "_id": "6543210fedcba98765432100",
  "updatedAt": "2026-11-04T12:00:00.000Z",
  "createdAt": "2026-11-04T12:00:00.000Z"
}

Delete a discountvoucher

Deletes the discountvoucher. This cannot be undone.

User token

Needs the token of a signed-in user.

Path parameters
idstringRequired

The ID of the discountvoucher.

Returns

Returns an empty answer on success.

Status codes

200 401 404 500

DELETE/discountvouchers/:id
curl -X DELETE 'http://debate.bg/discountvouchers/{id}?ionic=true' \
  -H 'Authorization: Bearer <TOKEN>'
↑↓ Navigate↵ GoEsc Close