---
title: "Retrieves eCash partners by geographic location for a specific account."
method: GET
path: "/programs/{programCode}/accounts/{accountIdentifier}/eCashPartnersByLocation"
tags: ["ECash"]
---

# Retrieves eCash partners by geographic location for a specific account.

`GET /programs/{programCode}/accounts/{accountIdentifier}/eCashPartnersByLocation`

Returns a list of participating eCash partners (retailers) near a specified location for the given account. You can search by latitude, longitude, ZIP code, city, state, and radius. This endpoint is useful for finding nearby eCash partners where users can perform cash transactions. All location parameters are optional, but at least one should be provided to filter results. The response includes partner details that match the specified criteria.

## Path parameters

- `programCode` string, required
- `accountIdentifier` string, required

## Query parameters

- `latitude` number, double
- `longitude` number, double
- `zip` string
- `city` string
- `state` string
- `radius` number, double

## Headers

- `X-GD-RequestId` string, required

## Response `200`

OK

- GetECashPartnersByLocationResponse — Get ECash Partners By Location Response – Contains the list of eCash partners (retailers) found by location.
  - `partners` PartnerByLocationData[], nullable — The list of eCash partners (retailers) found by location.
    - `partnerId` string, nullable — The unique identifier of the eCash partner (retailer).
    - `partnerName` string, nullable — The display name of the eCash partner (retailer).
    - `faceFee` string, nullable — The face fee (as a string, e.g., "3.95") associated with transactions at this partner location.
    - `retailerCode` string, nullable — The unique code assigned to the retailer location.
    - `retailerName` string, nullable — The display name of the retailer location.
    - `retailerDisplayPriority` integer — The display priority for the retailer in search results (lower values indicate higher priority).
  - `responseDetails` ResponseDetail[], nullable — Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.
    - `code` integer — The primary status or error code for the response (e.g., 200 for success, 400 for validation error).
    - `subCode` integer, nullable — An optional subcode providing more granular detail about the response or error.
    - `description` string, nullable — A human-readable description of the response, error, or status.
    - `url` string, nullable — A URL linking to documentation or a web page with more information about the response code.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/revisions/666553766b78/schema)