RLD CCD Medical API Interactive API documentation

Medical Card Lookup

Looks up a New Mexico medical cannabis card and calculates the patient's remaining 90-day medical-unit allowance.

Authentication requires a signed JWT in the Authorization: Bearer <token> header.

Medical

GET /v1/medical/{medicalCannabisCardId}/cardLookup Look up a medical cannabis card

The endpoint accepts GET and POST. The card ID is always supplied as a path parameter.

Parameters

NameInDescription
medicalCannabisCardId
required		 path
string		 Medical cannabis patient or caregiver card identifier.
Authorization
required		 header
Bearer JWT		 API authorization token.

Try it out

Request URL

—

Server response

— 

                

            

        

    


    

        
Response model

        
All application responses use the envelope { status, message, data }. On success, data contains:

        

            
Property
Type
Description

            
firstName, lastName
string | null
Patient name.

            
cardType
string
Patient or Caregiver.

            
expirationDate
date-time | null
Card expiration date.

            
submittedMedicalCannabisCardId
string
Card ID submitted in the request.

            
patientMedicalIdentifierId
string
Resolved patient medical identifier.

            
unitsLimit
number
Configured 90-day unit limit.

            
unitsUsedLast90Days
number
Units used during the previous 90 days.

            
unitsRemaining
number
Units still available.

            
applicationId, customerId, dob
mixed
DOH patient identifiers and date of birth.

            
caregiver
object | null
Caregiver details when the submitted card belongs to a caregiver.

            
rawDOHResponse
object
Unmodified patient data returned by the DOH service.