Skip to main content
GET
/
api
/
v4.0
/
integrations
/
transactions
/
hold
/
{holdReferenceId}
cURL
curl --request GET \
  --url https://api.gameball.co/api/v4.0/integrations/transactions/hold/{holdReferenceId} \
  --header 'apikey: <api-key>'
{
  "customerId": "cust_abc12345xyz67890",
  "holdAmount": "2",
  "holdEquivalentPoints": 20,
  "state": "active",
  "dateToExpire": "2024-10-16T08:11:24.675401"
}
Security: Provide both apikey and secretkey headers.

Authorizations

​
apikey
string
header
required

Path Parameters

​
holdReferenceId
string
required

Unique identifier for the hold transaction, used to retrieve the details of the specific hold.

Response

200 - application/json

Hold details retrieved successfully

​
customerId
string

Unique identifier for the customer that you can reference across the customer's whole lifetime. Could be a database ID, random string, email, or anything that uniquely identifies the customer.

Example:

"cust_abc12345xyz67890"

​
holdAmount
number

The monetary value held from the customer's points balance in this specific hold transaction. This is the amount that has been reserved and is associated with the holdReference provided. Example: If a customer has reserved $50 worth of points, the holdAmount in the response would be 50, representing the monetary value currently held under the specified hold reference.

Example:

"2"

​
holdEquivalentPoints
number

The number of points held from the customer's points balance for this specific hold transaction. This represents the exact quantity of points currently locked under the holdReference provided. Example: If the system has held 200 points from the customer's balance, the holdEquivalentPoints in the response would be 200, indicating the points associated with the provided hold reference that are currently unavailable for redemption until further action is taken (e.g., redemption or expiration).

Example:

20

​
state
string

The current status of the hold: Active (The hold is currently in effect and the points or amount are locked), Expired (The hold has expired and the points or amount have been released), Used (The hold has been used, meaning the points or amount have been redeemed).

Example:

"active"

​
dateToExpire
string<date-time>

The date and time when the hold will expire. After this time, the hold reference will no longer be valid for usage.

Example:

"2024-10-16T08:11:24.675401"