---
title: "Search members by external ID, profile response, or email. Roles: partner admin."
method: POST
path: "/api/partners/orgs/{orgId}/members/search"
tags: ["Members", "Partners"]
---

# Search members by external ID, profile response, or email. Roles: partner admin.

`POST /api/partners/orgs/{orgId}/members/search`

To search for a member, you must choose a field key and provide a value.

Field Keys:
- `EMAIL` - search by email address (case-insensitive)
- `EXTERNAL_ID` - search by the member's unique ID provided by your system
    - (this is only used if you system is the identity provider for the organization)
- `USERNAME` - search by username (case-insensitive)
- `MEMBER_NUMBER` - (DEPRECATED; use USERNAME instead) search by username (case-insensitive)
- `PROFILE_RESPONSE` - search by the response to a custom attribute or "profile question"

When searching by `PROFILE_RESPONSE`, you must also specify the question (attribute):
- `questionId` (defined by Mobile Coach)
- `externalReferenceId` (defined via the admin console)

Notes:
- The search may return more than one result.

## Path parameters

- `orgId` integer, required

## Request body

- PartnerMemberSearchRequest
  - `fieldKey` 'EMAIL' | 'EXTERNAL_ID' | 'MEMBER_NUMBER' | 'PROFILE_RESPONSE' | 'USERNAME', required
  - `questionId` integer
  - `externalReferenceId` string
  - `value` string, required

## Response `200`

OK

- PartnerMemberSearchResponse
  - `members` PartnerMemberFull[], required
    - `memberNumber` string
    - `memberId` integer, required
    - `firstName` string
    - `middleName` string
    - `lastName` string
    - `email` string
    - `phone` string
    - `birthDate` string, date
    - `username` string, required
    - `externalId` string
    - `idpTypeCode` 'ABUSE_PREVENTION_SYSTEMS' | 'CLASSMARKER' | 'FINALSITE' | 'GAMEPLAN' | 'I9_SPORTS' | 'JDP' | 'LEAGUEAPPS' | 'LEAGUEAPPS_IDP' | 'LEAGUEAPPS_MLB' | 'MOBILE_COACH' | 'NCGA' | 'NCSI' | 'OPTOJUMP' | 'RAPSODO' | 'SAFESPORT' | 'SALESFORCE' | 'SAML_TEST_ID' | 'SPORT_80' | 'SPORTSENGINE' | 'STERLING' | 'ULTIMATE' | 'USA_FENCING' | 'USA_LACROSSE' | 'USA_LACROSSE_SAML' | 'USA_WRESTLING' | 'US_SAILING' | 'US_SKI_AND_SNOWBOARD' | 'US_SPORTS_CAMPS' | 'USSA' | 'USTA' | 'WEBPOINT' | 'WEBPOINT_OAUTH' | 'WORDPRESS', required
    - `createTime` string, date-time, required
    - `updateTime` string, date-time, required
    - `profileResponses` PartnerMemberProfileResponse[]
      - `questionId` integer, required
      - `externalReferenceId` string
      - `name` string, required
      - `responses` string[], required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

## Changes

- **2026-09-02** `870f28ba2607` — 5 info
  - added the optional property `error/errorId` to the response with the `400` status
  - added the optional property `error/errorId` to the response with the `401` status
  - added the optional property `error/errorId` to the response with the `403` status
  - added the optional property `error/errorId` to the response with the `404` status
  - …1 more

[Change history](https://skmtc.dev/mobilecoach/apis/untitled-api/changes/api/partners/orgs/:orgId/members/search/post.md)

---

[API](https://skmtc.dev/mobilecoach/apis/untitled-api.md) · [All operations](https://skmtc.dev/mobilecoach/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mobilecoach/untitled-api/revisions/870f28ba2607/schema)