---
title: "Searches the cards by program manager."
method: GET
path: "/api/v1/cards/program-manager/search"
tags: ["CardSearch"]
---

# Searches the cards by program manager.

`GET /api/v1/cards/program-manager/search`

## Request

- Base URL: `https://cardsapi-uat-pub.globalprocessing.net`
- URL: `https://cardsapi-uat-pub.globalprocessing.net/api/v1/cards/program-manager/search`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://uatists.globalprocessing.net/connect/token` scopes: `readWrite`

## Query parameters

- `PublicToken` integer
- `ProductId` integer
- `ProductName` string
- `CardStatusCodes` string[]
- `FirstName` string
- `LastName` string
- `Email` string
- `Mobile` string
- `PostCode` string
- `City` string
- `AddressLine1` string
- `DateOfBirth` string
- `CustomerReference` string
- `MiddleName` string
- `Offset` integer
- `Fetch` integer
- `PageSize` integer, required
- `PageNumber` integer, required

## Response `200`

Success

- SearchCardsProgramManagerResponse[]
  - `publicToken` integer: Gets or sets the public token.
  - `title` string, nullable: Gets or sets the title.
  - `firstName` string, nullable: Gets or sets the first name.
  - `lastName` string, nullable: Gets or sets the last name.
  - `email` string, nullable: Gets or sets the email.
  - `tel` string, nullable: Gets or sets the tel.
  - `mobile` string, nullable: Gets or sets the mobile.
  - `dateOfBirth` string, nullable: Gets or sets the date of birth.
  - `postCode` string, nullable: Gets or sets the post code.
  - `city` string, nullable: Gets or sets the city.
  - `addressLine1` string, nullable: Gets or sets the address line 1.
  - `customerReference` string, nullable: Gets or sets the customer account.
  - `expiryDate` string, nullable: Gets or sets the expiry date.
  - `currencyCode` string, nullable: Gets or sets the currency code.
  - `availableBalance` number, double: Gets or sets the available balance.
  - `actualBalance` number, double: Gets or sets the actual balance.
  - `CardStatus` 'Active' | 'ReferToIssuer' | 'Inactive' | 'InvalidMerchant' | 'CaptureCard' | 'DoNotHonour' | 'UnspecifiedError' | 'HonourWithIdentification' | 'PartialApproval' | 'InvalidTransaction' | 'InvalidAmount' | 'NoSuchCardNumber' | 'NoSuchIssuer' | 'CustomerCancellation' | 'FormatError' | 'IssuerSignOff' | 'CompletedPartially' | 'ExpiredCardCapture' | 'RestrictedCardCapture' | 'CardAcceptorCallAcquirerSecurityCapture' | 'AllowablePinTriesExceededCapture' | 'LostCard' | 'StolenCard' | 'ClosedAccount' | 'InsufficientFunds' | 'CardExpired' | 'IncorrectPin' | 'TransactionNotPermittedToCardholder' | 'TransactionNotPermittedToTerminal' | 'SuspectedFraud' | 'ExceedsWithdrawalLimit' | 'RestrictedCard' | 'SecurityViolation' | 'OriginalAmountIncorrect' | 'ExceedsWithdrawalFrequencyLimit' | 'CardAcceptorCallAcquirersSecurityDepartment' | 'CardToBePickedUpAtAtm' | 'ResponseReceivedTooLate' | 'CardholderToContactIssuer' | 'PinNotChanged' | 'AllowableNumberOfPinTriesExceeded' | 'InvalidToAccountInField3' | 'InvalidFromAccountInField3' | 'CardNotActivatedYet' | 'UnacceptablePinRetry' | 'NetworkError' | 'ForeignNetworkError' | 'TimeoutAtIem' | 'CardDestroyed' | 'ApprovedSpecial' | 'PinValidationNotPossible' | 'PurchaseOnlyNoCashBack' | 'CryptographicFailure' | 'UnacceptablePin' | 'InvalidVerificationCode' | 'IssuerOrSwitchInoperative' | 'UnableToRoute' | 'ViolationOfLaw' | 'DuplicateTransmission' | 'ReconcileError' | 'SystemMalfunction' | 'RefundGivenToCustomer' | 'CardVoided' | 'VerificationDataFailed' | 'RequiresScaCard' | 'RequiresScaNonCard' | 'ShortTermDebitBlock' | 'ShortTermFullBlock' | 'LongTermDebitBlock' | 'LongTermFullBlock' | 'GpsProtectShortTermDebitBlock' | 'GpsProtectShortTermFullBlock' | 'GpsProtectLongTermDebitBlock' | 'GpsProtectLongTermFullBlock' | 'IvrLostStolenBlock' | 'ForceStip' | 'DeclineForCvv2Failure' | 'PinChangeUnblockDeclined' | 'UnsafePin' | 'BlockedByIssuer' | 'BlockedByCardholder' | 'UnknownCardStatus': Gets or sets the card status code.
  - `isLive` boolean: Gets or sets a value indicating whether this instance is live.
  - `cardType` 'Physical' | 'Virtual' | 'MasterVirtual': Gets or sets the type of the card.
  - `productId` integer: Gets or sets the product identifier.
  - `productName` string, nullable: Gets or sets the name of the product.
  - `schemeId` integer: Gets or sets the scheme identifier.
  - `schemeName` string, nullable: Gets or sets the name of the scheme.
  - `middleName` string, nullable: Gets or sets the middle name.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Client Error
- `500`: Server Error

## Changes

- **2026-11-03** `a5b5e4fdcf41`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/thredd/apis/core-cards/changes/api/v1/cards/program-manager/search/get.md)

---

[API](https://skmtc.dev/thredd/apis/core-cards.md) - [All operations](https://skmtc.dev/thredd/apis/core-cards/llms.txt) - [OpenAPI document](https://skmtc.dev/thredd/apis/core-cards/revisions/a5b5e4fdcf41?raw)