# Release Notes November 2024
source: https://developer.mastercard.com/mdes-customer-service/documentation/release-history/release-notes-nov2024/index.md

## Release Change Summary {#release-change-summary}

MDES Customer Service API has been enhanced as part of the November 2024 platform release.

Search Requests containing Account Number (FPAN), Payment App Instance ID (PAID), Virtual Card Number (VCN) or Financial Account ID (FAID) can support token information to be retrieved in smaller, more manageable batches (or pages) enhancing the efficiency and performance of data retrieval.

## Dates for Introduction of Functionality {#dates-for-introduction-of-functionality}

* MTF - 30 October 2024
* Production - 11 November 2024

## Release Details {#release-details}

MDES Customer Service API now supports API pagination allowing token information to be retrieved in batches (or pages).

Search Requests containing Account Number (FPAN), Payment App Instance ID (PAID), Virtual Card Number (VCN) or Financial Account ID (FAID) can optionally include a new object called PageInfo which includes two new fields

* Offset - indicating the starting index of the results to be returned
* Limit - indicating the maximum number of token records to include on each page

In this example, including the PageInfo object in the Search request with an Offset value of "0" indicates that the first page is to be returned and will contain no more than 10 token records.

If pagination is requested in the Search request, the response will contain a PageInfo object that indicates the following:

* Offset - indicating the index (page) of the results returned
* Limit - indicating the maximum number of token records on each page
* Count - indicating the count of token records on the page
* Total - indicating the total number of tokens for the given search parameter (e.g. FPAN or PAID)

Note: If there is a total of 20 token records for the given search parameter and the limit is set at 10 token records per page, the first 10 records would be obtained using an Offset of "0" and the second page using an Offset of "1"
API Reference: `GET /{id}/search`

### Existing Implementations {#existing-implementations}

In both Production and MTF environments, Search API responses will automatically be paginated when Offset and Limit is supplied in Search API requests that contain Account Number (FPAN), Payment App Instance ID (PAID), Virtual Card Number (VCN) or Financial Account ID (FAID) as a search parameter.

### New Implementations {#new-implementations}

It is recommended pagination is used for all search requests using Account Number (FPAN), Payment App Instance ID (PAID), Virtual Card Number (VCN) or Financial Account ID (FAID) as a search parameter.

### Personal data \& Privacy Note {#personal-data--privacy-note}

Issuers are reminded that the information presented via the MDES Customer Service API includes personal data which is subject to data privacy laws. Issuers must satisfy themselves that the processing of such personal data is compliant with applicable privacy laws.