POST /covermint

Create a new Patient Enrollment

Once authenticated, send a POST request to create a new patient enrollment.

Endpoint:

POST https://api-dev.tekrata.com/covermint

Headers:

Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

Request RequirementsCopied!

Required Fields

PatientDemographics(always required)
At least one of:
- MedicalInsurance
- RxInsurance

Optional: Include both insurance types if available.

Request Body Example:

 {
  "PatientDemographics": {
    "FirstName": "John",
    "LastName": "Doe",
    "DateOfBirth": "1980-01-01",
    "Gender": "Male",
    "AddressLine1": "123 Main St",
    "AddressLine2": "Apt 4B",
    "City": "New York",
    "State": "NY",
    "Zipcode": "10001",
    "Email": "john.doe@example.com",
    "PhoneNumber": "555-123-4567"
  },
  "MedicalInsurance": {
    "PayerName": "HealthCare Co",
    "PayerType": "Medical",
    "PlanBIN": "987654",
    "PlanPCN": "ABC123",
    "PlanGroup": "GRP123",
    "PlanID": "MC987654",
    "PlanStartDate": "2025-01-01",
    "PlanEndDate": "2025-12-31"
  },
  "RxInsurance": {
    "PayerName": "PharmaPlus",
    "PayerType": "Pharmacy",
    "PlanBIN": "654321",
    "PlanPCN": "XYZ789",
    "PlanGroup": "RXGRP",
    "PlanID": "RX654321",
    "PlanStartDate": "2025-01-01",
    "PlanEndDate": "2025-12-31"
  }
}

Required Fields: All three objects (PatientDemographics, MedicalInsurance, and RxInsurance) must be included.
Date Formats: Use YYYY-MM-DD for birth dates and date-time format for timestamps.
Authorization: Tokens expire after one hour — make sure to refresh as needed.

Response FormatCopied!

A successful enrollment response returns an object under the Response field.

The API will return a 200 OK with TransactionInfo, including enrollment status and coverage code.

Success (200 OK):

{
  "Response": {
    "TransactionInfo": {
      "TransactionId": "6018d983-59c5-4abe-bda5-a0dee47eae18",
      "TransactionCreatedDateTime": "2025-06-05T19:22:11.617500Z",
      "EnrollmentStatus": "Eligible",
      "InsurancePlan": "Commercial",
      "ResponseCode": "00",
      "ResponseMessage": "Member active for benefits"
    }
  }
}

Status Codes and Meaning

Code	Meaning	EnrollmentStatus
00	Member active for benefits	Success
01	Unable to determine member’s active benefits	Unknown
99	Member has government-provided insurance	Rejected

Notes

TransactionCreatedDateTime is in UTC ISO 8601 format.
TransactionId is a UUID string that can be logged for traceability.
Missing required fields will result in a 400 Bad Request.