---
updatedAt: 2025-10-23T05:34:12.000Z
---

# Batch Disbursement Status - By Reference Number - Headers and Parameters

```json JSON
curl --request GET \
     --url 'https://sandboxapi.moneygram.com/disbursement/status/v1/transactions?targetAudience=AGENT_FACING&userLanguage=en-US&agentPartnerId=30150519&referenceNumber=24550518' \
     --header 'X-MG-ClientRequestId: 4c79b06f-a2af-4859-82c8-28cbb0bf361b' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer HltAz1cV1B7KHiYEvsLDBKoFGTYO'
```

```node Node
import moneygramDeveloper from '@api/moneygram-developer';

moneygramDeveloper.auth('HltAz1cV1B7KHiYEvsLDBKoFGTYO');
moneygramDeveloper.transactionLookupWithReferenceNumber({
  targetAudience: 'AGENT_FACING',
  userLanguage: 'en-US',
  agentPartnerId: '30150519',
  referenceNumber: '24550518',
  'X-MG-ClientRequestId': '4c79b06f-a2af-4859-82c8-28cbb0bf361b'
})
  .then(({ data }) => console.log(data))
  .catch(err => console.error(err));
```

```python Python
import requests

url = "https://sandboxapi.moneygram.com/disbursement/status/v1/transactions?targetAudience=AGENT_FACING&userLanguage=en-US&agentPartnerId=30150519&referenceNumber=24550518"

headers = {
    "accept": "application/json",
    "X-MG-ClientRequestId": "4c79b06f-a2af-4859-82c8-28cbb0bf361b",
    "authorization": "Bearer HltAz1cV1B7KHiYEvsLDBKoFGTYO"
}

response = requests.get(url, headers=headers)

print(response.text)
```

```java Java
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://sandboxapi.moneygram.com/disbursement/status/v1/transactions?targetAudience=AGENT_FACING&userLanguage=en-US&agentPartnerId=30150519&referenceNumber=24550518")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("X-MG-ClientRequestId", "4c79b06f-a2af-4859-82c8-28cbb0bf361b")
  .addHeader("authorization", "Bearer HltAz1cV1B7KHiYEvsLDBKoFGTYO")
  .build();

Response response = client.newCall(request).execute();
```

```json Response Example
{
  "transactionId": "873e1bc1-99fe-44ea-af4b-c23e0f6754e6",
  "referenceNumber": "24550518",
  "transactionSendDateTime": "2025-03-27T09:54:41.699",
  "expectedPayoutDate": "2025-03-27",
  "transactionStatus": "AVAILABLE",
  "transactionSubStatus": [],
  "originatingCountryCode": "USA",
  "destinationCountryCode": "USA",
  "serviceOptionCode": "WILL_CALL",
  "serviceOptionName": "10 Minute Service",
  "sendAmount": {
    "amount": {
      "value": 100,
      "currencyCode": "USD"
    },
    "fees": {
      "value": 4,
      "currencyCode": "USD"
    },
    "taxes": {
      "value": 0,
      "currencyCode": "USD"
    },
    "discountsApplied": {
      "totalDiscount": {
        "value": 0,
        "currencyCode": "USD"
      }
    },
    "total": {
      "value": 104,
      "currencyCode": "USD"
    }
  },
  "receiveAmount": {
    "amount": {
      "value": 100,
      "currencyCode": "USD"
    },
    "fees": {
      "value": 0,
      "currencyCode": "USD"
    },
    "taxes": {
      "value": 0,
      "currencyCode": "USD"
    },
    "total": {
      "value": 100,
      "currencyCode": "USD"
    },
    "fxRate": 1
  },
  "sender": {
    "businessInfo": {
      "businessName": "ACMECORP",
      "businessRegistrationNumber": "ACME2420",
      "businessCountryOfRegistration": "USA"
    },
    "businessProfileId": "bp-m05srfqx-f4091e21"
  },
  "beneficiary": {
    "consumer": {
      "firstName": "Sally",
      "lastName": "Smith"
    }
  }
}
```

# By Reference Number - Headers and Parameters

<!-- json@2-5 -->
<!-- node@3-10 -->
<!-- python@3-9 -->
<!-- java@4-8 -->

The application must call the <a href="https://developer.moneygram.com/moneygram-developer/reference/transactionlookupwithreferencenumber" target="_blank">Retrieve a Transaction</a> endpoint with a GET HTTP method, providing the OAuth `access_token`, required headers and parameter values. 


**Retrieve a transaction by referenceNumber**

`GET disbursement/status/v1/transactions/?referenceNumber={referenceNumber}`