Create Policy

curl -X POST https://app.usebridge.com/api/policies/v2 \
     -H "X-API-Key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "person": {
    "firstName": "firstName",
    "lastName": "lastName",
    "dateOfBirth": "2024-01-15T09:30:00Z"
  },
  "state": "AL",
  "payerId": "payerId"
}'

{
  "id": "id",
  "payerId": "payerId",
  "payer": {
    "id": "id",
    "code": "code",
    "name": "name",
    "memberId": true,
    "hint": "hint"
  },
  "status": "PENDING",
  "state": "AL",
  "_token": "_token",
  "planName": "planName",
  "person": {
    "firstName": "firstName",
    "lastName": "lastName",
    "middleName": "middleName",
    "dateOfBirth": "2024-01-15T09:30:00Z"
  },
  "errors": [
    {
      "code": "code",
      "message": "message"
    },
    {
      "code": "code",
      "message": "message"
    }
  ],
  "memberId": "memberId",
  "policyHolder": {
    "firstName": "firstName",
    "lastName": "lastName",
    "middleName": "middleName",
    "dateOfBirth": "2024-01-15T09:30:00Z"
  },
  "relationship": "SELF",
  "patientId": "patientId",
  "latest": {
    "id": "id",
    "plan": "plan",
    "validatedAt": "2024-01-15T09:30:00Z",
    "effectiveFrom": "2024-01-15T09:30:00Z",
    "effectiveTo": "2024-01-15T09:30:00Z"
  }
}

Creates a Policy, returning immediately with status of PENDING. Use the Get Policy API, or monitor webhooks, to receive updates.

Authentication

X-API-Keystring

API Key authentication via header

Request

This endpoint expects an object.

personobjectRequired

stateenumRequired

2 letter US state code

payerIdstringRequired

memberIdstringOptional

dateOfServicedatetimeOptional

Full ISO8601 timestamp, including timezone

Response

This endpoint returns an object.

idstring

payerIdstring

payerobject

statusenum

Allowed values:

stateenum

2 letter US state code

_tokenstring

Temporary access token to retrieve this Policy

planNamestring

personobject

errorslist of objects

memberIdstring

policyHolderobject

relationshipenum

Allowed values:

patientIdstring

latestobject