Order Transactions Batch Job

curl --request POST \
  --url https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --header 'secretkey: <api-key>' \
  --data '
{
  "body": [
    "ORDER-001",
    "ORDER-002",
    "ORDER-003"
  ]
}
'

const options = {
  method: 'POST',
  headers: {
    apikey: '<api-key>',
    secretkey: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({body: JSON.stringify(['ORDER-001', 'ORDER-002', 'ORDER-003'])})
};

fetch('https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions"

payload = { "body": ["ORDER-001", "ORDER-002", "ORDER-003"] }
headers = {
    "apikey": "<api-key>",
    "secretkey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

using RestSharp;


var options = new RestClientOptions("https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("apikey", "<api-key>");
request.AddHeader("secretkey", "<api-key>");
request.AddJsonBody("{\n  \"body\": [\n    \"ORDER-001\",\n    \"ORDER-002\",\n    \"ORDER-003\"\n  ]\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions"

	payload := strings.NewReader("{\n  \"body\": [\n    \"ORDER-001\",\n    \"ORDER-002\",\n    \"ORDER-003\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("apikey", "<api-key>")
	req.Header.Add("secretkey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'body' => [
        'ORDER-001',
        'ORDER-002',
        'ORDER-003'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "apikey: <api-key>",
    "secretkey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions")
  .header("apikey", "<api-key>")
  .header("secretkey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"body\": [\n    \"ORDER-001\",\n    \"ORDER-002\",\n    \"ORDER-003\"\n  ]\n}")
  .asString();

{
  "jobId": 1748392
}

POST

api

v4.0

integrations

batch

orders

transactions

Order Transactions Batch Job

curl --request POST \
  --url https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --header 'secretkey: <api-key>' \
  --data '
{
  "body": [
    "ORDER-001",
    "ORDER-002",
    "ORDER-003"
  ]
}
'

const options = {
  method: 'POST',
  headers: {
    apikey: '<api-key>',
    secretkey: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({body: JSON.stringify(['ORDER-001', 'ORDER-002', 'ORDER-003'])})
};

fetch('https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions"

payload = { "body": ["ORDER-001", "ORDER-002", "ORDER-003"] }
headers = {
    "apikey": "<api-key>",
    "secretkey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

using RestSharp;


var options = new RestClientOptions("https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("apikey", "<api-key>");
request.AddHeader("secretkey", "<api-key>");
request.AddJsonBody("{\n  \"body\": [\n    \"ORDER-001\",\n    \"ORDER-002\",\n    \"ORDER-003\"\n  ]\n}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions"

	payload := strings.NewReader("{\n  \"body\": [\n    \"ORDER-001\",\n    \"ORDER-002\",\n    \"ORDER-003\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("apikey", "<api-key>")
	req.Header.Add("secretkey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'body' => [
        'ORDER-001',
        'ORDER-002',
        'ORDER-003'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "apikey: <api-key>",
    "secretkey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

HttpResponse<String> response = Unirest.post("https://api.gameball.co/api/v4.0/integrations/batch/orders/transactions")
  .header("apikey", "<api-key>")
  .header("secretkey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"body\": [\n    \"ORDER-001\",\n    \"ORDER-002\",\n    \"ORDER-003\"\n  ]\n}")
  .asString();

{
  "jobId": 1748392
}

Order Transactions Batch Job

Retrieve the full transaction history (payments, rewards, refunds) for up to 1,000 orders in a single call. The job runs asynchronously — this endpoint returns a jobId immediately. Poll Check Batch Status to get the results. For a single order, use Order Transactions instead.

Security: Requires apiKey and secretKey headers. The secret key is required on v4.1; on v4.0 it is required when High Security Mode is enabled.

Poll result shape

When the job completes, the batch status response includes successful and failed arrays. Every submitted order ID appears in one of them — no ID is silently dropped.

Field	Description
`successful[].orderId`	Order ID that was found
`successful[].transactions`	Payment, refund, and reward entries for that order
`successful[].count`	Number of transactions returned
`failed[].customerId`	Order ID that failed (field name mirrors other batch failure payloads)
`failed[].message`	Failure reason (e.g. `Order Not Found`)

transactionType values in this batch response include Payment, Refund, and PartialRefund.

If a PaymentReward record does not exist for an order, a synthetic Payment entry is returned so the order always has at least one transaction. Refunds appear as separate Refund or PartialRefund entries alongside the original Payment entry.

Authorizations

apikey

string

header

required

secretkey

string

header

required

Body

application/json

body

string[]

required

Order IDs to retrieve. Min 1, max 1,000 items.

Required array length: 1 - 1000 elements

Example:

["ORDER-001", "ORDER-002", "ORDER-003"]

Response

200 - application/json

Batch order transactions job initiated successfully

jobId

number

The assigned job ID, which is later used for status verification and response retrieval.

Example:

1748392

API documentation

Webhooks

Order Transactions Batch Job

Order Transactions Batch Job

Poll result shape

Authorizations

Body

Response

​Order Transactions Batch Job

​Poll result shape

Authorizations

Body

Response

Order Transactions Batch Job

Poll result shape