Skip to main content

Why do some cards not appear in /card-management/v1/search results?

Because the search filters exclude them. If a card does not match PayerId, ColCoCode, CardStatus, or other filters, it will not be returned
 

The card has a status not included in your filter

Typical filters used by integrators include:

ACTIVE, ON_ORDER, BLOCKED, TEMP_BLOCKED_CUSTOMER,
TEMP_BLOCKED_SHELL, PENDING_RENEWAL, FRAUD

If the card is:

  • EXPIRED
  • CANCELLED
  • PENDING_SYNC
  • REPLACED …it will not show up.

2) Wrong or outdated PayerId

If the payer changed (sub-account migration, new billing structure), the card may now sit under a different payer than the one in your request.

3) Wrong ColCoCode

If the country code in the card metadata differs from the ColCoCode you filter on, the card will not match.

4) PageSize too small or paging not implemented

If you set:

"PageSize": 50

but the account has >50 cards, and the missing card sits on page 2 or 3, it will not appear unless you implement full paging.

5) The card was recently moved between accounts

Movement of PANs between sub-accounts (very common at month-end) may cause cards to “disappear” for a short time until backend sync completes.

6) The card is in a backend state that is not exposed to API

Rare, but possible during:

About us

The Shell Developer Portal supports partners in onboarding to Shell APIs and turning ideas into production-ready solutions.

 

Shell logo

Contact

Login to your account

Ask AI Assistant about Shell APIs and API Products