> ## Documentation Index
> Fetch the complete documentation index at: https://devzone.nayax.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Card Data

export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
      text: "mint-text-green-700 dark:mint-text-green-400",
      border: "mint-border-green-300 dark:mint-border-green-700"
    },
    POST: {
      bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
      text: "mint-text-blue-700 dark:mint-text-blue-400"
    },
    PUT: {
      bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
      text: "mint-text-yellow-700 dark:mint-text-yellow-400"
    },
    PATCH: {
      bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
      text: "mint-text-orange-700 dark:mint-text-orange-400"
    },
    DELETE: {
      bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
      text: "mint-text-red-700 dark:mint-text-red-400"
    },
    API: {
      bg: "mint-bg-black",
      text: "mint-text-white"
    }
  };
  const MethodBadge = ({method}) => {
    const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
    return <span className={`
          method-pill rounded-lg font-bold px-1.5 py-0.5 text-xs leading-5 ${style.bg} ${style.text}`}>
        {method?.toUpperCase()}
      </span>;
  };
  const content = <div className="group flex items-center gap-4 border border-gray-200 dark:border-gray-700 rounded-xl p-5 bg-white dark:bg-[#1e1e1e] hover:border-gray-400 dark:hover:border-gray-500 hover:shadow-md transition-all cursor-pointer">
      {}
      <div className="flex-1 min-w-0">
        <p className="font-semibold text-gray-900 dark:text-white text-sm leading-snug">{title}</p>
        {children && <p className="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">{children}</p>}
      </div>

      {}
      <div className="shrink-0">
        <MethodBadge method={method} />
      </div>
    </div>;
  if (!href) return content;
  return <a href={href} className="block no-underline border-b-0 mb-2">
      {content}
    </a>;
};

The Lynx API provides several GET methods to retrieve detailed information about cards. These let you query card details, check credit balances, access revalue history, and more.

<Warning>
  **Authentication**

  Refer to the [Security & Token](/docs/manage-data-operations/lynx-api/security) page of this documentation to learn how to access your tokens, and how to use it to authenticate your API requests properly.
</Warning>

## Verifying card details in Nayax Core

To see the details of a card in Nayax Core, Access the **Card Management** tab and use the search bar to look for the card you want to check, and select it.

<Frame>
  <img src="https://mintcdn.com/nayax-44d6e37b/SZdrogZN6xHGu-sq/images/docs/retrieve-card-data/image1.png?fit=max&auto=format&n=SZdrogZN6xHGu-sq&q=85&s=c9c645bd1fbcbafe74a7f7f9775ce099" width="1440" height="824" data-path="images/docs/retrieve-card-data/image1.png" />
</Frame>

You will see all the details of the card presented to you, this is the same data retrieved by the Lynx API Endpoints mentioned before.

## Get cards

<EndpointCard title="Get Cards" href="/reference/lynx/cards/get-cards" method="get" />

This general endpoint will retrieve an overview of all cards, including essential details like Card ID, Card Holder Name, and Card Status. See the example query:

```sh Request theme={null}
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/cards \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'
```

This endpoint can also retrieve details of a specific card instead of all cards by adding query parameters to the request. For example, to get the details of a card with the Card Unique Identifier `1409315030` you can use the query in the code block below.

```sh Request theme={null}
curl --request GET \
     --url 'https://qa-lynx.nayax.com/operational/v1/cards?CardUniqueIdentifier=1409315030%20' \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'
```

Any of the following details of a card can be used as a query parameter:

* `CardID`
* `CardUniqueIdentifier`
* `CardDisplayNumber`
* `CardMobileNumber`
* `ExternalApplicationUserID`
* `CardEmail`
* `CardHolderName`

## Get card by the card's display number

<EndpointCard title="Get Card by the Card's Display Number" href="/reference/lynx/cards/get-card-by-the-cards-display-number" method="get" />

It fetches card details based on its display number, which is the physical card number. This is ideal for cases where only the display number is available for reference.

See the code block below for an example query:

```sh theme={null}
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/cards/displayNumber/{CardDisplayNumber} \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
     --header 'accept: application/json'
```

<Note>
  Replace `{CardDisplayNumber}` with the actual number of the card.
</Note>

## Get prepaid card

<EndpointCard title="Get Prepaid Card" href="/reference/lynx/cards/get-prepaid-card" method="get" />

It retrieves details of a prepaid card associated with a specific card ID. Use this to manage prepaid cards or verify their status and attributes.

See the code block below for an example query:

```sh Request theme={null}
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/cards/CardID/prepaid \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'

```

<Note>
  Replace `{CardID}` with the actual `CardID` of the card.
</Note>

The response will have the details of the requested card.

## Get the credit from a card

<EndpointCard title="Get the Credit from a Card" href="/reference/lynx/cards/get-the-credit-from-a-card" method="get" />

This option fetches the current credit balance for a specific card, identified by its unique identifier. Use it to monitor card balances, such as those of prepaid or technician cards.

See the code block below for an example query:

<CodeGroup>
  ```sh Request theme={null}
  curl --request GET \
       --url https://qa-lynx.nayax.com/operational/v1/cards/{CardUniqueIdentifier}/credit \
       --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
       --header 'accept: application/json'
  ```

  ```json Response theme={null}
  {
    "value": 5320
  }
  ```
</CodeGroup>

<Note>
  Replace `{CardUniqueIdentifier}` with the actual identifier of the card.
</Note>

The response will include the credit balance of the card.

## Get card's revalue

<EndpointCard title="Get Card's Revalue" href="/reference/lynx/cards/get-cards-revalue" method="get" />

Retrieves the revalue amount associated with a specific card, identified by the card's unique identifier. See the query example below:

```sh Request theme={null}
curl --request GET \
     --url https://qa-lynx.nayax.com/operational/v1/cards/{CardUniqueIdentifier}/revalue \
     --header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>' \
     --header 'accept: application/json'
```

<Note>
  Replace `{CardUniqueIdentifier}` with the actual identifier of the card.
</Note>

The response will include the revalue amount of the card.