Fetch Transfer Request

Fetches a Transfer Request by ID from the Impilo platform.

Path parameters

idintegerRequired

The ID of the Transfer Request to fetch.

Response

This endpoint returns an object

idintegerOptional

Unique identifier for the TransferRequest.

fromCustomerobjectOptional

Customer from which the Inventory will be transferred away from. Typically auto-set to the caller of the TransferRequest endpoints.

toCustomerobjectOptional

The target Customer to send the requested Inventory to.

currentStatusenumOptional

Allowed values: requestedapprovedpendingInventoryvoidedcompleted

createdAtdatetimeOptional

The timestamp when the Transfer Request was first created.

transferRequestNoteslist of objectsOptional

Notes attached to this Transfer Request.

transferRequestEventslist of objectsOptional

The sequence of events that this Transfer Request has undergone. Sorted most recent event first.

requestedEntrieslist of objectsOptional

The Inventory that's being requested to transfer. Can consist of a Device, or a combination of an Item and a Quantity.

1 curl https://app.impiloplatform.com/api/v3/transfer/transfer-request/1 \ 2 -H "Impilo-API-Key: <apiKey>"

1 { 2 "id": 123, 3 "fromCustomer": { 4 "id": 2, 5 "name": "Customer 2" 6 }, 7 "toCustomer": { 8 "id": 3, 9 "name": "Customer 3" 10 }, 11 "currentStatus": "requested", 12 "createdAt": "2024-09-03T16:04:25Z", 13 "transferRequestNotes": [ 14 { 15 "note": "Note Text Here", 16 "createdAt": "2024-09-03T16:04:25.814428100Z" 17 } 18 ], 19 "transferRequestEvents": [ 20 { 21 "name": "requested", 22 "eventTimestamp": "2024-09-03T16:04:25Z" 23 } 24 ], 25 "requestedEntries": [ 26 { 27 "device": { 28 "id": 599, 29 "item": { 30 "id": 791, 31 "manufacturer": { 32 "id": 2, 33 "name": "Custom Manufacturer" 34 }, 35 "name": "Blood Pressure Monitor", 36 "model": "iBloodPressureMonitor123", 37 "sku": "0000001" 38 }, 39 "currentStatus": "withPatient", 40 "currentPatient": { 41 "id": 456, 42 "externalIdentifier": "external-identifier-123", 43 "firstName": "John", 44 "lastName": "Doe", 45 "dateOfBirth": "1987-09-13", 46 "email": "email@example.com", 47 "phoneNumber": "111-222-3333", 48 "archived": true, 49 "address": { 50 "lineOne": "1234 Market Street", 51 "lineTwo": "Suite 110", 52 "city": "Philadelphia", 53 "state": "PA", 54 "zipCode": "19137", 55 "country": "USA" 56 }, 57 "sex": "unknown" 58 }, 59 "deviceIdentifiers": [ 60 { 61 "type": "imei", 62 "value": "354833969951611" 63 }, 64 { 65 "type": "serial", 66 "value": "A44-A0623930" 67 }, 68 { 69 "type": "macAddress", 70 "value": "f51da43314fc" 71 } 72 ], 73 "disabledReadings": false 74 }, 75 "item": { 76 "id": 1 77 }, 78 "quantity": 1 79 } 80 ] 81 }

1	curl https://app.impiloplatform.com/api/v3/transfer/transfer-request/1 \
2	-H "Impilo-API-Key: <apiKey>"

1	{
2	"id": 123,
3	"fromCustomer": {
4	"id": 2,
5	"name": "Customer 2"
6	},
7	"toCustomer": {
8	"id": 3,
9	"name": "Customer 3"
10	},
11	"currentStatus": "requested",
12	"createdAt": "2024-09-03T16:04:25Z",
13	"transferRequestNotes": [
14	{
15	"note": "Note Text Here",
16	"createdAt": "2024-09-03T16:04:25.814428100Z"
17	}
18	],
19	"transferRequestEvents": [
20	{
21	"name": "requested",
22	"eventTimestamp": "2024-09-03T16:04:25Z"
23	}
24	],
25	"requestedEntries": [
26	{
27	"device": {
28	"id": 599,
29	"item": {
30	"id": 791,
31	"manufacturer": {
32	"id": 2,
33	"name": "Custom Manufacturer"
34	},
35	"name": "Blood Pressure Monitor",
36	"model": "iBloodPressureMonitor123",
37	"sku": "0000001"
38	},
39	"currentStatus": "withPatient",
40	"currentPatient": {
41	"id": 456,
42	"externalIdentifier": "external-identifier-123",
43	"firstName": "John",
44	"lastName": "Doe",
45	"dateOfBirth": "1987-09-13",
46	"email": "email@example.com",
47	"phoneNumber": "111-222-3333",
48	"archived": true,
49	"address": {
50	"lineOne": "1234 Market Street",
51	"lineTwo": "Suite 110",
52	"city": "Philadelphia",
53	"state": "PA",
54	"zipCode": "19137",
55	"country": "USA"
56	},
57	"sex": "unknown"
58	},
59	"deviceIdentifiers": [
60	{
61	"type": "imei",
62	"value": "354833969951611"
63	},
64	{
65	"type": "serial",
66	"value": "A44-A0623930"
67	},
68	{
69	"type": "macAddress",
70	"value": "f51da43314fc"
71	}
72	],
73	"disabledReadings": false
74	},
75	"item": {
76	"id": 1
77	},
78	"quantity": 1
79	}
80	]
81	}