---
title: "Batch lookup users by email or id (internal)"
method: POST
path: "/v1/users/lookup"
tags: ["Internal"]
---

# Batch lookup users by email or id (internal)

`POST /v1/users/lookup`

## Request

- Base URL: `https://identity-api.paymongo.com`
- URL: `https://identity-api.paymongo.com/v1/users/lookup`
- Auth: API key in header `X-Internal-Api-Key`

Returns matching users for the supplied emails OR user_ids (mutually exclusive). Capped at 100 entries per call.

## Request body

- UserBatchLookupUsersRequestDTO
  - `emails` string[]
  - `user_ids` string[]

## Response `200`

OK

- object: Standard response containing data and its metadata if any
  - `data` UserBatchLookupUsersResponseDTO
    - `users` UserBatchLookupUsersItemDTO[]
      - `email` string
      - `organization_id` string
      - `user_id` string
  - `has_more` boolean

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/paymongo/apis/identity.md) - [All operations](https://skmtc.dev/paymongo/apis/identity/llms.txt) - [OpenAPI document](https://skmtc.dev/paymongo/apis/identity/revisions/cc3056164874?raw)