List recent orders
GET
/orders
const url = 'https://api.1up.gift/orders?limit=10';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.1up.gift/orders?limit=10' \ --header 'Authorization: Bearer <token>'Returns your most recently placed orders, newest first, in the same shape as the
order.created webhook payload. Intended for polling integrations; prefer a webhook
subscription if you want orders pushed to you as they happen.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”limit
integer format: int32
How many orders to return, 1–50. Defaults to 10.
Responses
Section titled “Responses”The most recent orders.
Array<object>
object
id
integer format: int32
event
null | string
reference
null | string
customerId
integer format: int64
value
number format: double
currency
null | string
country
null | string
sourceType
null | string
externalReference
null | string
giftSelectionType
null | string
giftProductId
null | integer format: int32
giftsCollectionId
null | integer format: int32
wrappingKey
null | string
fromName
null | string
deliveryMode
null | string
lineCount
integer format: int32
createdBy
null | integer format: int64
creationDate
string format: date-time
Array<object>
object
id
integer format: int32
event
null | string
reference
null | string
customerId
integer format: int64
value
number format: double
currency
null | string
country
null | string
sourceType
null | string
externalReference
null | string
giftSelectionType
null | string
giftProductId
null | integer format: int32
giftsCollectionId
null | integer format: int32
wrappingKey
null | string
fromName
null | string
deliveryMode
null | string
lineCount
integer format: int32
createdBy
null | integer format: int64
creationDate
string format: date-time
Examplegenerated
[ { "id": 1, "event": "example", "reference": "example", "customerId": 1, "value": 1, "currency": "example", "country": "example", "sourceType": "example", "externalReference": "example", "giftSelectionType": "example", "giftProductId": 1, "giftsCollectionId": 1, "wrappingKey": "example", "fromName": "example", "deliveryMode": "example", "lineCount": 1, "createdBy": 1, "creationDate": "2026-04-15T12:00:00Z" }]Array<object>
object
id
integer format: int32
event
null | string
reference
null | string
customerId
integer format: int64
value
number format: double
currency
null | string
country
null | string
sourceType
null | string
externalReference
null | string
giftSelectionType
null | string
giftProductId
null | integer format: int32
giftsCollectionId
null | integer format: int32
wrappingKey
null | string
fromName
null | string
deliveryMode
null | string
lineCount
integer format: int32
createdBy
null | integer format: int64
creationDate
string format: date-time
Examplegenerated
[ { "id": 1, "event": "example", "reference": "example", "customerId": 1, "value": 1, "currency": "example", "country": "example", "sourceType": "example", "externalReference": "example", "giftSelectionType": "example", "giftProductId": 1, "giftsCollectionId": 1, "wrappingKey": "example", "fromName": "example", "deliveryMode": "example", "lineCount": 1, "createdBy": 1, "creationDate": "2026-04-15T12:00:00Z" }]