curl --request POST \
  --url https://api.grainledger.com/api/v1/batches \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalReference": "Sunday online gifts",
  "batchDate": "2026-08-16"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({externalReference: 'Sunday online gifts', batchDate: '2026-08-16'})
};

fetch('https://api.grainledger.com/api/v1/batches', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.grainledger.com/api/v1/batches"

payload = {
    "externalReference": "Sunday online gifts",
    "batchDate": "2026-08-16"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "id": "<string>",
  "externalBatchId": "<string>",
  "externalReference": "<string>",
  "batchDate": "2023-11-07T05:31:56Z",
  "totals": {
    "gross": 123,
    "fees": 123,
    "net": 123,
    "paymentCount": 123,
    "donationCount": 123
  },
  "status": "OPEN",
  "isCommitted": true,
  "committedAt": "2023-11-07T05:31:56Z",
  "processedAt": "2023-11-07T05:31:56Z",
  "errorMessage": "<string>",
  "givingIntegration": {
    "id": "<string>",
    "provider": "<string>",
    "name": "<string>"
  },
  "merchant": {
    "id": "<string>",
    "name": "<string>",
    "campusId": "<string>",
    "dimensionValueId": "<string>"
  },
  "settlement": {
    "id": "<string>",
    "provider": "<string>",
    "externalReference": "<string>",
    "status": "<string>",
    "totalNet": 123
  },
  "journalEntry": {
    "id": "<string>",
    "entryNumber": "<string>",
    "referenceNumber": "<string>"
  },
  "dimensions": [
    {
      "dimensionId": "<string>",
      "dimensionValueId": "<string>",
      "dimensionName": "<string>",
      "dimensionValueName": "<string>"
    }
  ],
  "fundSplits": [
    {
      "fundId": "<string>",
      "fundName": "<string>",
      "amount": 123
    }
  ],
  "contributionIds": [
    "<string>"
  ],
  "isFrozen": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "code": "forbidden",
  "message": "You do not have access to this organization.",
  "error": "You do not have access to this organization."
}

{
  "code": "forbidden",
  "message": "You do not have access to this organization.",
  "error": "You do not have access to this organization."
}

{
  "code": "forbidden",
  "message": "You do not have access to this organization.",
  "error": "You do not have access to this organization."
}

{
  "code": "forbidden",
  "message": "You do not have access to this organization.",
  "error": "You do not have access to this organization."
}

{
  "code": "forbidden",
  "message": "You do not have access to this organization.",
  "error": "You do not have access to this organization."
}

{
  "code": "forbidden",
  "message": "You do not have access to this organization.",
  "error": "You do not have access to this organization."
}

{
  "code": "forbidden",
  "message": "You do not have access to this organization.",
  "error": "You do not have access to this organization."
}

{
  "code": "forbidden",
  "message": "You do not have access to this organization.",
  "error": "You do not have access to this organization."
}