Koha/api/v1/swagger/definitions/hold.yaml
Jonathan Druart 7a32231a52
Bug 35353: Add REST API endpoint to retrieve old holds
Same as checkout but for holds, we need to provide a way to retrieve old
holds for a patron.

Test plan:
Create some holds for a patron, cancel and fulfill some, then use the
REST API endpoint with the new 'old' flag set to 1
  /api/v1/patrons/42/holds?old=1

Signed-off-by: Matt Blenkinsop <matt.blenkinsop@ptfs-europe.com>
Signed-off-by: Nick Clemens <nick@bywatersolutions.com>
Signed-off-by: Katrin Fischer <katrin.fischer@bsz-bw.de>
2024-04-26 18:06:09 +02:00

127 lines
2.8 KiB
YAML

---
type: object
properties:
hold_id:
type: integer
description: Internal hold identifier
patron_id:
type: integer
description: Internal patron identifier
hold_date:
type:
- string
- "null"
format: date
description: The date the hold was placed
biblio_id:
type: integer
description: Internal biblio identifier
item_group_id:
type:
- string
- "null"
description: Internal item group identifier
pickup_library_id:
type:
- string
- "null"
description: Internal library identifier for the pickup library
desk_id:
type:
- integer
- "null"
description: The id of the desk
cancellation_date:
type:
- string
- "null"
format: date
description: The date the hold was cancelled
cancellation_reason:
type:
- string
- "null"
description: The reason the hold was cancelled
notes:
type:
- string
- "null"
description: Notes related to this hold
priority:
type:
- integer
- "null"
description: Where in the queue the patron sits
status:
type:
- string
- "null"
description: A one letter code defining what the status of the hold is after it has
been confirmed
timestamp:
type: string
format: date-time
description: Timestamp for the latest hold update
item_id:
type:
- string
- "null"
description: Internal item identifier
waiting_date:
type:
- string
- "null"
format: date
description: The date the item was marked as waiting for the patron at the library
expiration_date:
type:
- string
- "null"
format: date
description: The date the hold expires
lowest_priority:
type: boolean
description: Controls if the hold is given the lowest priority on the queue
suspended:
type: boolean
description: Controls if the hold is suspended
suspended_until:
type:
- string
- "null"
format: date-time
description: Date until which the hold has been suspended
non_priority:
description: Set this hold as non priority
type: boolean
item_type:
type:
- string
- "null"
description: If record level hold, the optional itemtype of the item the patron is
requesting
item_level:
type: boolean
description: If the hold is placed at item level
cancellation_requested:
type:
- boolean
- "null"
description: Cancellation requests count for the hold (x-koha-embed)
biblio:
type:
- object
- "null"
description: Bibliographic record
item:
type:
- object
- "null"
description: The item
pickup_library:
type:
- object
- "null"
description: Pickup library
additionalProperties: false