Bug 20772: Return cost & price_paid in API
[koha.git] / api / v1 / swagger / paths / illrequests.json
1 {
2     "/illrequests": {
3         "get": {
4             "x-mojo-to": "Illrequests#list",
5             "operationId": "listIllrequests",
6             "tags": ["illrequests"],
7             "parameters": [{
8                 "name": "embed",
9                 "in": "query",
10                 "description": "Additional objects that should be embedded in the response",
11                 "required": false,
12                 "type": "array",
13                 "collectionFormat": "csv",
14                 "items": {
15                     "type": "string",
16                     "enum": [
17                         "patron",
18                         "library",
19                         "capabilities",
20                         "metadata"
21                     ]
22                 }
23             }, {
24                 "name": "backend",
25                 "in": "query",
26                 "description": "The name of a ILL backend",
27                 "required": false,
28                 "type": "string"
29             }, {
30                 "name": "orderid",
31                 "in": "query",
32                 "description": "The order ID of a request",
33                 "required": false,
34                 "type": "string"
35             }, {
36                 "name": "biblionumber",
37                 "in": "query",
38                 "description": "Internal biblio identifier",
39                 "required": false,
40                 "type": "integer"
41             }, {
42                 "name": "borrowernumber",
43                 "in": "query",
44                 "description": "Internal patron identifier",
45                 "required": false,
46                 "type": "integer"
47             }, {
48                 "name": "completed",
49                 "in": "query",
50                 "description": "The date the request was considered completed",
51                 "required": false,
52                 "type": "string"
53             }, {
54                 "name": "status",
55                 "in": "query",
56                 "description": "A full status string e.g. REQREV",
57                 "required": false,
58                 "type": "string"
59             }, {
60                 "name": "cost",
61                 "in": "query",
62                 "description": "The quoted cost of the request",
63                 "required": false,
64                 "type": "number"
65             }, {
66                 "name": "price_paid",
67                 "in": "query",
68                 "description": "The final cost of the request",
69                 "required": false,
70                 "type": "number"
71             }, {
72                 "name": "medium",
73                 "in": "query",
74                 "description": "The medium of the requested item",
75                 "required": false,
76                 "type": "string"
77             }, {
78                 "name": "updated",
79                 "in": "query",
80                 "description": "The last updated date of the request",
81                 "required": false,
82                 "type": "string"
83             }, {
84                 "name": "placed",
85                 "in": "query",
86                 "description": "The date the request was placed",
87                 "required": false,
88                 "type": "string"
89             }, {
90                 "name": "branchcode",
91                 "in": "query",
92                 "description": "Library ID",
93                 "required": false,
94                 "type": "string"
95             }],
96             "produces": [
97                 "application/json"
98             ],
99             "responses": {
100                 "200": {
101                     "description": "A list of ILL requests"
102                 },
103                 "401": {
104                   "description": "Authentication required",
105                   "schema": {
106                     "$ref": "../definitions.json#/error"
107                   }
108                 },
109                 "403": {
110                   "description": "Access forbidden",
111                   "schema": {
112                     "$ref": "../definitions.json#/error"
113                   }
114                 },
115                 "404": {
116                   "description": "ILL requests not found",
117                   "schema": {
118                     "$ref": "../definitions.json#/error"
119                   }
120                 },
121                 "500": {
122                   "description": "Internal server error",
123                   "schema": {
124                     "$ref": "../definitions.json#/error"
125                   }
126                 },
127                 "503": {
128                   "description": "Under maintenance",
129                   "schema": {
130                     "$ref": "../definitions.json#/error"
131                   }
132                 }
133             },
134             "x-koha-authorization": {
135                 "permissions": {
136                     "ill": "1"
137                 }
138             }
139         }
140     }
141 }