---
title: "Get Account IDs by Partner Consumer ID"
method: GET
path: "/programs/{programCode}/accounts/lookup/partnerconsumerid/{externalConsumerId}"
tags: ["Account"]
---

# Get Account IDs by Partner Consumer ID

`GET /programs/{programCode}/accounts/lookup/partnerconsumerid/{externalConsumerId}`

This endpoint allows partners to get a list of BaaS Account IDs based on external consumer IDs provided during Enrollment (Account.PartnerConsumerId).

## Path parameters

- `programCode` string, required
- `externalConsumerId` string, required

## Headers

- `X-GD-RequestId` string, required

## Response `200`

OK

- SearchAccountResponse — Represents the response containing search results for accounts.
  - `accounts` AccountSearchResult[], nullable — The list of accounts matching the search criteria.
    - `accountIdentifier` string, nullable — The unique identifier for the account.
    - `productKey` integer — The key identifying the product associated with the account.
    - `programCode` string, nullable — The program code under which the account was issued.
    - `partnerKey` integer — The key identifying the partner associated with the account.
    - `accountStatusKey` integer — The key representing the current status of the account.
    - `firstName` string, nullable — The first name of the primary account holder.
    - `lastName` string, nullable — The last name of the primary account holder.
    - `userId` string, uuid — The unique identifier for the user associated with the account.
    - `accountHolderIdentifier` string, uuid — The unique identifier for the account holder.
    - `partnerAccountId` string, nullable — The partner-specific account identifier, if the account is linked to a partner system.
    - `bin` string, nullable — The Bank Identification Number (BIN) associated with the account or payment instrument.
  - `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/versions/666553766b78/schema)