Get using Number

GET

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 associated member.

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

cardNumberstringRequired

Unique identifier for a card.

Headers

x-api-versiondateOptional

Used for API versioning. More details.

Response

This endpoint returns an object.

cardobject

This is a composite type representing a MemberCard along with the associated Member and Membership. It includes information about the member who holds the card and the membership the card is tied to.

GET

1 curl https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%20International%20Ltd./membership/card/number/MC1234567890

200ExampleGetCard

1 {
2   "card": {
3     "cardNumber": "MC1234567890",
4     "expiryDate": "2029-09-17",
5     "member": {
6       "blocked": false,
7       "memberId": 4331,
8       "memberNumber": "M123456789",
9       "address": "123 Main Street",
10       "birthday": "1980-01-01",
11       "city": "New York",
12       "country": "USA",
13       "email": "john.doe@acme.com",
14       "firstName": "John",
15       "gender": "male",
16       "lastName": "Doe",
17       "middleName": "A.",
18       "newsletter": true,
19       "phoneNo": "+1234567890",
20       "postCode": "12345"
21     },
22     "membership": {
23       "membershipId": "cdef7890-abcd-0123-1234-567890abcdef",
24       "membershipNumber": "MS-DEMO-00152",
25       "communityCode": "RIVERLAND",
26       "membershipCode": "GOLD",
27       "issueDate": "2024-09-17",
28       "blocked": false,
29       "validFromDate": "2024-09-17",
30       "validUntilDate": "2025-09-16",
31       "customerNumber": "D000188"
32     },
33     "temporary": false,
34     "cardId": 123434
35   }
36 }

Built with

1	{
2	"card": {
3	"cardNumber": "MC1234567890",
4	"expiryDate": "2029-09-17",
5	"member": {
6	"blocked": false,
7	"memberId": 4331,
8	"memberNumber": "M123456789",
9	"address": "123 Main Street",
10	"birthday": "1980-01-01",
11	"city": "New York",
12	"country": "USA",
13	"email": "john.doe@acme.com",
14	"firstName": "John",
15	"gender": "male",
16	"lastName": "Doe",
17	"middleName": "A.",
18	"newsletter": true,
19	"phoneNo": "+1234567890",
20	"postCode": "12345"
21	},
22	"membership": {
23	"membershipId": "cdef7890-abcd-0123-1234-567890abcdef",
24	"membershipNumber": "MS-DEMO-00152",
25	"communityCode": "RIVERLAND",
26	"membershipCode": "GOLD",
27	"issueDate": "2024-09-17",
28	"blocked": false,
29	"validFromDate": "2024-09-17",
30	"validUntilDate": "2025-09-16",
31	"customerNumber": "D000188"
32	},
33	"temporary": false,
34	"cardId": 123434
35	}
36	}