Find Order

GET /api/Next/order/{trx}

Retrieve an order using the trx returned by the Create order endpoint. Orders that are deleted cannot be retrieved.

Requested Parameters

Field	Type	Required	Default	Description
trx	String	Yes	-	Trx of order

Example Request

curl -X GET https://connect.relograde.com/api/Next/order/RELO0TFQK8FXQXSPURM \
-H "Authorization: Bearer <token>"

Example Response

{
  "trx": "RELO0TFQK8FXQXSPURM",
  "priceCurrency": "eur",
  "priceAmount": 58.14,
  "priceVat": 0.23,
  "priceInclVat": 58.37,
  "priceFx": 1.0,
  "dateCreated": "2025-01-24T11:30:20.000Z",
  "paymentStatus": "paid",
  "type": "api",
  "reference": "test",
  "state": "sandbox",
  "orderStatus": "cancelled",
  "isBalancePayment": true,
  "downloaded": false,
  "items": [
    {
      "product": {
        "slug": "rewarble-ww-eur-5",
        "name": "rewarble 5 EUR WW",
        "brand": "rewarble",
        "productType": "topup",
        "region": "ww",
        "faceValueAmount": 5.0,
        "faceValueCurrency": "eur",
        "mainCategory": "giftcard",
        "redeemType": "currency",
        "isStocked": true
      },
      "amount": 5,
      "priceCurrency": "eur",
      "singlePriceAmount": 5.1,
      "totalPriceAmount": 25.5,
      "totalPriceVat": 0.1,
      "totalPriceInclVat": 25.6,
      "priceFx": 1.0,
      "paymentCurrency": "eur",
      "singlePriceAmountInPaymentCurrency": 5.1,
      "totalPriceAmountInPaymentCurrency": 25.5,
      "totalPriceVatInPaymentCurrency": 0.1,
      "totalPriceInclVatInPaymentCurrency": 25.6,
      "orderLines": [
        {
          "tag": "TAG-189a9fe4-3a7e-40fd-a357-153e885481fd",
          "status": "cancelled"
        },
        {
          "tag": "TAG-1ee8f999-c47f-4cfb-9309-0912f62dcc49",
          "status": "cancelled"
        },
        {
          "tag": "TAG-faef041d-774e-4c0a-88ee-6ac3ae1261c3",
          "status": "cancelled"
        },
        {
          "tag": "TAG-6fa744d7-4a6b-415a-9833-d06274c73145",
          "voucherCode": "TEST7HWBDB09M9IX",
          "voucherSerial": "a8df2ffd-fe03-45f2-868d-c7510f8c2b30",
          "voucherDateExpired": "2026-01-24T11:41:24.000Z",
          "status": "finished",
          "token": "11594lSw4pj3DhaUvefkabODQfVZ9fjGeTU"
        },
        {
          "tag": "TAG-6823ef30-94cd-45d4-a23b-25e93ebb9145",
          "voucherCode": "TESTRVB9C3YPXAH2",
          "voucherSerial": "13766f46-361e-40cb-8cb8-603b2ccdcac6",
          "status": "finished",
          "token": "11595aEcZZgR3om4uJ7hfIfGHFjtgluG6fO"
        }
      ],
      "linesCompleted": 2,
      "productSlug": "rewarble-ww-eur-5",
      "faceValueAmount": 5.0,
      "faceValueCurrency": "eur",
      "faceValueFx": 1.0
    },
    {
      "product": {
        "slug": "rewarble-variable-eur",
        "name": "Rewarble Variable EUR",
        "brand": "rewarble",
        "productType": "topup",
        "region": "ww",
        "faceValueCurrency": "eur",
        "faceValueMin": 5.0,
        "faceValueMax": 500.0,
        "mainCategory": "giftcard",
        "redeemType": "currency",
        "isStocked": true
      },
      "amount": 1,
      "priceCurrency": "eur",
      "singlePriceAmount": 32.64,
      "totalPriceAmount": 32.64,
      "totalPriceVat": 0.13,
      "totalPriceInclVat": 32.77,
      "priceFx": 1.0,
      "paymentCurrency": "eur",
      "singlePriceAmountInPaymentCurrency": 32.64,
      "totalPriceAmountInPaymentCurrency": 32.64,
      "totalPriceVatInPaymentCurrency": 0.13,
      "totalPriceInclVatInPaymentCurrency": 32.77,
      "orderLines": [
        {
          "tag": "TAG-f43c2cf3-bebc-4486-8dcb-c417c874db0b",
          "voucherCode": "TEST39P3O3UOZQYB",
          "voucherSerial": "e14775d0-b16f-4b5c-a714-c89b1ae485d3",
          "status": "finished",
          "token": "11596FEQUG2AbNIx2IRzpv8Whqs3SGYUQ23"
        }
      ],
      "linesCompleted": 1,
      "productSlug": "rewarble-variable-eur",
      "faceValueAmount": 32.0,
      "faceValueCurrency": "eur",
      "faceValueFx": 1.0
    }
  ]
}

Response Fields

Field name	Field type	Field description
trx	String	Trx of order (Identifier)
priceCurrency	String	Currency of price
priceAmount	Decimal	Price before VAT
priceVat	Decimal	VAT amount
priceInclVat	Decimal	Price including VAT
priceFx	Decimal	Price calculation multiplier
dateCreated	Date	Creation date of order
paymentStatus	String	Status of payment
type	String	Type of system used to create order (portal or api)
reference	String	Reference of order
state	String	Environment of order (live or sandbox)
orderStatus	String	Status of order
isBalancePayment	Boolean	Whether the order is a balance payment or not
downloaded	Boolean	Whether the order has been downloaded or not
items	Object	Item object
product	Object	Product object
slug	String	Slug of product
name	String	Name of product
brand	String	Brand of product
productType	String	Type of product
region	String	Region in which the product can be used
faceValueAmount	Decimal	Value of product
faceValueCurrency	String	Currency of faceValue
mainCategory	String	Main category of product
redeemType	String	Redeem type of product
isStocked	Boolean	Whether the product is in stock or not
amount	Integer	Amount of product
priceCurrency	String	Currency of price
singlePriceAmount	Decimal	Price for a single product
totalPriceAmount	Decimal	Total price of all products
totalPriceVat	Decimal	Total VAT amount
totalPriceInclVat	Decimal	Total price including VAT
paymentCurrency	String	Currency of payment price
singlePriceAmountInPaymentCurrency	Decimal	Price of a single product in payment currency
totalPriceAmountInpaymentCurrency	Decimal	Total price of all products in payment currency
totalPriceVatInPaymentCurrency	Decimal	Total VAT amount in payment currency
totalPriceInclVatInPaymentCurrency	Decimal	Total price including VAT in payment currency
orderLines	Array	Array of codes ordered
tag	String	Internal tag (id) of the code in Relograde
voucherCode	String	Redeem code of voucher (Not always present)
voucherSerial	String	External serial code of voucher
status	String	Status of product
token	String	Token used for voucherUrl
voucherUrl	String	Url to redeem page (Not always present)
linesCompleted	Integer	Amount of orderLines with status finished
productSlug	String	Slug of product
faceValueAmount	Decimal	Value of product
faceValueCurrency	String	Currency of faceValueAmount
faceValuefx	Decimal	Price calculation multiplier for faceValueAmount

Errors

Errors response

Endpoint	HTTP status code	HTTP status	Message	Reason
Find order	404	NOT_FOUND	Order not found

Notes

note

• Currency codes follow ISO 4217 standard
• Codes shown in example have been altered and made invalid
• Price information may be provided either as fixed price or as fee.
• Price information may have been altered in the documentation