> This page is for API Reference. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.navipartner.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.navipartner.com/_mcp/server. # Get using Number GET https://api.npretail.app/{tenant}/{environment}/{company}/membership/card Retrieve details of a specific card using its card number. This endpoint allows access to card information when the card number is known, providing key details such as the card's status and cardId for further exploration. Reference: https://docs.navipartner.com/apis/api-reference/memberships/service-card/get-card-number ## Authentication - `x-np-api-key` header (required) — API Key authentication via header ## Request ### Path parameters - `tenant` (string, required) — Your Entra Tenant ID. [More details.](/paths#1-tenant) - `environment` (string, required) — Your Business Central Environment. [More details.](/paths#2-environment) - `company` (string, required) — Your Business Central Company. [More details.](/paths#3-company) ### Query parameters - `cardNumber` (string, required) — Unique identifier for a card. - `withDetails` (boolean, optional) — Set to true will include more detailed information in the response ## Response ### 200 - `card` (MemberCardEntity, required) — The MemberCardEntity describes the attributes of a card linked to a Member. It is used within other composite DTOs to represent the cards associated with a member or membership. ## Types ### MemberCardEntity The MemberCardEntity describes the attributes of a card linked to a Member. It is used within other composite DTOs to represent the cards associated with a member or membership. - `cardNumber` (string, required) — Unique identifier for a card. - `temporary` (boolean, required) — Indicates whether the card is temporary. - `createdAt` (datetime, required) — Date and time when the entity was created. - `modifiedAt` (datetime, required) — Date and time when the entity was updated. - `cardId` (UUID, optional) — Unique identifier for a card. - `expiryDate` (date, optional) — The expiry date of the card. - `blocked` (boolean, optional) — Indicates whether the entity is blocked. - `blockedAt` (datetime, optional) — Date and time when the entity was blocked. - `pinCode` (string, optional) — The PIN code associated with the card. ## Examples **Response** ```json { "card": { "cardNumber": "MC-XXXX-67891", "temporary": false, "createdAt": "2024-09-17T00:00:00", "modifiedAt": "2024-09-18T00:00:00", "cardId": "66666666-6666-6666-6666-666666666666", "expiryDate": "2029-09-17", "blocked": true, "blockedAt": "2024-09-20T00:00:00", "pinCode": "1234" } } ``` **SDK Code** ```python Get Card using Number import requests url = "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./membership/card" querystring = {"cardNumber":"MC1234567890"} headers = {"x-np-api-key": ""} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript Get Card using Number const url = 'https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./membership/card?cardNumber=MC1234567890'; const options = {method: 'GET', headers: {'x-np-api-key': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Get Card using Number package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./membership/card?cardNumber=MC1234567890" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("x-np-api-key", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Get Card using Number require 'uri' require 'net/http' url = URI("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./membership/card?cardNumber=MC1234567890") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["x-np-api-key"] = '' response = http.request(request) puts response.read_body ``` ```java Get Card using Number import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./membership/card?cardNumber=MC1234567890") .header("x-np-api-key", "") .asString(); ``` ```php Get Card using Number request('GET', 'https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./membership/card?cardNumber=MC1234567890', [ 'headers' => [ 'x-np-api-key' => '', ], ]); echo $response->getBody(); ``` ```csharp Get Card using Number using RestSharp; var client = new RestClient("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./membership/card?cardNumber=MC1234567890"); var request = new RestRequest(Method.GET); request.AddHeader("x-np-api-key", ""); IRestResponse response = client.Execute(request); ``` ```swift Get Card using Number import Foundation let headers = ["x-np-api-key": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./membership/card?cardNumber=MC1234567890")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```