---
title: "Lookup POIs by merchant identifiers"
method: GET
path: "/pois/lookup"
tags: ["Common", "POI Maintenance"]
---

# Lookup POIs by merchant identifiers

`GET /pois/lookup`

Resolves POI UIDs from one or more merchant identifiers. At least one query parameter must be provided. Parameters are grouped into three resolution paths: Path 1 (merchantId), Path 2 (entity identifiers — AND-combinable), Path 3 (estateManagementId). merchantId + altVfiEntityId is also supported.

## Query parameters

- `merchantId` string
- `altVfiEntityId` string
- `siteReferenceId` string
- `storeNumber` string
- `merchantName` string
- `siteName` string
- `estateManagementId` string

## Response `200`

POI lookup result.

- PoiLookupResponse — Response for POI lookup by merchant identifiers.
  - `merchantName` string — Merchant name.
  - `siteName` string — Site name.
  - `siteReferenceId` string — Site reference ID.
  - `storeNumber` string — Alias for siteReferenceId.
  - `merchantId` string — Acquirer MID from Payment Provider Contract.
  - `altVfiEntityId` string — Verifone gateway MID (ISO8583 DE42).
  - `merchantCompanyUid` string, uuid — entityUid of the ancestor MERCHANT_COMPANY entity.
  - `entityUid` string, uuid — entityUid of the resolved site.
  - `pois` PoiSummary[] — POIs belonging to the resolved site.
    - `poiUid` string, uuid — Verifone POI identifier.
    - `estateManagementId` string — Estate management identifier.
    - `poiName` string — Name of the POI.

## Other responses

- `400` — Bad Request
- `401` — Unauthorised Request
- `403` — Forbidden Request.
- `404` — Not Found Request
- `422` — Unprocessable Entity — conflicting or ambiguous identifiers.
- `429` — Too Many Requests
- `500` — Internal Error
- `503` — Service Not Available
- `504` — Service Timeout

---

[API](https://skmtc.net/verifone/apis/checkout-api.md) · [All operations](https://skmtc.net/verifone/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verifone/checkout-api/revisions/ed8dc1f12a5a/schema)