---
title: "Look up whether a user is known to Trustly"
method: GET
path: "/customers/lookup"
tags: ["networkCheckApi"]
---

# Look up whether a user is known to Trustly

`GET /customers/lookup`

Checks whether a user has previously used Trustly, based on one or more provided identifiers (email or phone).

Merchants can use this endpoint without having to launch Trustly widget/lightbox. One such use case could be to use this endpoint early in the payment funnel — before the user reaches the payment selection screen — to determine whether to surface Trustly as the top payment option. A `true` response indicates the user is already familiar with Pay by Bank and is more likely to complete a Trustly-powered transaction.

**How it works:** The lookup queries Trustly's user database across all stored identifiers. If any provided identifier matches a known Trustly user, `isInTrustlyNetwork` is returned as `true`.

**Authentication:** Requests must be authenticated with HTTP Basic Auth using your `accessId` as the username and `accessKey` as the password.

## Query parameters

- `email` string, email, required
- `phone` string

## Headers

- `Authorization` string, required

## Response `200`

Lookup result

- CustomerLookupResponse
  - `isInTrustlyNetwork` boolean — True if a transaction has ever been made with any of the provided identifiers.
  - `errorsList` CustomerLookupResponseErrorsListItems[] — Present only on error responses.
    - `code` integer
    - `message` string
    - `location` string
    - `domain` string
    - `occurredAt` integer

## Other responses

- `400` — Bad Request — missing mandatory fields or invalid email
- `401` — Access not authorized
- `500` — Internal server error

---

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